NCPHELP.HLB  —  LOOP
 Use the LOOP CIRCUIT, LOOP EXECUTOR, LOOP LINE, and LOOP NODE
 commands to test specified components in the network.  Each
 command causes test blocks of data to be transmitted over the
 specified components.  The parameters can be entered in any order
 and are optional, except in the case of broadcast circuit loopback
 tests which require a parameter to define the loopback destination.

 LOOP    CIRCUIT circuit-id    (parameters ...)
         EXECUTOR
         LINE    line-id
         NODE    node-id

1  –  CIRCUIT

 Use the LOOP CIRCUIT command to test a specified circuit in the
 network.  This command does not apply to X25 circuits.  The
 parameters are optional and can be entered in any order.

 LOOP   CIRCUIT circuit-id   ASSISTANT PHYSICAL ADDRESS address
                             ASSISTANT NODE node-id
                             COUNT number
                             HELP help-type
                             LENGTH number
                             NODE node-id
                             PHYSICAL ADDRESS address
                             WITH
                               MIXED
                               ONES
                               ZEROES

 All underscores found in parameters must be replaced with spaces
 when parameters are used in NCP commands.

1.1  –  ASSISTANT

1.1.1  –  PHYSICAL ADDRESS address

 Applies only to broadcast circuits.  Identifies the physical
 address of the node that will perform the role of loopback
 assistant for third-party loop testing.  This parameter must be
 specified if HELP is included in this command. The address cannot
 be a multicast address.  This parameter can be used instead of
 the ASSISTANT NODE parameter.

1.1.2  –  NODE node-id

 Applies only to broadcast circuits.  Identifies the name of the
 node or the address of the node that will perform the role of
 loopback assistant for broadcast third-party loop testing.  This
 parameter can be used instead of the ASSISTANT PHYSICAL ADDRESS
 parameter.

1.2  –  COUNT number

 Specifies the number of blocks to be sent during loopback
 testing over the circuit.  The count must be a decimal
 integer in the range of 1 through 65535. If the parameter is
 omitted, only one block is looped.

1.3  –  HELP help-type

 Applies only to broadcast circuits.  Indicates the amount of
 assistance to be provided during broadcast loopback testing by
 the assistant node, whose address is specified in the ASSISTANT
 PHYSICAL ADDRESS or node-id as specified in the ASSISTANT NODE
 parameter.  There are three possible values of help-type:

   TRANSMIT   The assistant node relays the request to the
              destination node, which replies directly to the
              executor node.

   RECEIVE    The executor node sends the request directly to the
              destination node, which relays the reply to the
              assistant node for transmission to the executor node.

   FULL       The assistant node relays the request and the reply
              between the executor node and the destination node.

 If HELP is specified, ASSISTANT PHYSICAL ADDRESS or ASSISTANT
 NODE must also be specified.

1.4  –  LENGTH number

 Specifies the length (in bytes) of the blocks to be sent
 during loopback testing.  The length must be a decimal
 integer in the range of 1 through 4096.  Note that the
 LENGTH parameter must be less than 50 for the DMC-11 circuit
 operating in either controller loopback mode or cable
 loopback mode (a DMC-11 with an attached loopback cable).
 If the parameter is omitted, a block length of 4096 bytes is used.

1.5  –  NODE node-id

 Applies only to broadcast circuits. Identifies the destination node
 to be used for loopback testing of the specified broadcast circuit.
 Can be used instead of the PHYSICAL ADDRESS parameter.

1.6  –  PHYSICAL ADDRESS address

 Applies only to broadcast circuits.  Identifies the physical
 address of the destination node to be used for loopback testing of
 the specified broadcast circuit.

1.7  –  WITH data-type

 Specifies the type of binary information to be sent during
 testing. Three types of data can be sent:

                 MIXED
                 ONES
                 ZEROS

 If omitted, a combination of ones and zeros (MIXED) is sent.

1.8  –  Examples

      NCP>LOOP CIRCUIT DMC-0 COUNT 5 LENGTH 20

          This command initiates a circuit-level loopback test over circuit
          DMC-0.  The software loops five messages, 20 bytes in length with
          mixed binary information.

      NCP>LOOP CIRCUIT UNA-0 NODE 224

          This command initiate an Ethernet circuit-level loopback test
          with a node whose address is 224.  In this example, the NODE
          parameter with a node-id of 224 was used in place of the
          PHYSICAL ADDRESS parameter.

2  –  EXECUTOR

 Use the LOOP EXECUTOR command to test the executor node in the
 network.  The parameters are optional and can be entered in any
 order.  You can supply explicit access control information for
 the LOOP EXECUTOR command.  This command does not apply to VAX
 PSI.

 LOOP    EXECUTOR      ACCOUNT account
                       COUNT number
                       LENGTH number
                       PASSWORD password
                       USER user-id
                       WITH
                         MIXED
                         ONES
                         ZEROS

2.1  –  ACCOUNT

 Identifies the user's account for access control verification
 for the executor node.

2.2  –  COUNT

 Specifies the number of blocks to be sent during loopback
 testing over the executor node. The count must be a decimal
 integer in the range of 1 through 65535. If the parameter is
 omitted, only one block is looped.

2.3  –  LENGTH

 Specifies the length (in bytes) of the blocks to be sent
 during loopback testing. The length must be a decimal
 integer in the range of 1 through 4096. If the parameter is
 omitted, a block length of 4096 bytes is used.

2.4  –  PASSWORD

 Identifies the user's password for access control verification
 for the executor node.

2.5  –  USER

 Specifies the user's identification for access control
 verification for the executor node.

2.6  –  WITH

 Specifies the type of binary information to be sent during
 testing. Three types of data can be sent:

                 MIXED
                 ONES
                 ZEROS

 If omitted, a combination of ones and zeros (MIXED) is sent.

2.7  –  Example

      NCP>LOOP EXECUTOR

          This command initiates a loopback test on the executor node.

3  –  LINE

 Use the LOOP LINE command to initiate loopback testing of X25 lines
 only.  The parameters are optional and can be entered in any order.
 Before beginning loopback testing of an X25 line, use the SET LINE
 command to set the STATE SERVICE and CONTROLLER LOOPBACK parameters
 for internal loopback testing or the STATE SERVICE and CONTROLLER
 NORMAL for all other loopback testing.

 LOOP    LINE line-id        COUNT number
                             LENGTH number
                             WITH
                               MIXED
                               ONES
                               ZEROS

3.1  –  COUNT

 Specifies the number of blocks to be sent during loopback
 testing over the line. The count must be a decimal
 integer in the range of 1 through 65535. If the parameter is
 omitted, only one block is looped.

3.2  –  LENGTH

 Specifies the length (in bytes) of the blocks to be sent
 during loopback testing. The length must be a decimal
 integer in the range of 1 through 65535. If the parameter is
 omitted, a block length of 40 bytes is used.

3.3  –  WITH

 Specifies the type of binary information to be sent during
 testing. Three types of data can be sent:

                 MIXED
                 ONES
                 ZEROS

 If omitted, a combination of ones and zeros (MIXED) is sent.

3.4  –  Examples

      NCP>LOOP LINE DUP-0

          This command initiates a line-level loopback test over
          X25 line DUP-0.  The software loops one message, 4096 bytes
          in length, with mixed binary information.

      NCP>LOOP LINE DUP-1 COUNT 10 WITH ONES

          This command initiates a line-level loopback test over
          X25 line DUP-1.  The software loops 10 messages, 4096 bytes
          in length, with all binary ones information.

4  –  NODE

 Use the LOOP NODE command to test a specified node (other than the
 executor node) in the network.  The parameters are optional and can
 be entered in any order.  You can supply explicit access control
 information for the LOOP NODE command.

 To test the executor, use the LOOP EXECUTOR command.

 LOOP    NODE  node-id      ACCOUNT account
                            COUNT number
                            LENGTH number
                            PASSWORD password
                            USER user-id
                            WITH
                              MIXED
                              ONES
                              ZEROS

4.1  –  ACCOUNT

 Identifies the user's account for access control verification
 for the designated node.

4.2  –  COUNT

 Specifies the number of blocks to be sent during loopback
 testing over the node. The count must be a decimal integer in
 the range of 1 through 65535. If the parameter is omitted,
 only one block is looped.

4.3  –  LENGTH

 Specifies the length (in bytes) of the blocks to be sent
 during loopback testing. The length must be a decimal
 integer in the range of 1 through 4096. If the parameter is
 omitted, a block length of 4096 bytes is used.

4.4  –  PASSWORD

 Identifies the user's password for access control verification
 for the designated node.

4.5  –  USER

 Specifies the user's identification for access control
 verification for the designated node.

4.6  –  WITH

 Specifies the type of binary information to be sent during
 testing. Three types of data can be sent:

                 MIXED
                 ONES
                 ZEROS

 If omitted, a combination of ones and zeros (MIXED) is sent.

4.7  –  Example

      NCP>SET NODE TESTER CIRCUIT DMC-0
      NCP>LOOP NODE TESTER
         .
         .
         .
      NCP>CLEAR NODE TESTER CIRCUIT

          The first command creates a loop node name (TESTER) for
          the associated circuit, the second command initiates a
          node-level loopback test with the loop node name, and the
          third command removes the loop node name from the volatile
          database when the loopback is completed.
Close Help