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.