Library /sys$common/syshlp/NCPHELP.HLB  —  SET  CIRCUIT
 Use the SET CIRCUIT command to create or modify circuit parameters
 in the volatile database.  Use the DEFINE CIRCUIT command to
 create or modify permanent circuit parameters.

 SET     KNOWN CIRCUITS       (parameters ...)
         CIRCUIT circuit-id

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

1  –  KNOWN CIRCUITS

 Indicates that the specified parameters for all known circuits
 are to be created or modified in the database.

2  –  CIRCUIT circuit-id

 Identifies the circuit for which specified parameters are to be
 created or modified in the database.

3  –  ALL

 Use the SET CIRCUIT ALL command to update the volatile copy of  the
 database  on  the  executor  node  with  all the circuit parameters
 stored for a particular circuit in the permanent database on the
 executor  node.

4  –  ACTIVE

 Differentiates between the active, inactive and dying DDCMP timer
 parameters

4.1  –  BASE

 Applies to DDCMP CONTROL circuits. This value sets the base
 priority of an ACTIVE tributary after the tributary has been
 polled.  You can set a separate base for each of the indicated
 polling states.  base must be a decimal integer from 0 to 255.
 If not specifically set, the ACTIVE BASE default is 255.

4.2  –  INCREMENT

 Applies to DDCMP CONTROL circuits. This parameter sets the
 increment value added to the ACTIVE tributary priority each time
 the scheduling timer expires. Increment must be a decimal integer
 from 0 to 255.  If not specifically set, the ACTIVE INCREMENT
 default is 0.

5  –  BABBLE TIMER

 Applies to DDCMP CONTROL circuits.  It represents the number of
 milliseconds that a selected tributary or remote half-duplex
 station is allowed to transmit.  Milliseconds must be a decimal
 integer in the range 1 to 65535.  The default is 6000 (6
 seconds).

6  –  CHANNEL number

 Applies only to X25 PVCs.  Identifies the logical channel number for
 the X25 PVCs.  Specify a value in the range 0 to 4095.  This
 parameter is mandatory when you specify an X25 PVC for the first
 time.

7  –  COUNTER TIMER

 Specifies the number of seconds that the Network Management
 counter timer will run.  When the counter timer expires, a
 circuit counter logging event occurs.  Seconds must be a decimal
 integer in the range 0 to 65535.

8  –  COST

 Specifies the transport routing cost of the circuit. Cost must be
 a decimal integer in the range 1 to 63.  Messages will travel
 between nodes along the path with the smallest total cost.

9  –  DEAD THRESHOLD

 Applies to DDCMP CONTROL circuits.  It defines the number of
 times to poll the active, inactive or dying tributary before
 changing that tributary's polling state to dead because of
 receive timeouts.  Count must be a decimal integer in the range 0
 to 255. The default count is 8.

10  –  DTE dte-address

 Applies only to X25 PVCs and DLM circuits. It identifies the local
 DTE for the circuit. Specify a decimal integer of 1 to 15 digits.

 This parameter is optional for DLM circuits and mandatory when you
 specify an X25 PVC for the first time.

11  –  DYING

 Differentiates between the active, inactive and dying DDCMP timer
 parameters

11.1  –  BASE

 Applies to DDCMP CONTROL circuits. This value sets the base
 priority of an Dying tributary after the tributary has been
 polled.  You can set a separate base for each of the indicated
 polling states.  Base must be a decimal integer from 0 to 255.
 If not specifically set, the DYING BASE default is 0.

11.2  –  INCREMENT

 Applies to DDCMP CONTROL circuits. This parameter sets the
 increment value added to the DYING tributary priority each time
 the scheduling timer expires. Increment must be a decimal integer
 from 0 to 255.  If not specifically set, the DYING INCREMENT
 default is 16.

11.3  –  THRESHOLD

 Applies to DDCMP CONTROL circuits.  It specifies the number of
 times to poll the active or inactive tributary before changing
 that tributary's polling state to dying because of receive
 timeouts.  Count must be a decimal integer in the range 0 to 255.
 The default count is 2.

12  –  HELLO TIMER

 Specifies the frequency of Transport Hello messages sent to
 adjacent nodes on the circuit.  Seconds must be a decimal integer
 in the range 0 to 65535.

13  –  INACTIVE

 Differentiates between the active, inactive and dying DDCMP timer
 parameters

13.1  –  BASE

 Applies to DDCMP CONTROL circuits. This value sets the base
 priority of an INACTIVE tributary after the tributary has been
 polled.  You can set a separate base for each of the indicated
 polling states.  Base must be a decimal integer from 0 to 255.
 If not specifically set, the default is 0.

13.2  –  INCREMENT

 Applies to DDCMP CONTROL circuits. This parameter sets the
 increment value added to the INACTIVE tributary priority each
 time the scheduling timer expires. Increment must be a decimal
 integer from 0 to 255.  If not specifically set, the default is 64.

13.3  –  THRESHOLD

 Applies to DDCMP CONTROL circuits.  It specifies the number of
 times to poll the active tributary before changing that
 tributary's polling state to inactive because of no data
 response.  Count must be a decimal integer in the range 0 to 255.
 The default count is 8.

14  –  MAXIMUM

14.1  –  BUFFERS

 Applies to DDCMP CONTROL circuits.  It specifies the maximum
 number of buffers from a common buffer pool that the tributary
 can use.  If you do not set this parameter, there is no common
 buffer pool and the higher level will explicitly supply the
 buffers.  Count must be a decimal integer in the range 1 to 254
 or the keyword, UNLIMITED.

14.2  –  DATA count

 Applies only to X25 PVCs and DLM circuits. Specifies the maximum
 packet size for the X25 circuit. This value must be at least five
 bytes less than the MAXIMUM BLOCK value that you specify in the SET or
 DEFINE LINE command, and must be a power of two. Specify a value in
 the range 16 to 4096 bytes.

 By default, packet size takes the value specified by the PROFILE
 parameter of the SET or DEFINE MODULE X25-PROTOCOL command.

14.3  –  RECALLS count

 Applies only to X25 DLM Switched Virtual Circuits (SVCs). Specifies
 the maximum number of call retries generated automatically on an
 outgoing DLM circuit.

14.4  –  ROUTERS

 Applies only to broadcast circuits.  It specifies the maximum number
 of routers (other than the executor itself) allowed on the circuit by
 Routing for circuits that are owned by the executor node.  The value
 must be a decimal integer in the range 0 to 33.

14.5  –  TRANSMITS

 Applies to DDCMP CONTROL circuits.  It specifies the maximum
 number of data messages that can be transmitted at one time.
 Count must be a decimal integer in the range 1 to 255.  The
 default count is 4.

14.6  –  WINDOW count

 Applies only to X25 PVCs and X25 DLM circuits. Specifies the maximum
 window size allowed for the X25 circuit - that is, the maximum number
 of packets for which outstanding acknowledgments are allowed. Specify
 a value in the range 1 to 127.

 By default window size takes the value specified by the PROFILE
 parameter of the SET or DEFINE MODULE X25-PROTOCOL command.

15  –  NETWORK network-name

 Applies only to X25 PVCs and X25 DLM circuits. Specifies the network
 that the circuit runs through. If only one network is set up, this
 parameter is not required. Otherwise, the parameter is mandatory.

16  –  NUMBER dte-address

 Applies only to X25 DLM Switched Virtual Circuits (SVCs). For
 outgoing circuits, specifies the remote DTE address and subaddress
 that this DLM circuit will call. For incoming circuits, specifies the
 address of the remote DTE from which this circuit will accept calls.

 If the NUMBER parameter is not specified for an incoming circuit, a
 call from any remote DTE can be directed to this circuit. Specify a
 decimal integer of 1 to 15 digits.

17  –  OWNER EXECUTOR

 Applies only to X25 DLM circuits.  Identifies the circuit owner as
 the Routing Layer.  This parameter is mandatory for an X25 DLM
 circuit.

18  –  POLLING STATE

 Identifies the multipoint polling state of the tributary.  The
 default is AUTOMATIC.  There are five possible states:

     AUTOMATIC	The tributary's state varies according to the
 		operation of the polling algorithm.

     ACTIVE	The tributary is locked in the ACTIVE state.

     INACTIVE	The tributary is locked in the INACTIVE state.

     DYING	The tributary is locked in the DYING state.

     DEAD	The tributary is locked in the DEAD state.

19  –  RECALL TIMER

 Applies only to X25 DLM circuits.  Sets a timer whose expiration
 causes a remote DTE to be called again during an attempt to set up a
 DLM circuit.  Specify a decimal integer in the range 1 to 65535.

20  –  ROUTER PRIORITY

 Applies only to broadcast circuits.  Specifies the priority this router
 (the executor node on this circuit) is to have in the selection of
 designated router for this circuit.  Use a value in the range 0 to 127.
 The default value is 64.

21  –  SERVICE

 Specifies whether or not service operations (loading and loop
 testing) are allowed for the circuit.  There are two possible
 modes:

     DISABLED	The circuit may not be put into
 		service state and may not
 		perform service functions.

     ENABLED	The circuit may be put into
 		service state and perform
 		service functions.

22  –  STATE

 Specifies the circuit's operational state. There are three
 possible states:

     OFF		The circuit is not in use.

     ON		The circuit is available for
 		normal use or service functions.

     SERVICE	The line is available for
 		service functions only.

23  –  TRANSMIT TIMER

 Defines the number of milliseconds to delay between data message
 transmits.  Milliseconds must be a decimal integer in the range 0
 to 65535.  The default is 0.

24  –  TRIBUTARY

 Defines the Data Link physical tributary address of the circuit.
 Trib-address must be a decimal integer in the range 0 to 255.

25  –  TYPE X25

 Applies only to X25 circuits.  Specifies  the type  of circuit.  For
 circuit names starting with "X25-", TYPE is always X25.

26  –  USAGE

 Applies only to X25 circuits.  Defines the usage type of an X25
 virtual circuit.  The possible values are:

     INCOMING        Applies only to X25 DLM SVCs.
                     The  circuit  is used only for
                     incoming calls.

     OUTGOING        Applies only to X25 DLM SVCs.
                     The  circuit  is used only for
                     outgoing calls.

     PERMANENT       This  parameter  is  mandatory
                     for X25 PVCs.  The circuit is
                     permanently connected to a remote
                     DTE, and does not need to be
                     switched dynamically.

27  –  VERIFICATION

 Applies only to synchronous and asynchronous circuits. Requires the
 remote node to send its routing initialization password.
 There are three options:

             DISABLED	does not require the remote node to send its routing
                         initialization password.  This is the default.

             ENABLED	Requires the remote node to send its routing initialization
                         password.

             INBOUND     Applies to any DDCMP point-to-point circuit.  Specifies
                         that the executor node expects to receive a routing
                         initialization password for verification from a remote
                         node before a connection is made between the nodes.
                         The executor is prohibited from sending its routing
                         initialization password to the remote node.  This
                         parameter is specified automatically for dynamic
                         asynchronous DDCMP circuits.  If VERIFICATION
                         INBOUND is specified for a circuit, the INBOUND
                         parameter must be set for the remote node.

28  –  Examples

      NCP>SET CIRCUIT DMC-0 COST 3 STATE ON

          This command sets up the first DMC-11 for normal use.

      NCP>SET CIRCUIT DMC-0 STATE OFF
      NCP>SET CIRCUIT DMC-0 COST 1 STATE ON

          These two commands change the relative cost of the
          first DMC-11.
Close Help