Use the SET command to create or modify parameters or components in the volatile database on the executor node. Use the DEFINE command to create or modify parameters or components in the permanent database on the executor node.
1 – 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.1 – KNOWN CIRCUITS
Indicates that the specified parameters for all known circuits are to be created or modified in the database.
1.2 – CIRCUIT circuit-id
Identifies the circuit for which specified parameters are to be created or modified in the database.
1.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.
1.4 – ACTIVE
Differentiates between the active, inactive and dying DDCMP timer parameters
1.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.
1.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.
1.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).
1.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.
1.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.
1.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.
1.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.
1.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.
1.11 – DYING
Differentiates between the active, inactive and dying DDCMP timer parameters
1.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.
1.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.
1.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.
1.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.
1.13 – INACTIVE
Differentiates between the active, inactive and dying DDCMP timer parameters
1.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.
1.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.
1.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.
1.14 – MAXIMUM
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.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.
1.25 – TYPE X25
Applies only to X25 circuits. Specifies the type of circuit. For circuit names starting with "X25-", TYPE is always X25.
1.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.
1.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.
1.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.
2 – EXECUTOR
Use the SET EXECUTOR command to create or modify parameters in the volatile database which controls the network on the executor node. Use the DEFINE EXECUTOR command to create or modify parameters in the volatile database which controls the network on the executor node. SET EXECUTOR (parameters ...) All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
2.1 – ALL
Use the SET EXECUTOR ALL command to update the volatile copy of the executor node's database with all the local node parameters stored for that node in its permanent database. SET EXECUTOR ALL
2.2 – ADDRESS
Establishes a node address for the local node, in the form
area-number.node-number
where the area-number is in the range 1 to 63 and the node number
is in the range 1 to 1023. If the area-number is not specified,
a default value of 1 is assumed. You need not supply the area
number in the node-address if your node is in area 1. This parameter
is required when you configure the local node.
2.3 – ALIAS
2.3.1 – INCOMING
Specifies whether the local node is willing to accept incoming
requests directed to the alias node identifier specified for
the local node. The alias node identifier is described under the
ALIAS NODE parameter. There are two options for ALIAS INCOMING:
ENABLED Specifies that the local node will accept
incoming connect requests directed to the alias
node identifier. This is the default if an
alias node identifier has been specified.
DISABLED Specifies that the local node will not
accept the incoming connect requests
directed to the alias node identifier.
2.3.2 – MAXIMUM LINKS
Specifies the maximum number of logical links for the local node that can use the alias node identifier. The alias node identifier is described under the ALIAS NODE parameter. The maximum value for ALIAS MAXIMUM LINKS is 200. The default value is 32.
2.3.3 – NODE
Establishes a cluster alias node identifier for use by the local node. The node-id is a DECnet node identifier that can be either a node-name or a node-address. This alias permits the local node to be associated with a cluster node identifier common to some or all the nodes in a cluster, in addition to its own unique node-id. If this parameter is not specified, the local node is not associated with a cluster alias node identifier. If a node-name is to be used as the alias node-id, the node-name must previously have been defined in the database.
2.4 – AREA
2.4.1 – MAXIMUM
2.4.1.1 – COST
Applies only to an executor node whose type is AREA. Specifies the maximum total path cost allowed from the executor to any other level 2 routing node. You can specify a decimal value in the range 1 to 1022. The default value is 1022.
2.4.1.2 – HOPS
Applies only to an executor node whose type is AREA. Specifies the maximum number of routing hops allowable from the executor to any other level 2 routing node. You can specify a decimal value in the range 1 to 30. The default is 30.
2.5 – BROADCAST ROUTING TIMER
Specifies the maximum amount of time allowed between Routing updates on broadcast circuits. When the timer expires before a routing update occurs, a routing update is forced. The routing update produces a routing configuration message for each adjacent node. Routing uses this timer to enforce a minimum delay between routing updates. You can specify a number in the range 1 to 65,535. The default value is 40.
2.6 – BUFFER SIZE
Specifies the size of the line buffers and thereby controls the maximum segment size, including the transport header, of all NSP messages received.
2.7 – COUNTER TIMER
Specifies a timer whose expiration causes a line counter logging event.
2.8 – DEFAULT ACCESS
Assigns the default access to all nodes which do not have a
specific node ACCESS entry in the volatile data base. There are
four options:
INCOMING Allows logical link connections from the remote node.
OUTGOING Allows the local node to initiate connections to the
remote node; but does not allow connections from the
remote node.
BOTH Allows incoming and outgoing logical link connections.
This is the default.
NONE Does not allow incoming or outgoing logical link
connections to this node.
2.9 – DELAY
2.9.1 – FACTOR
Specifies the number by which to multiply one sixteenth of the estimated round trip delay to a node to set the retransmission timer to that node. Use a number in the range 16 to 255. The default value is 80.
2.9.2 – WEIGHT
Specifies the weight to apply to a new round trip delay data point when updating the estimated round trip delay to a node. Use a number in the range of 1 to 255. The default value is 5.
2.10 – IDENTIFICATION
Is a text string that describes the executor node (that is, "Host System"). The string can be a maximum of 32 characters. If it contains blanks or tabs, you must enclose the string in quotation marks.
2.11 – INACTIVITY TIMER
Specifies the maximum duration of inactivity (no data in either direction) on a logical link before the node checks to see if the logical link still works. If you do not set this parameter, NETACP will supply a default value. It is recommended that you allow NETACP to supply the default.
2.12 – INCOMING
2.12.1 – PROXY
Indicates whether proxy login requests present on incoming logical
links are to honored. There are two options for INCOMING PROXY:
DISABLED: Ignores all incoming proxy requests and
instead relies exclusively on access control
information supplied in the connect requests
to validate the logical link.
ENABLED: Invokes the appropriate proxy, based on
the source user, source node, and supplied
access control information (if any).
2.12.2 – TIMER
Defines the maximum duration between the time a connection is received for a process and the time that process accepts or rejects the connection. For very busy systems, use a value in the range of 45 to 60 seconds. Otherwise use a value of 30 seconds.
2.13 – MAXIMUM
2.13.1 – ADDRESS
Defines the largest node address and, consequently, the greatest number of nodes that can be addressed by the local node. Use as small a number as possible. If you receive an "INVALID VALUE" error, you probably have not allocated enough nonpaged pool space. You must lower the MAXIMUM ADDRESS value or increase the VMS NPAGEDYN value. See Chapter 5 of the Guide to Networking for some guidelines on NPAGEDYN.
2.13.2 – AREA
Applies only to an executor node whose type is AREA. Specifies the largest area number and, therefore, the greatest number of areas that can be known about by the executor node's Routing layer. You can specify a decimal value in the range 1 to 63. The default is 63.
2.13.3 – BROADCAST
2.13.3.1 – NONROUTERS
Specifies the maximum total number of nonrouting nodes (end nodes) the executor node can have on its broadcast circuits. Use a number in the range of 0 to 1023. The default is 64.
2.13.3.2 – ROUTERS
Specifies the maximum total number of routing nodes the executor node can have on its broadcast circuits. Use a number in the range of 0 to 65,535. The default is 32.
2.13.4 – BUFFERS
Specifies the total number of buffers in the transmit buffer pool. The value must be larger than that for the MAXIMUM CIRCUITS parameter. Use a value that is 15 times the square root of the number of lines. Increase this value if you experience congestion loss.
2.13.5 – CIRCUITS
Defines the maximum number of transport circuits that the local node can use. Number must be in the range 1 to 32. If you receive an "INVALID VALUE" error, you probably have not allocated enough Non Paged Pool space. You must lower the MAXIMUM CIRCUITS value or increase the VMS NPAGEDYN value. See Chapter 5 of the Guide to Networking for some guidelines on NPAGEDYN.
2.13.6 – COST
Specifies the maximum total path cost allowed from the local node to any node. The path cost is the sum of the line costs along a path between two nodes. Use as small a number as possible in the range of 1 to 1023.
2.13.7 – DECLARED OBJECTS
Specifies the maximum number of objects that processes may declare. Use a number in the range of 8 to 16383. The default is 31.
2.13.8 – HOPS
Specifies the maximum routing hops from the local node to any other reachable node. A hop is the logical distance over a line between two adjacent nodes. Use as small a number as possible in the range of 1 to 31, and be sure that this value is less than or equal to the MAXIMUM VISITS parameter. If you receive an "INVALID VALUE" error, you probably have not allocated enough Non Paged Pool space. You must lower the MAXIMUM HOPS value or increase the VMS NPAGEDYN value. Refer to Chapter 5 of the Guide to Networking on for some guidelines on NPAGEDYN.
2.13.9 – LINKS
Specifies the maximum logical link count for the local node. A reasonable range for most networks is 25 to 50.
2.13.10 – PATH SPLITS
Indicates the maximum number of equal cost paths for a given destination node among which the packet load may be split. The default is 4.
2.13.11 – VISITS
Specifies the maximum number of nodes a message can visit prior to being received by the destination node. Use a number in the range of 1 to 255. The value must be greater than or equal to the value for the MAXIMUM HOPS parameter. It is suggested that you specify a number that is twice the MAXIMUM HOPS value.
2.14 – NAME
Specifies the node name to be assigned with the executor node identification. Only one name can be assigned to a node address or node identification.
2.15 – NONPRIVILEGED
Specifies nonprivileged inbound access control information for the node. The following items can be specified: All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
2.15.1 – ACCOUNT account
Identifies the user's account for access control verification for the designated node.
2.15.2 – PASSWORD password
Identifies the user's password for access control verification for the designated node.
2.15.3 – USER user-id
Identifies the user's ID for access control verification for the designated node.
2.16 – OUTGOING
2.16.1 – PROXY
Indicates whether proxy login may be used on outgoing connect requests.
There are two options for OUTGOING PROXY:
DISABLED: Specifies that proxy invocation is not requested
on any outgoing logical links.
ENABLED: Specifies that proxy invocation is requested on
all outgoing logical links.
2.16.2 – TIMER
Specifies a time out value for the duration between the time a connection is requested and the time that connection is acknowledged by the destination node. It is recommended that you use a value in the range of 30 to 60 seconds.
2.17 – PATH SPLIT POLICY
Specifies the policy for equal cost load splitting of network traffic.
There are two values for PATH SPLIT POLICY
INTERIM: Specifies that all traffic will be split
over all equal cost paths while forcing
individual network sessions over the same
paths in order to guarantee that packets
will be received by the destination node
in the correct order. The INTERIM value
should be set if some of the nodes in the
network do not support out-of-order packet
caching. (VMS version 4.5 and earlier VMS
releases do not support out-of-order
caching).
NORMAL: Specifies that all traffic will be split
equally over all equal cost paths to a
destination node. All nodes must support
out-of-order packet caching
(VMS Version 4.6 or later), otherwise,
network performance may suffer. This is
the default value for PATH SPLIT POLICY.
2.18 – PIPELINE QUOTA
Specifies the maximum number of bytes of nonpaged pool that DECnet will use for transmission over logical links. Use this parameter for multibuffering at the NSP level.
2.19 – PRIVILEGED
Specifies privileged inbound access control information for the node. This parameter is not needed unless the PRIVILEGES parameter is used explicitly in the object database. All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
2.19.1 – ACCOUNT account
Identifies the user's account for access control verification for the designated node.
2.19.2 – PASSWORD password
Identifies the user's password for access control verification for the designated node.
2.19.3 – USER user-id
Identifies the user's ID for access control verification for the designated node.
2.20 – RETRANSMIT FACTOR
Defines the maximum number of times any given message (except a connect initiate message) will be retransmitted before the logical link is disconnected. If you do not set this parameter, NETACP will supply a default value. It is recommended that you allow NETACP to supply the default.
2.21 – ROUTING TIMER
Specifies the maximum duration before a routing update is forced. The routing update produces a routing configuration message for each adjacent node. You can use a number in the range of 1 to 65535. If you don't set this parameter, NETACP will supply a default value. It is recommended that you allow NETACP to supply the default.
2.22 – SEGMENT BUFFER SIZE
Specifies in bytes the maximum number of transmit buffers, thereby controlling the maximum size NSP message segment that can be transmitted. (This value is the maximum size message the End Communication layer can transmit; it does not include Routing layer or Data Link layer overhead.) Use a value in the range 1 to 65,535. The default value is equal to the value of the BUFFER SIZE if specified; otherwise the default is 576.
2.23 – STATE
Specifies the operational state of the local node. There are
four possible states:
OFF Allows no new logical links,
terminates existing links,
and stops route-through
traffic
ON Allows logical links
RESTRICTED Allows no new inbound links
from other nodes
SHUT Allows no new logical links,
does not destroy existing
links, and goes to the OFF
state when all logical links
are gone
2.24 – SUBADDRESS range
Applies only to VAX PSI. Specifies a range of local DTE subaddresses that the Routing Layer will accept as X25 DLM calls. VAX PSI will route all incoming X25 calls within the specified subaddress range to the Routing Layer to be handled as DLM calls.
2.25 – TYPE
Indicates the type of the executor node. Possible node types are
ROUTING IV
NONROUTING IV
AREA
The default depends upon the DECnet license installed. If the
full function kit is installed, the default is ROUTING IV; if the end
node kit is installed, the default (and only possible value) is
NONROUTING IV.
A routing node has full routing capability. A nonrouting node (or end
node) can deliver packets to or receive them from any node, but
cannot route packets from other source nodes through to destination
nodes.
An area node is a level 2 router that can route packets between areas.
2.26 – Examples
NCP>SET EXECUTOR ADDRESS 11 BUFFER SIZE 576
This command sets the executor node's address to 1.11 and buffer
size to 576 bytes.
NCP>SET EXECUTOR STATE ON
This command sets the executor node's operational state to ON.
2.27 – NODE
Use the SET EXECUTOR NODE command to set the default executor for all
NCP commands. The executor is the node on which the Network
Management Listener (NML) runs to perform these commands.
Note that the NODE keyword must appear as the third keyword when
entering the command. The remaining information may appear in any
order thereafter, except the node-spec which must follow the NODE
keyword. Access control information is optional.
SET EXECUTOR NODE node-spec ACCOUNT account
PASSWORD password
USER user-id
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
2.27.1 – ACCOUNT account
Identifies the user's account for access control verification at the designated executor node.
2.27.2 – NODE node-spec
Specifies a node name or address optionally followed by access
control information as specified for VMS. Use one of the
following formats:
node-id
node-id"user password account"
2.27.3 – PASSWORD password
Identifies the user's password for access control verification at the designated executor node.
2.27.4 – USER user-id
Identifies the user's ID for access control verification at the designated executor node.
2.27.5 – Examples
NCP>SET EXECUTOR NODE 14
...
NCP>CLEAR EXECUTOR NODE
The first command sets the executor to node 1.14. (The default
area number 1 is assumed if the area number is not specified in
the node address.) The second command resets the executor to
the executor node.
NCP>SET EXECUTOR NODE 14"LOW JBL"
This command uses access control information to set the
executor node to node 1.14.
NCP>SET EXECUTOR NODE TRNTO USER LOW PASSWORD JBL
This command uses an alternate access control format to set
the executor to node TRNTO.
3 – PROXIES
The SET KNOWN PROXIES ALL command clears the contents of the volatile
proxy database and rebuilds the volatile proxy database from the contents
of the permanent proxy database.
SET KNOWN PROXIES ALL
4 – LINE
Use the SET LINE command to create or modify line parameters in the
volatile database on the executor node. Use the DEFINE LINE command to
create or modify line parameters in the permanent data base on the
executor node.
SET KNOWN LINES (parameters ...)
LINE line-id
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
4.1 – KNOWN LINES
Indicates that the specified parameters for all known lines are to be created or modified in the database.
4.2 – LINE line-id
Identifies the line for which specified parameters are to be created or modified in the database.
4.3 – ALL
Use the SET LINE ALL command to update the volatile copy of the database on the executor node with all the line parameters stored for a particular line in the permanent database on the executor node.
4.4 – BUFFER SIZE
Specifies in bytes the size of receive buffers for the specified line, thereby controlling the maximum size of NSP message segments that can be received from or forwarded to an adjacent node which has accepted the line buffer size. Use a value in the range 1 to 65,535. For broadcast lines, a default value of 1498 bytes is provided. For all other types of lines, the default is the executor BUFFER SIZE value (as specified in the SET EXECUTOR command). This parameter does not apply to X25 lines.
4.5 – CLOCK mode
Specifies the hardware clock mode for the line. The values for clock-mode are: INTERNAL For software controllable loopback use of the clock. This causes the line device to supply a clock signal such that all transmitted messages can be looped back from outside the device. Note that in order to use this parameter, the operator may have to connect a loopback plug in place of the normal line. EXTERNAL For normal clock operating mode. The clock signal is supplied externally to the controller.
4.6 – CONTROLLER
Specifies the controller mode for the line. There are two
possible modes:
LOOPBACK is the internal device
loopback mode for testing
NORMAL is the normal operating mode.
4.7 – COUNTER TIMER seconds
Specifies a timer whose expiration causes a line counter logging event.
4.8 – DEAD TIMER milliseconds
Specifies the number of milliseconds between polls of one of the set of dead tributaries. Applies only to DDCMP CONTROL lines. The default is 10000 (10 seconds).
4.9 – DELAY TIMER milliseconds
Specifies the minimum number of milliseconds to delay between polls. If not set, there is no delay. Applies only to DDCMP CONTROL lines.
4.10 – DUPLEX
Specifies the hardware duplex mode of the line. There are
two possible modes:
HALF half-duplex
FULL full-duplex
4.11 – ECHO
4.11.1 – DATA hex byte
Applies only to FDDI lines. ECHO LENGTH number of bytes of value ECHO DATA will be used to compose the next echo request frame which will be sent to the address specified by ECHO TARGET. Hex_byte must be a string of exactly two hexadecimal digits. The default ECHO DATA is 55. ECHO DATA can be set in the volatile database, but it cannot be defined in the permanent database.
4.11.2 – LENGTH count
Applies only to FDDI lines. ECHO LENGTH number of bytes of type ECHO DATA will be used to compose the next echo request frame which will be sent to the address specified by ECHO TARGET. Count must be a decimal value from 0 to 4478. The default ECHO LENGTH is 1. ECHO LENGTH can be set in the volatile database, but it cannot be defined in the permanent database.
4.11.3 – TARGET address
Applies only to FDDI lines. Specifies the address to which the next echo request frame will be sent. The default ECHO TARGET is 00-00-00-00-00-00. The ECHO TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
4.12 – HANGUP option
Applies only to asynchronous lines. Indicates whether the connection between the dialin node (the local node) and the remote node is to be broken when the line is turned off. Possible values are: ENABLED DISABLED For dynamic lines the value of this parameter is dependent upon whether the terminal characteristic in the DCL command SET TERMINAL was set to HANGUP or NOHANGUP. If HANGUP was specified, the default is HANGUP ENABLED; if NOHANGUP was specified, the default is HANGUP DISABLED. For static lines the default is HANGUP DISABLED.
4.13 – INTERFACE code
Applies only to X25 lines and the ISO8208 profile. Specifies the way in which the processor acts when uses the line. There are two values for the code: DTE specifies that the processor operates as a DTE DCE specifies that the processor operates as a DCE The default code is DTE.
4.14 – LINE SPEED speed
Applies only to asynchronous lines. Specifies the speed of the line. This parameter must be set to the same value on both sides of the asynchronous connection. The default is equal to the current speed of the line.
4.15 – MAXIMUM
4.15.1 – BLOCK count
Applies only to X25 lines. Specifies the maximum size in bytes of the frame for the line. This value must be at least 5 bytes larger than the maximum packet size you specify in SET CIRCUIT (for PVCs and DLM circuits) or SET MODULE X25-PROTOCOL (for SVCs). Specify a value in the range 21 to 4103. By default the size of the frame takes the value specified by the PROFILE parameter of the SET MODULE X25-PROTOCOL command.
4.15.2 – RETRANSMITS count
Applies only to X25 lines. Specifies the maximum number of retransmissions of a frame on the specified line. Specify a value in the range 1 to 255. By default, the retransmission value takes the network value specified by the NETWORK parameter of the SET MODULE X25-PROTOCOL command.
4.15.3 – WINDOW count
Applies only to X25 lines. 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.
4.16 – MICROCODE DUMP file-spec
Applies only to X25 lines. Dumps the microcode of the specified KMS-11/KMV-11 device to the indicated file. By default, the output file takes the format: SYS$SYSROOT:[SYSERR]file-id.DMP The KMS/KMV Dump analyzer (PSIKDA) is the utility program used to process the dump file created by the MICROCODE DUMP parameter.
4.17 – NETWORK net-name
Applies only to X25 lines. Specifies the network to which the line is connected. If only one network is set up, that network is the default. Otherwise the NETWORK parameter is mandatory.
4.18 – NIF TARGET address
Applies only to FDDI lines. Specifies the address to which the next NIF request frame will be sent. The default Neighborhood Information Frame (NIF) target is 00-00-00-00-00-00. NIF TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
4.19 – PROTOCOL
Specifies the line protocol for data link protocol operation. The
possible protocols are:
DDCMP CONTROL Specifies a DDCMP multipoint
control station.
DDCMP POINT Specifies a DDCMP point-to-point
line.
DDCMP TRIBUTARY Specifies a DDCMP multipoint
tributary.
DDCMP DMC Specifies a DDCMP point-to-point
line in DMC compatibility mode.
ETHERNET Specifies that the line uses the
Ethernet/IEEE 802.3 protocol.
FDDI Specifies that the line uses the
FDDI protocol.
LAPB Specifies that the line uses
the X25 level 2 protocol.
LAPBE Specifies that the line uses
the X25 level 2 protocol with
extended sequencing.
Default line protocols are based on the line names listed below:
BNA ETHERNET
CEC ETHERNET
CI No protocol specified
DMB DDCMP POINT
DMC/DMR DDCMP POINT
DMF DDCMP POINT
DMP DDCMP POINT
DMV DDCMP POINT
DSB DDCMP POINT
DSF DDCMP POINT
DSV DDCMP POINT
DSW/DW4 DDCMP POINT
DUP/DPV LAPB
EBA ETHERNET
EIA ETHERNET
ELA ETHERNET
ERA ETHERNET
ETA ETHERNET
EWA ETHERNET
FPA FDDI
FZA FDDI
ISA ETHERNET
KMV LAPB
KMX LAPB
KMY LAPB
MFA FDDI
MNA ETHERNET
MXE ETHERNET
QNA ETHERNET
SVA ETHERNET
TRA ETHERNET
TRE ETHERNET
TRP ETHERNET
UNA ETHERNET
VLA ETHERNET
4.20 – RECEIVE BUFFERS number
Specifies the length of the line's receive queue. Use a number in the range of 1 to 32. A value in the range of 2 to 4 is adequate for line speeds of less than 56K bits. Megabit line speeds may require 8 or more buffers depending on the observed error rate.
4.21 – REQUESTED TRT microseconds
Applies only to FDDI lines. Specifies the requested value for the token rotation timer in microseconds. Microseconds must be a decimal integer in the range of 4000 to 167772. The default is 8000 microseconds.
4.22 – RESTRICTED TOKEN TIMEOUT milliseconds
Applies only to FDDI lines. Specifies the limit on how long a single restricted mode dialog may last before being terminated. Milliseconds must be a decimal integer in the range of 0 to 10000. The default is 1000 milliseconds.
4.23 – RETRANSMIT TIMER milliseconds
Specifies the maximum amount of time allowed to elapse before a retransmission is necessary on a multipoint line. This is the amount of time a control station will wait for a tributary to respond. Milliseconds must be a decimal integer in the range 1 to 65535. The default is 3000.
4.24 – RING PURGER ENABLE option
Applies only to FDDI lines. The option values are:
ON Participate in the Ring Purger election and,
if elected, perform the Ring Purger function.
This is the default.
OFF Do not participate in the Ring Purger election.
This parameter is to allow operation when certain non-conforming
stations are on your ring; except for that case it should be
left ON for improved ring reliability.
4.25 – SCHEDULING TIMER milliseconds
Specifies the number of milliseconds between re-calculation of tributary polling priorities. Applies only to DDCMP CONTROL lines. The default is 50.
4.26 – SERVICE TIMER milliseconds
Specifies the maximum amount of time allowed to elapse before a receive request completes while doing service operations on a line.
4.27 – SIF
4.27.1 – CONFIGURATION TARGET address
Applies only to FDDI lines. Specifies the address to which the next SIF configuration request frame will be sent. The default Status Information Frame (SIF) configuration target is 00-00-00-00-00-00. SIF CONFIGURATION TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
4.27.2 – OPERATION TARGET address
Applies only to FDDI lines. Specifies the address to which the next SIF operation request frame will be sent. The default Status Information Frame (SIF) operation target is 00-00-00-00-00-00. SIF OPERATION TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
4.28 – STATE
Specifies the line's operational state. There are three
possible states:
OFF The line is not in use.
ON The line is available for
normal use.
SERVICE The line is available only
for service functions.
4.29 – STREAM TIMER milliseconds
Specifies the number of milliseconds a tributary or half duplex remote station is allowed to hold the line. The default is 1000 (1 second).
4.30 – SWITCH option
Applies only to asynchronous DDCMP lines. Allow the line currently being used as a DECnet asynchronous communications line to be converted back to a terminal line. The two values of the option are: ENABLED DISABLED The default for dynamic lines is SWITCH ENABLED; the default for static lines is SWITCH DISABLED.
4.31 – VALID TRANSMISSION TIME microseconds
Applies only to FDDI lines. Specifies the maximum time between arrivals of a valid frame or unrestricted token. Microseconds must be a decimal integer in the range of 2500 to 5222. The default is 2621 microseconds.
4.32 – Examples
NCP>SET LINE DMC-0 RECEIVE BUFFERS 3 PROTOCOL DDCMP POINT STATE ON
This command sets up the first DMC-11 for normal use.
NCP>SET LINE DMC-0 STATE OFF
NCP>SET LINE DMC-0 RECEIVE BUFFERS 5 STATE ON
These two commands increase the number of receive buffers for
the first DMC-11.
5 – LOGGING
Use the SET LOGGING command to create or modify logging parameters in
the volatile database on the executor node. Use the DEFINE LOGGING
command to create or modify logging parameters in the permanent
database on the executor node. The STATE and NAME parameters are valid
only for the executor node (i.e., the SINK parameter should specify or
default to the executor).
SET KNOWN LOGGING (parameters ...)
LOGGING CONSOLE
LOGGING FILE
LOGGING MONITOR
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
5.1 – ALL
Use the SET LOGGING ALL command to update the volatile copy of the database on the executor node with all the logging parameters stored for the logging component in the permanent database on the executor node.
5.2 – EVENTS event-list
Specifies those events to be logged. See HELP EVENTS for a list of valid events.
5.3 – KNOWN
Introduces a plural parameter or component.
5.3.1 – EVENTS
Indicates that all events are to be logged.
5.3.2 – LOGGING
Indicates that the specified parameters for all known logging are to be created or modified in the database.
5.4 – CIRCUIT circuit-id
Identifies the circuit for which events are to be logged.
5.5 – LINE line-id
Identifies the line for which events are to be logged.
5.6 – CONSOLE
Indicates that the specified parameters for the logging console are to be created or modified in the database.
5.7 – FILE
Indicates that the specified parameters for the logging file are to be created or modified in the database.
5.8 – MODULE
Introduces a MODULE parameter. Possible module names are:
X25-PROTOCOL
X25-SERVER
X29-SERVER
X25-ACCESS
5.8.1 – X25-ACCESS
Indicates that the logging parameters for the specified source are to be created or modified in the data base.
5.8.2 – X25-PROTOCOL
Indicates that the logging parameters for the specified source are to be created or modified in the data base.
5.8.3 – X25-SERVER
Indicates that the logging parameters for the specified source are to be created or modified in the data base.
5.8.4 – X29-SERVER
Indicates that the logging parameters for the specified source are to be created or modified in the data base.
5.9 – MONITOR
Indicates that the specified parameters for the logging monitor are to be created or modified in the database. If no NAME parameter, the default monitor is OPCOM.
5.10 – NAME file-name
Identifies the name of a console, file, or monitor program to which events will be logged. If no NAME parameter is specified for the monitor sink, events will be sent to the default monitor, OPCOM. If no NAME parameter is specified for the console sink, events will be sent to OPA0:.
5.11 – NODE node-id
Identifies the node for which events are to be logged.
5.12 – SINK
Identifies the node that is to receive events. There are two
possibilities:
EXECUTOR identifies the local node
(default).
NODE node-id identifies a node in the
network.
5.13 – STATE
Specifies the operational state of the sink. There are three possible
states:
HOLD The sink is temporarily unavailable
and events should be queued.
OFF The sink is unavailable for receiving
events.
ON The sink is available for receiving
events.
5.14 – Examples
NCP>SET LOGGING MONITOR KNOWN EVENTS
NCP>SET LOGGING MONITOR STATE ON
These two commands enable normal event logging using OPCOM.
To receive the formatted events at a terminal, use the DCL
command, REPLY/ENABLE=NETWORK.
NCP>SET LOGGING CONSOLE KNOWN EVENTS
NCP>SET LOGGING CONSOLE NAME [SYSMGR]EVENTS.DAT
NCP>CLEAR LOGGING CONSOLE EVENT 4.14
NCP>SET LOGGING CONSOLE STATE ON
These commands enable formatted logging of all events but
the node reachability change event to file EVENTS.DAT.
NCP>SET LOGGING MONITOR STATE OFF
This command sets the operational state of logging to
OPCOM on the executor node to OFF.
6 – MODULE
Introduces the various module entities.
6.1 – CONFIGURATOR
Use the SET MODULE CONFIGURATOR command to create or modify the parameters of the Ethernet configurator module component in the volatile database at the local node on an Ethernet circuit. A qualifier must be specified following the configurator keyword. SET MODULE CONFIGURATOR KNOWN CIRCUITS ALL CIRCUIT circuit-id SURVEILLANCE control All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
6.1.1 – ALL
Copies the configurator module information from the permanent database into the volatile database at the local node.
6.1.2 – SURVEILLANCE control
Indicates whether or not a list of active systems is to be kept for the Ethernet circuit or circuits specified. There are two control values: DISABLED The list is not to be kept. This is the default. ENABLED The list is to be kept.
6.2 – X25-ACCESS
Use the SET MODULE X25-ACCESS and DEFINE MODULE X25-ACCESS commands
to associate the host node with the specified multi-host node for the
purpose of accessing a specified X25 network. The multi-host node
connected to the specified X25 network is a VMS node with VAX
PSI multi-host software installed.
SET MODULE X25-ACCESS NETWORK network-name ACCOUNT
KNOWN NETWORKS ALL
NODE
PASSWORD
USER
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
6.2.1 – ACCOUNT
Identifies the user account for use by incoming calls to the network. Specify a string of from 1 to 39 characters. By default, no account is used.
6.2.2 – ALL
Copies all X25-ACCESS parameters from the permanent data base into the volatile data base.
6.2.3 – KNOWN NETWORKS
Identifies all known networks
6.2.4 – NETWORK network-name
Identifies the network whose parameters are to be set in the data base.
6.2.5 – NODE node-id
Specifies the node address or name used of the multi-host node that is connected to a specified X25 network. When you specify an X25-ACCESS network for the first time, this parameter is mandatory.
6.2.6 – PASSWORD
Specifies the password for use by incoming calls to the network. Specify a string of from 1 to 39 characters. The default is that no password is used.
6.2.7 – USER
Specifies the user identification for use by incoming calls to the network. Specify a string of from 1 to 16 characters. The default is that no user identification is used.
6.3 – X25-PROTOCOL
Use the SET MODULE X25-PROTOCOL command to create or modify the
parameters of the Protocol Module component in the volatile data
base. Use the DEFINE MODULE X25-PROTOCOL command to create or modify
the parameters of the Protocol Module component in the permanent data
base.
Use separate SET MODULE X25-PROTOCOL commands to a specify a DTE with
its associated parameters, a group with its associated parameters and
the network profile.
SET MODULE X25-PROTOCOL DTE dte-address NETWORK network-name
KNOWN DTES KNOWN NETWORKS
ALL
CALL TIMER seconds
CHANNELS list
CLEAR TIMER seconds
COUNTER TIMER seconds
DEFAULT DATA bytes
DEFAULT WINDOW count
INTERFACE code
INTERRUPT TIMER seconds
LINE line-id
MAXIMUM CIRCUITS count
MAXIMUM CLEARS count
MAXIMUM DATA bytes
MAXIMUM RESETS count
MAXIMUM RESTARTS count
MAXIMUM WINDOW count
RESET TIMER seconds
RESTART TIMER seconds
STATE ON
OFF
SHUT
GROUP group-name ALL
KNOWN GROUPS DTE dte-address
NETWORK net-name
NUMBER group-number
TYPE BILATERAL
NETWORK net-name PROFILE profile-name
KNOWN NETWORKS
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
6.3.1 – ALL
Can be used with DTE, GROUP or NETWORK. It selects all parameters for the specified component or for all known DTEs, groups or networks.
6.3.2 – CALL TIMER
Specifies a timer that starts when a request to set up an X25 virtual circuit is transmitted, and whose termination clears the request if no response has been received. Specify a value in the range 1 to 255. By default the timer takes the network value specified by the PROFILE parameter.
6.3.3 – CHANNELS
Specifies a list of logical channel numbers (LCNs) reserved for outgoing calls. The list can consist of one or more LCNs. Separate LCNs with hyphens to indicate ranges, or with commas to indicate separate list items. Specify a value in the range 0 to 4095 for each LCN. If a DTE is to make outgoing calls you must specify this parameter when defining the DTE.
6.3.4 – CLEAR TIMER
Specifies a timer that starts when a request to clear an X25 Virtual circuit is transmitted, and whose termination retransmits the clear request if not response has been received. Specify a value in the range 1 to 255. By default, the timer takes the network value specified by the PROFILE parameter.
6.3.5 – COUNTER TIMER
Sets a timer whose expiration causes a DTE counter logging event. Specify a decimal integer in the range 1 to 65,535.
6.3.6 – DEFAULT
6.3.6.1 – DATA
Specifies the default packet size for X25 virtual circuits. This value must be at least 5 bytes less than the MAXIMUM BLOCK value you specify in the SET LINE command and must be a power of 2. Specify a value in the range 16 to 4096 bytes. By default packet size takes the network value specified by the PROFILE parameter.
6.3.6.2 – WINDOW count
Specifies the default window size for X25 virtual circuits, 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 network value specified by the PROFILE parameter.
6.3.7 – DTE
Identifies a local DTE. If you specify the DTE qualifier, you must associate with it: NETWORK network-name or KNOWN NETWORKS
6.3.8 – KNOWN
Can be used with DTES, NETWORKS and GROUPS. KNOWN DTES selects all known DTEs on the network specified or all known networks. KNOWN NETWORKS selects all known networks. KNOWN GROUPS selects all known groups.
6.3.9 – INTERFACE code
Specifies the way in which the processor operates. This parameter can
only be used with the ISO8208 profile. The parameter can take one of
the following values:
DTE The processor operates as a DTE.
DCE The processor operates as a DCE.
NEGOTIATED The processor can operate either as a DTE or DCE. The
processor automatically selects the correct method of operation.
The default is DTE.
6.3.10 – INTERRUPT TIMER secs
This is the interrupt timer (ISO T26 timer). This parameter can only be used with the ISO8208 profile. Specify a value in the range 1 to 255. If you do not specify a value there is no time limit on interrupt acknowledgments.
6.3.11 – LINE line-id
Identifies the line associated with the DTE. Specify a line name in the format dev-c[u]. This parameter is mandatory when you specify a DTE for the first time.
6.3.12 – MAXIMUM
6.3.12.1 – CIRCUITS count
Specifies the maximum number of circuits for the DTE. By default, the maximum is 255.
6.3.12.2 – CLEARS count
Specifies the maximum number of attempts to clear an X25 virtual circuit. Specify a value in the range 1 to 255. By default the value is the network value specified by the PROFILE parameter.
6.3.12.3 – DATA bytes
Specifies the maximum packet size for X25 virtual circuits. This value must be at least 5 bytes less than the MAXIMUM BLOCK value you specify in the SET LINE command and must be a power of 2. Specify a value in the range 16 to 4096 bytes. By default the value taken is the network value specified by the PROFILE parameter.
6.3.12.4 – RESETS count
Specifies the maximum number of attempts to reset an X25 virtual circuit. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter.
6.3.12.5 – RESTARTS count
Specifies the maximum number of attempts to restart an X25 virtual circuit. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter.
6.3.12.6 – WINDOW count
Specifies the window size allowed for X25 virtual circuits, that is, the maximum number of packets for which outstanding acknowledgments are allowed. Specify a value in the range 1 to 127. By default, the window size takes the network value specified by the PROFILE parameter.
6.3.13 – GROUP
Identifies a closed user group (CUG) or bilateral closed user group (BCUG) or specifies all known groups.
6.3.13.1 – DTE dte-address
Identifies the local DTE associated with the group name. This parameter is mandatory when creating a group.
6.3.13.2 – ALL
Copies the group parameters from the permanent data base into the volatile data base. (Used only with the SET MODULE X25-PROTOCOL command.)
6.3.13.3 – NUMBER group-number
Specifies the CUG or BCUG number. Specify a two-digit number for a CUG and a four-digit number for a BCUG. You can omit leading zeroes. This parameter is mandatory when creating a group.
6.3.13.4 – TYPE BILATERAL
Specifies the user group as a BCUG. Omit this parameter if the user group is a CUG.
6.3.14 – ALL
Copies the network parameters from the permanent data base into the volatile data base. (Used only with the SET MODULE X25-PROTOCOL command.)
6.3.15 – NETWORK net-name
Identifies a network.
6.3.16 – PROFILE profile-name
Specifies a profile to be used on the network. The profile-name is a character string of up to 32 characters. This parameter is mandatory.
6.3.17 – RESET TIMER secs
Specifies a timer that starts when a reset is transmitted, and whose termination retransmits the reset if no response has been received. Specify a value in the range 1 to 255. By default the timer takes the network value specified by the PROFILE parameter.
6.3.18 – RESTART TIMER secs
Specifies a timer that starts when a restart is transmitted, and whose termination retransmits the restart if no response has been received. Specify a value in the range 1 to 255. By default, the timer takes the network value specified by the PROFILE parameter.
6.3.19 – STATE dte-state
Specifies the operational state of the DTE as follows:
ON The DTE is available for normal use
OFF The DTE is not in use
SHUT The DTE is to be closed down when all present activity has
ceased
6.3.19.1 – PROFILE
Specifies a profile to be used on the network. The profile-name is a character string of up to 32 characters. This parameter is mandatory.
6.3.20 – CALL TIMER seconds
Specifies a timer that starts when a request to set up a virtual circuit is transmitted, and whose expiration clears the request if no response has been received. Specify a value in the range 1 to 255. By default, the timer takes the network value specified by the NETWORK parameter.
6.3.21 – CLEAR TIMER seconds
Specifies a timer that starts when a request to clear a virtual circuit is transmitted, and whose expiration retransmits the clear request if no response has been received. Specify a value in the range 1 to 255. By default, the timer takes the network value specified by the NETWORK parameter.
6.4 – X25-SERVER
Use the SET MODULE X25-SERVER command to create or modify the
parameters of the X25 Call Handler in the volatile data base. Use
the DEFINE MODULE X25-SERVER command to create or modify the
parameters of the X25 Call Handler in the permanent data base.
The components contain records that identify a destination,
specify parameters for this destination, specify the maximum
number of circuits that each module (that is, all destinations
for a particular module) may have, and specify the state of the
module.
Specify the module parameters and the destinations using
separate SET or DEFINE MODULE X25-SERVER or X29-SERVER commands.
Format:
SET MODULE X25-SERVER ALL
X29-SERVER COUNTER TIMER seconds
MAXIMUM CIRCUITS count
STATE ON
OFF
SHUT
DESTINATION dest-name ACCOUNT account
KNOWN DESTINATIONS CALL MASK hex-value
CALL VALUE hex-value
CALLED ADDRESS dte-address
EXTENSION MASK hex-string
EXTENSION VALUE hex-string
GROUP group-name
INCOMING ADDRESS dte-address
NETWORK network-name
NODE node-id
OBJECT object-id
PASSWORD password
PRIORITY priority
RECEIVING DTE dte-address
REDIRECT REASON code
SENDING ADDRESS dte-address
SUBADDRESSES range
USER user-id
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
6.4.1 – ALL
Copies the Call Handler parameters from the permanent data base into the volatile data base. (Used only for the SET MODULE X25-SERVER command or the SET MODULE X29-SERVER command.)
6.4.2 – KNOWN DESTINATIONS
Specifies all known destinations.
6.4.3 – COUNTER TIMER seconds
Sets a timer whose expiration causes a server module counter logging event. Specify a decimal integer in the range 1 to 65,535.
6.4.4 – MAXIMUM CIRCUITS count
Specifies the maximum number of circuits that the module (that is, all destinations) may have. By default, the maximum is 255.
6.4.5 – STATE
Specifies the operational state of the server module. This parameter
takes one of the following values:
ON The module is available for normal use.
OFF The module is not in use.
SHUT The module is to be closed down but only when all
present activity has ceased. (The SHUT value applies only
to the SET MODULE X25-SERVER or X29-SERVER command.)
For the X25 server module, the default state is ON. For
the X29 server module, the default state is OFF.
6.4.6 – CALLED ADDRESS dte-address
For redirected calls, this parameter identifies the DTE that was originally called. The parameter value is used to select a destination for a redirected call. By default, no called DTE is used.
6.4.7 – DESTINATION dest-name
Identifies a destination or specifies all known destinations. Dest-name is an id string. Associate parameters with the destination or destinations, as follows:
6.4.8 – ACCOUNT account
Identifies the user account for use by incoming calls to the destination. Specify a string of from 1 to 39 characters. By default, no account is used.
6.4.9 – CALL
6.4.9.1 – MASK hex-value
Specifies the mask applied to the incoming call data before it is tested. Hex-value is a string of 2 to 32 hexadecimal digits. By default, no mask is used.
6.4.9.2 – VALUE hex-value
Specifies the string used to test the incoming call data. Hex-value is a string of 2 to 32 hexadecimal digits. By default, no value is used.
6.4.10 – EXTENSION
6.4.10.1 – MASK hex-string
Provides a mask for the called address extension facility. Using logical AND, the mask is merged with the called address extension in the incoming call and the result is compared with the extension value. By default no extension mask is used.
6.4.10.2 – VALUE hex-string
Provides a value for the called address extension facility. This value is compared with the address extension in the incoming call (after merging as described in EXTENSION MASK). By default no extension value is used.
6.4.11 – GROUP group-name
Identifies a closed user group (CUG) or bilateral closed user group (BCUG). The group-name is an id string. By default, no group name is used.
6.4.12 – INCOMING ADDRESS dte-address
Identifies the address of the DTE receiving the call (as specified in the call packet).
6.4.13 – NETWORK net-name
Specifies the network for which calls are accepted. By default, no network name is used.
6.4.14 – NODE node-id
Identifies the host node which is to be the destination of the incoming X25 call.
6.4.15 – OBJECT object-id
Identifies the object that is activated when an incoming call arrives. The object-id is an id string. If the object name looks like a number, enclose the string in quotes. This parameter is mandatory when you specify a destination for the first time.
6.4.16 – PASSWORD password
Specifies the password for use by incoming calls to the destination. Specify a string of from 1 to 39 characters. The default is that no password is used.
6.4.17 – PRIORITY priority
Specifies the priority of the destination record and is used to select one of a set of destinations for which the incoming call may be valid. Specify a value in the range 0 to 255, where 255 is the highest priority. By default, priority takes a value of 0.
6.4.18 – RECEIVING DTE
Identifies the local DTE. IT is used to select a destination for calls received on the local DTE. By default, no receiving DTE is used.
6.4.19 – REDIRECT REASON code
Identifies a reason for redirecting an incoming call. The reason code
can take one of the following values:
BUSY The original DTE was busy and could no accept any
more calls.
OUT OF ORDER The original DTE was out of order.
SYSTEMATIC All calls to the original DTE are automatically
rerouted.
The reason code is used to select a destination for a redirected
call. By default, no reason is used.
6.4.20 – SENDING ADDRESS dte-address
Identifies the address of the remote DTE that originated the call. By default, no sending DTE is used.
6.4.21 – SUBADDRESSES range
Specifies the range of local DTE subaddresses that identify the destination for the incoming call. Range consists of one or two subaddresses. Subaddress is a decimal integer in the range 0 to 9999. Separate two subaddresses with a single hyphen to indicate a range. The second subaddress must be greater than the first. By default, no subaddress range is used.
6.4.22 – USER user-id
Specifies the user identification for use by incoming calls to the destination. Specify a string of from 1 to 16 characters. The default is that no user identification is used.
6.5 – X29-SERVER
Use the SET MODULE X29-SERVER command to create or modify the
parameters of the X.29 Call Handler in the volatile data base. Use
the DEFINE MODULE X29-SERVER command to create or modify the
parameters of the X.29 Call Handler in the permanent data base.
The components contain records that identify a destination,
specify parameters for this destination, specify the maximum
number of circuits that each module (that is, all destinations
for a particular module) may have, and specify the state of the
module.
Specify the module parameters and the destinations using
separate SET or DEFINE MODULE X25-SERVER or X29-SERVER commands.
Format:
SET MODULE X25-SERVER ALL
X29-SERVER COUNTER TIMER seconds
MAXIMUM CIRCUITS count
STATE ON
OFF
SHUT
DESTINATION dest-name ACCOUNT account
KNOWN DESTINATIONS CALL MASK hex-value
CALL VALUE hex-value
CALLED ADDRESS dte-address
EXTENSION MASK hex-string
EXTENSION VALUE hex-string
GROUP group-name
INCOMING ADDRESS dte-address
NETWORK network-name
NODE node-id
OBJECT object-id
PASSWORD password
PRIORITY priority
RECEIVING DTE dte-address
REDIRECT REASON code
SENDING ADDRESS dte-address
SUBADDRESSES range
USER user-id
Please refer to help on SET MODULE X25-SERVER for more details.
7 – NODE
Use the SET NODE command to create or modify node parameters in the
volatile database on the local node. Use the DEFINE NODE command to
create or modify node parameters in the permanent database on the local
node.
SET KNOWN NODES (parameters ...)
NODE node-id
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
7.1 – KNOWN NODES
Indicates that the specified parameters for all known nodes are to be created or modified in the database.
7.2 – NODE node-id
Identifies the node (local or remote) for which specified parameters are to be created or modified in the database.
7.3 – ALL
Use the SET NODE ALL command to update the volatile database on the executor node with all the parameters stored for a particular node in the permanent database on the executor node.
7.4 – ACCESS
Specifies the allowed logical link connections for the node. There are
four options:
INCOMING Allows logical link connections from the remote node
OUTGOING Allows the local node to initiate connections to the
remote node; but does not allow connections from the
remote node
BOTH Allows incoming and outgoing logical link connections.
This is the default
NONE Does not allow incoming or outgoing logical link
connections to this node
7.5 – ADDRESS node-address
Specifies the address of the node to which you want the database entry to refer.
7.6 – CIRCUIT circuit-id
Identifies a loop node and specifies the identification of the circuit to be used for all traffic to the loop node.
7.7 – COUNTER TIMER seconds
Specifies a timer whose expiration causes a node counter logging event.
7.8 – CPU cpu-type
Identifies the node's CPU type. There are four valid types:
DECSYSTEM1020
PDP11
PDP8
VAX
7.9 – DIAGNOSTIC FILE file-spec
Applies to nodes on broadcast circuits. Identifies the file to be read when the adjacent node has been downline loaded and has requested diagnostics. The file-spec is interpreted according to the file system of the executor node.
7.10 – DUMP
7.10.1 – ADDRESS number
Identifies the address in memory to begin an upline dump of the adjacent node.
7.10.2 – COUNT number
Specifies the default number of memory units to upline dump from the the adjacent node.
7.10.3 – FILE file-spec
Identifies which file to write to when the adjacent node is dumped upline. The file-spec is interpreted according to the file system of the executor node.
7.11 – HARDWARE ADDRESS address
Identifies the address originally assigned to the controller for the system on the adjacent node. Used during operations such as downline loading to communicate with the system before the system has set up its physical address.
7.12 – HOST node-id
Identifies the host node. For an adjacent node, the host address is a parameter that the adjacent node receives when it is loaded downline. If no host is specified, the default is the executor node.
7.13 – INBOUND node-type
Required for nodes when the VERIFICATION INBOUND parameter is
specified for the circuit over which the connection is to be made.
Specifies the type of the node. The node-type is checked by the
executor node if the specified node attempts to form a dynamic
connection with the executor node. If VERIFICATION INBOUND is not
specified for the circuit, the INBOUND parameter for the node is
ignored. The two possible node-types are
ENDNODE Allows the remote node to be connected only if it is
configured as an end node
ROUTER Allows the remote node to be connected whether it is
configured as an end node or a router
7.14 – LOAD
7.14.1 – ASSIST AGENT
Specifies the VMS image that will define the system software for downline loading and adjacent node.
7.14.2 – ASSIST PARAMETER
Specifies a parameter to be passed to a load assist agent. The load assist agent can be used to tailor the system software to be loaded.
7.14.3 – FILE file-spec
Specifies a file containing the system software for downline loading to an adjacent node.
7.15 – MANAGEMENT FILE
Specifies a file containing management information for downline loading to an adjacent node.
7.16 – NAME node-name
Specifies the node name to be associated with the node identification. Only one name can be assigned to a node address or a line identification.
7.17 – NONPRIVILEGED item
Specifies nonprivileged inbound access control information for the
node, where
ACCOUNT account Identifies the account for the default non-
privileged DECnet account on the designated
node
PASSWORD password Identifies the password for the default non-
privileged DECnet account on the designated
node
USER user-id Identifies the user name for the default non-
privileged DECnet account on the designated
node
7.18 – PRIVILEGED item
Specifies privileged inbound access control information for the node,
where
ACCOUNT account Identifies the account for the default priv-
ileged DECnet account on the designated node
PASSWORD password Identifies the password for the default priv-
ileged DECnet account on the designated node
USER user-id Identifies the user name for the default priv-
ileged DECnet account on the designated node
7.19 – RECEIVE PASSWORD hex-password
Defines the password (1-8 characters) that is expected from the remote node during a Routing initialization sequence. Does not apply to nodes on an broadcast circuit.
7.20 – SECONDARY LOADER file-spec
Specifies a file containing the secondary boot loader for downline loading to an adjacent node.
7.21 – SERVICE
Introduces a service parameter. All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
7.21.1 – CIRCUIT circuit-id
Establishes the circuit to be used for downline loading. This is the default value for the VIA parameter of the LOAD and CONNECT commands. The node identification must be that of the target node.
7.21.2 – DEVICE device-type
Identifies the target node's line controller for the service circuit
over which the operation is to take place. The possibilities are
as follows.
BNA CEC DA DL DLV DMB
DMC DMF DMP DMR DMV DP
DQ DSB DSF DSW DTE DU
DUP DV DW4 DZ ELA ERA
ETA EWA FPA FZA ISA KDP
KDZ KL MFA MNA MXE PCL
QNA SVA TRA TRE TRP UNA
VLA
Only the synchronous port on the DMF service device may be used.
7.21.3 – NODE VERSION version
Specifies the DECnet software version of the node which downline loads its software to a target node. The two possible versions are PHASE III and PHASE IV. The default is PHASE IV.
7.21.4 – PASSWORD hex-password
Defines the password required to trigger the bootstrap mechanism on the target node. The password is a hexadecimal number. For DDCMP circuits, the password is in the range 0 to FFFFFFFF; for broadcast circuits, it is in the range 0 to FFFFFFFFFFFFFFFF. The default is 0.
7.22 – SOFTWARE
Introduces a software parameter. All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands.
7.22.1 – IDENTIFICATION software-id
Is the ID of the software to be downline loaded.
7.22.2 – TYPE software-type
Identifies a particular file type to be loaded. There are three
possibilities:
MANAGEMENT FILE
SECONDARY LOADER
TERTIARY LOADER
SYSTEM
7.23 – TERTIARY LOADER file-spec
Specifies a file containing a tertiary boot loader for downline loading to an adjacent node.
7.24 – TRANSMIT PASSWORD password
Specifies a password (1-8 characters) sent to the remote node during a Routing initialization sequence. Does not apply to nodes on a broadcast circuit.
7.25 – Examples
NCP>SET NODE 5.14 NAME DENVER
This command sets the node name of node 5.14 to DENVER.
NCP>SET NODE 2.11 -
_ NONPRIVILEGED -
_ USER NETNONPRIV -
_ PASSWORD NONPRIV -
_ PRIVILEGED -
_ USER NETPRIV -
_ PASSWORD PRIV
This command establishes default privileged and nonprivileged
access control information for node 2.11.
NCP>SET NODE 14 ADDRESS 2
This command associates the information for node 1.14 with a
new node whose address is 1.2. This example assumes that the
executor is in area 1.
NCP>SET NODE LARK HARDWARE ADDRESS AA-00-03-00-00-00
This command associates with the node LARK the hardware
address originally assigned to the DEUNA controller at
node LARK. This information in the volatile database can
be used during downline loading of target node LARK over an
Ethernet circuit.
8 – OBJECT
Use the SET OBJECT command to create or modify object parameters in the
volatile database on the local node. Use the DEFINE OBJECT command to
create or modify object parameters in the permanent database on the
local node.
SET OBJECT object-name (parameters ...)
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
8.1 – KNOWN OBJECTS
Applies only to VAX PSI. Indicates that the specified parameters are applicable to all known objects.
8.2 – OBJECT object-name
Identifies the object for which specified parameters are to be created or modified in the database. For VAX PSI, specify the object name using an id-string.
8.3 – ALL
The SET OBJECT ALL command to updates the volatile database on the local node with all the object parameters stored for a particular object in the permanent database on the local node.
8.4 – ACCOUNT account
Identifies the default user's account for access control on inbound connects to the object when no access control is specified by the remote node. For VAX PSI, identifies the user account for use by incoming X25 calls to the object; if not specified, no account is used.
8.5 – ALIAS
8.5.1 – INCOMING option
Specifies how a particular object responds to incoming connect
requests directed to the alias node address. The alias node address
is established using the SET EXECUTOR command. There are two options
for ALIAS INCOMING:
ENABLED Allows a specified object to receive incoming connect
requests that have been directed to the alias node
address. An object such as PHONE which uses a protocol
that depends on multiple links should not be enabled
for ALIAS INCOMING. By default, if an alias node
identifier has been specified, ALIAS INCOMING is
enabled for all objects except for PHONE.
DISABLED Does not allow a specified object to receive incoming
connect requests that have been directed to the alias
node address. An object whose resources are not
accessible clusterwide should not have ALIAS INCOMING
disabled. If an attempt is made to connect to an
object that does not have ALIAS INCOMING enabled, the
status message NO SUCH OBJECT is returned.
8.5.2 – OUTGOING option
Specifies whether a particular object uses the alias node identifier
specified in the SET EXECUTOR command in its outgoing connect requests
and other protocols. Specify either of the following two options:
ENABLED Allows a specified object to use the alias node
address in its outgoing connect requests. An object
such as PHONE which uses a protocol that depends on
multiple links should not have the ALIAS OUTGOING
parameter enabled. By default, only the object MAIL
has ALIAS OUTGOING enabled.
DISABLED Does not allow a specified object to use the alias
node address in its outgoing connect requests.
8.6 – FILE file-spec
Specifies the command file containing the command procedure used to
start the indicated object. If not specified, the default is
SYS$SYSTEM:object-name.COM
For VAX PSI, this parameter specifies the command file containing the
command procedure used to activate a user program or task. When you
specify an object for the first time, this parameter is mandatory.
8.7 – NUMBER number
Specifies the object number. Use a number in the range of 0 to 255, except for those reserved. When you specify an object for the first time, this parameter is mandatory. For VAX PSI, specify this parameter as 0.
8.8 – OUTGOING CONNECT PRIVILEGES privilege-list
Specifies the privileges that a user must possess in order to make outbound connections to the object. Refer to the Guide to Setting Up a VMS System for a complete list of privileges and their meanings. Does not apply to VAX PSI.
8.9 – PASSWORD password
Identifies the default user's password for access control on inbound connects to the object when no access control is specified by the remote node. This password must match the password established for the account. For VAX PSI, this parameter is mandatory. It identifies the user's password for use by incoming X25 calls to the object.
8.10 – PRIVILEGES privilege-list
Specifies those privileges normally required by the object. A user with those privileges may be supplied with default outbound privileged access control information when connecting to the object. Refer to the Guide to Setting Up a VMS System for a complete list of privileges and their meanings. Does not apply to VAX PSI.
8.11 – PROXY option
Assigns the proxy login access defaults to individual objects. Specify
one of the following four options:
INCOMING Allows proxy login to the object.
OUTGOING Allows the object to initiate proxy login.
BOTH Allows both incoming and outgoing proxy login access.
This is the default option.
NONE Does not allow incoming or outgoing proxy login
access.
8.12 – USER user-id
Identifies the default user's identification for access control on inbound connects to the object when no access control is specified by the remote node. For VAX PSI, this parameter specifies the user identification for use by incoming X25 calls to the object; this parameter is mandatory when you specify an object for the first time.
8.13 – Examples
NCP>SET OBJECT NML FILE NML NUMBER 19
This command an object number, 19, for the NML object.
NCP>SET OBJECT NML-
_ PRIVILEGES OPER DIAGNOSE -
_ USER NET_NONPRIV -
_ PASSWORD NET_NONPRIV
This command establishes default access control information
for the NML object and sets those privileges required to
connect to this object.