1 SET 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. 2 CIRCUIT Use the SET CIRCUIT command to create or modify circuit parameters in the volatile database. Most parameters cannot be SET when the circuit is in the ON state. However, the COST, COUNTER TIMER, HELLO TIMER, MAXIMUM ROUTERS, STATE, TRANSMIT TIMER, and VERIFICATION can be changed with the circuit is in the ON state. SET KNOWN CIRCUITS (parameters ...) DEFINE CIRCUIT circuit-id Use the DEFINE CIRCUIT command to create or modify permanent circuit parameters. All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 3 ALL Use the ALL command to update the volatile database with all the circuit parameters stored for a particular circuit or all known circuits in the permanent database. 3 ACTIVE_BASE base Applies to DDCMP CONTROL circuits. This value indicates the base priority of an ACTIVE tributary after the tributary has been polled. You can indicate a separate base for each of the indicated polling states. The base value must be a decimal integer from 0 to 255. The ACTIVE BASE default is 255. 3 ACTIVE_INCREMENT increment Applies to DDCMP CONTROL circuits. This parameter indicates the increment value added to the ACTIVE tributary priority each time the scheduling timer expires. The increment value must be a decimal integer from 0 to 255. The ACTIVE INCREMENT default is 0. 3 BABBLE TIMER milliseconds 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). 3 CHANNEL number Applies only to X.25 PVCs. Identifies the logical channel number for the X.25 PVCs. Specify a value in the range 0 to 4095. This parameter is mandatory when you specify an X.25 PVC for the first time. 3 CIRCUIT circuit-id Identifies the circuit for which specified parameters are to be created or modified in the database. 3 COST number Does not apply to X.25 PVCs. Specifies the transport routing cost of the circuit. The number must be a decimal integer in the range 1 to 63. Messages will travel between nodes along the path with the smallest total cost. 3 COUNTER TIMER seconds Specifies the number of seconds that the circuit 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. If no value is set for COUNTER TIMER, the circuit counters are not logged automatically. 3 DEAD THRESHOLD count Applies only 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. 3 DTE dte-addr Applies only to X.25 PVCs and DLM circuits. It identifies the local DTE for the circuit. Specify a decimal integer of 1 to 15 digits. See the Public Network Information manual for the format of the address on your network. This parameter is optional for DLM SVCs and mandatory when you specify an X.25 PVC or DLM PVC for the first time. 3 DYING_BASE base Applies to DDCMP CONTROL circuits. This value sets the base priority of a 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. The DYING BASE default is 0. 3 DYING_INCREMENT 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. The DYING INCREMENT default is 16. 3 DYING_THRESHOLD number 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. Number must be a decimal integer in the range 0 to 255. The default number is 2. 3 HELLO TIMER seconds Does not apply to X.25 PVCs. Specifies the frequency of Routing Hello messages sent to adjacent nodes on the circuit. Seconds must be a decimal integer in the range 0 to 8191. The default value is 15. The value of the read-only circuit parameter LISTEN TIMER is three times the value of the HELLO TIMER parameter. 3 INACTIVE_BASE base Applies to DDCMP CONTROL circuits. This value indicates the base priority of an INACTIVE tributary after the tributary has been polled. You can indicate a separate base for each of the indicated polling states. Base must be a decimal integer from 0 to 255. The default is 0. 3 INACTIVE_INCREMENT increment Applies to DDCMP CONTROL circuits. This parameter indicates 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. The default is 64. 3 INACTIVE_THRESHOLD number 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. Number must be a decimal integer in the range 0 to 255. The default number is 8. 3 KNOWN CIRCUITS Indicates that the specified parameters for all known circuits are to be created or modified in the database. 3 MAXIMUM_BUFFERS number 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. Number must be a decimal integer in the range up to 254 or the keyword UNLIMITED. 3 MAXIMUM_DATA number Applies only to X.25 PVCs and DLM circuits. Specifies the maximum packet size for the X.25 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. See the Public Network Information manual for the network value of this parameter. 3 MAXIMUM_RECALLS number Applies only to X.25 DLM outgoing Switched Virtual Circuits (SVCs). Specifies the maximum number of call retries generated on an outgoing DLM circuit before the circuit is declared nonoperational. The range of possible values for MAXIMUM RECALLS is 0 to 255. The number value of 0 specifies an infinite number of call retries. The default value is 100. 3 MAXIMUM_ROUTERS number Applies only to broadcast circuits. It specifies the maximum number of routers allowed by the Routing layer on this circuit. Use a number in the range 1 to 33. The default value is 33. 3 MAXIMUM_TRANSMITS number Applies to DDCMP CONTROL circuits. It specifies the maximum number of data messages that can be transmitted at one time. Number must be a decimal integer in the range 1 to 255. The default is 4. 3 MAXIMUM_WINDOW count Applies only to X.25 PVCs and X.25 DLM circuits. Specifies the maximum window size allowed for the X.25 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. See the Public Network Information manual for the network value of this parameter. 3 NETWORK net-name Applies only to X.25 PVCs and X.25 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. 3 NUMBER dte-addr Applies only to X.25 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. 3 OWNER EXECUTOR Applies only to X.25 DLM circuits. Identifies the circuit owner as the executor. This parameter is mandatory for an X.25 DLM circuit. 3 POLLING STATE state Applies only to DDCMP CONTROL circuits. Identifies the multipoint polling state of the tributary. There are five possible states: AUTOMATIC The tributary's state varies according to the operation of the polling algorithm. This is the default. 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. 3 RECALL TIMER seconds Applies only to X.25 DLM circuits. Specifies 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. 3 ROUTER PRIORITY number 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. 3 SERVICE mode Does not apply to X.25 circuits. 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. This is the default. ENABLED The circuit may be put into service state and perform service functions. 3 STATE circuit-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. 3 TRANSMIT TIMER milliseconds Applies to DDCMP circuits. Specifies 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. 3 TRIBUTARY tributary-address Applies to DDCMP circuits. Indicates the Data Link physical tributary address of the circuit. The tributary-address value must be a decimal integer in the range 0 to 255. 3 TYPE X25 Applies only to X.25 circuits. Specifies the type of circuit. For circuit names starting with "X25-", TYPE is always X25. 3 USAGE Usage-type Applies only to X.25 circuits. Specifies the usage type of an X.25 virtual circuit. The possible values usage-types are: INCOMING Applies only to X.25 DLM SVCs. The circuit is used only for incoming calls. OUTGOING Applies only to X.25 DLM SVCs. The circuit is used only for outgoing calls. PERMANENT This parameter is mandatory for X.25 PVCs. The circuit is permanently connected to a remote DTE, and does not need to be switched dynamically. 3 VERIFICATION option 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 circuits. 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 (using the SET/DEFINE NODE COMMAND). 3 Examples NCP>SET KNOWN CIRCUITS ALL This command loads all permanent database entries stored for all known circuits into the volatile database. NCP>SET CIRCUIT DMC-0 COST 4 STATE ON This command sets the STATE to ON and the circuit COST to 4 for circuit DMC-0. NCP>SET CIRCUIT MNA-0 STATE ON MAXIMUM ROUTERS 5 This command sets Ethernet circuit MNA-0 to ON and sets the maximum number of routers permitted on the circuit to 5. NCP>DEFINE CIRCUIT X25-ANDIES CHANNEL 3 DTE 123789456 - _ NETWORK PSDND MAXIMUM DATA 1024 MAXIMUM WINDOW 7 USAGE - _ PERMANENT STATE ON This command defines an X.25 PVC called X25-ANDIES with a logical channel number of 3 on the local DTE with address 123789456 on network PSDND. The circuit has a maximum packet size of 1024 bytes and a maximum window size of 7. NCP>DEFINE CIRCUIT X25-DLM-0 NUMBER 456789012 NETWORK PSDNA - _ USAGE OUTGOING STATE ON This command defines a DLM SVC called X25-DLM-0 connected to the remote DTE on network PSDNA with address 456789012, and used for outgoing calls. NCP>DEFINE CIRCUIT X25-DLM-1 NUMBER 12345677 NETWORK PSDNB - _ USAGE INCOMING STATE ON This command defines a DLM SVC called X25-DLM-1 on network PSDNB that accepts only incoming calls from the remote DTE with address 12345677. NCP>SET CIRCUIT DMC-* COST 5 This command sets the circuit cost to 5 for all DMC circuits in the volatile database. ! 2 EXECUTOR Use the SET EXECUTOR command to create or modify parameters in the volatile database which controls the network on the executor node. After the executor node's state is set to ON, you cannot change its ADDRESS, ALIAS NODE, BUFFER SIZE, SEGMENT BUFFER SIZE, MAXIMUM BROADCAST ROUTERS, NAME, TYPE or MAXIMUM CIRCUITS parameters. 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 ...) DEFINE All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 3 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. 3 ADDRESS node-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. 3 ALIAS_INCOMING option 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. 3 ALIAS_MAXIMUM_LINKS number 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. 3 ALIAS_NODE node-id 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. 3 AREA_MAXIMUM_COST number 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. 3 AREA_MAXIMUM_HOPS number 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. 3 BROADCAST ROUTING TIMER seconds 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 180. 3 BUFFER SIZE number Specifies in bytes the size of the receive buffers, thereby controlling the maximum size of NSP message segments that can be received and forwarded. The size includes protocol overhead down to and including the End Communication layer, but does not include the Data Link layer overhead. This buffer size applies to all circuits known to the executor. The default value is equal to the value of the SEGMENT BUFFER SIZE, if specified; otherwise the default is 576. The value of the BUFFER SIZE parameter must be greater than or equal to the value of the SEGMENT BUFFER SIZE parameter. The two values are normally equal but may differ to permit the network manager to alter buffer size on all nodes without interruption of service. Refer to the DECnet for OpenVMS Networking Manual for information about how to modify buffer sizes. 3 COUNTER TIMER seconds Specifies a timer whose expiration causes a line counter logging event. 3 DEFAULT ACCESS option Assigns the default access to all nodes which do nothave 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. If you have OPER privilege on the local system, you can override the default access restriction specified in this parameter. 3 DELAY_FACTOR number 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. 3 DELAY_WEIGHT number 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. 3 DNS_INTERFACE option Specifies whether the local node will obtain node and address information from the DECdns namespace to update the node information in the volatile database. For information about using an existing DECdns namespace for node-name-to-address mapping, see DECnet for OpenVMS Networking Manual. There are two options: ENABLED Enables the use of the DECdns namespace, which must already exist, for updating the volatile node database. DISABLED Specifies that the node will not use DECdns namespace to search for node name and address information. Only the local node database is searched for this information. This is the default. 3 DNS_NAMESPACE string Specify this parameter if you want to use the DNS INTERFACE. Specifies an existing DECdns namespace used by the DNS interface. If DNS INTERFACE is ENABLED and you omit the DNS NAMESPACE parameter, DECnet for OpenVMS uses the default DECdns namespace for node name and address lookups. This string value must be 1 to 256 alphanumeric characters, and can include the dollar sign ($), underscore (_), and hyphen (-) characters. 3 IDENTIFICATION string Specifies 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. 3 IDP string Specify this parameter if you want to use the DNS INTERFACE. Specifies the IDP of the network's network service access point (NSAP) (global network address). This is a string of 1 to 22 hexadecimal digits. The default is 49. 3 INACTIVITY TIMER seconds Specifies the maximum duration ofinactivity (no data in either direction) on a logical link before the node checks to see if the logical link still works. The range is between 1 and 65,535. If you do not specify this parameter, the default value is 60. 3 INCOMING_PROXY option 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. Instead, validates the logical link by using the access control information associated with the object. ENABLED Invokes the appropriate proxy, based on the source user, source node, and supplied access control information (if any). This is the default. Note that proxy access characteristics established in the object database take preference over the proxy access characteristics established in the executor database. 3 INCOMING_TIMER seconds Specifies the maximum amount of elapsed time 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. The default is 45. 3 MAXIMUM_ADDRESS number Indicates the largest node address and, consequently, the greatest number of nodes within an area that can be addressed by the local node. The default is 1023. 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. (Use the System Generation Utility (SYSGEN) to change the NPAGEDYN parameter.) 3 MAXIMUM_AREA number 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. 3 MAXIMUM_BROADCAST_NONROUTERS number 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 1 to 1023. The default is 64. 3 MAXIMUM_BROADCAST_ROUTERS number Specifies the maximum total number of routers the executor node can have on its broadcast circuits. The value of this parameter should be obtained by multiplying 32 by the value of the executor MAXIMUM CIRCUITS parameter. The default is 32. 3 MAXIMUM_BUFFERS number Specifies the maximum number of buffers in the transmit buffer pool. DECnet normally allocates only what it needs. At minimum, use a value that is 15 times the square root of the number of lines. Increase this value if you experience congestion loss. The default value is 100. 3 MAXIMUM_CIRCUITS number Specifies the maximum number of circuits that the local node can use. Number must be in the range 1 to 127. The default value is 16. 3 MAXIMUM_COST number 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 1022. The default is 1022. 3 MAXIMUM_DECLARED_OBJECTS number Specifies the maximum number of objects that all processes on a system may declare. To determine the current number of declared objects on your system, use the NCP SHOW KNOWN OBJECTS command. Each of the objects with a PID displayed is one declared object. A single process can declare more than one object. You must provide a sufficient number of objects for the network servers to be intialized. The default is 31, which is sufficient for most configurations. The value range of objects is 8 to 16383. Dynamically setting the number lower than the number of declared objects currently in use has no effect on those objects. 3 MAXIMUM_HOPS number 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 30, and be sure that this value is less than or equal to the MAXIMUM VISITS parameter. The default value is 30. 3 MAXIMUM_LINKS number Specifies the maximum number of logical links for the local node. The maximum value for MAXIMUM LINKS is 3885. The default value of MAXIMUM LINKS is 32. 3 MAXIMUM_PATH_SPLITS number Indicates the maximum number of equal cost paths to a given destination node among which the packet load may be split. The default is 1. The range is from 1 to 31. 3 MAXIMUM_VISITS number 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 MAXIMUM HOPS parameter to 63. You should specify a number that is twice the MAXIMUM HOPS value. The default is 63. 3 NAME node-name Specifies the node name to be associated with the executor node. You can assign only one name to a node address or node identification. 3 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. (Do not use the TELL prefix with the SET EXECUTOR NODE command.) 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. 4 ACCOUNT account Identifies the user's account for access control verification at the designated executor node. 4 NODE node-spec Specifies a node name or address optionally followed by access control information as specified for OpenVMS. Use one of the following formats: node-id node-id"user password account" 4 PASSWORD password Identifies the user's password for access control verification at the designated executor node. 4 USER user-id Identifies the user's ID for access control verification at the designated executor node. 4 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, and your network is not composed of multiple areas.) The second command resets the executor to the local node. NCP>SET EXECUTOR NODE 2.14"JOHNSON MYPWD" This command uses access control information to set the executor node to node 2.14. NCP>SET EXECUTOR NODE TRNTO USER JOHNSON PASSWORD MYPWD This command uses an alternate access control format to set the executor to node TRNTO. $ DEFINE NODE$MY TRNTO"""JOHNSON MYPWD""" $ RUN SYS$SYSTEM:NCP NCP>SET EXECUTOR NODE NODE$MY The first command defines a logical name (NODE$MY) for the given node-spec. When running NCP, you can use this logical name with the SET EXECUTOR NODE command. Note that you must use three sets of quotation marks to delimit access control information (if supplied) in the node-spec. 3 NONPRIVILEGED item Specifies nonprivileged inbound access control information for the node. The following items can be specified: ACCOUNT account Identifies the account for default nonprivileged DECnet account on the executor node. PASSWORD password Identifies the password for default nonprivileged DECnet account on the executor node. USER user-id Identifies the user name for default nonprivileged DECnet account on the executor node. 3 OUTGOING_PROXY option 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. This is default. 3 OUTGOING_TIMER seconds Specifies a time out value for the elapsed time between the moment a connection is requested and the moment that connection is acknowledged by the destination node. A value in the range of 30 to 60 seconds is recommended. The default is 60. 3 PATH SPLIT POLICY 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 destination nodes must support out-of-order packet caching (supported by DECnet-VAX Version 4.6 or higher); otherwise, network performance may suffer. This is the default value for PATH SPLIT POLICY. 3 PIPELINE QUOTA quota Specifies the maximum number of bytes of nonpaged pool that DECnet will use for transmission over logical links. Use this parameter for buffering at the NSP level. For satellite communications, a value of 6000 or greater is recommended. 3 PRIVILEGED item Specifies privileged inbound access control information for the node. The following items can be specified: ACCOUNT account Identifies the account for default privileged DECnet account on the executor node. PASSWORD password Identifies the password for default privileged DECnet account on the executor node. USER user-id Identifies the user name for default privileged DECnet account on the executor node. 3 RETRANSMIT FACTOR number Defines the maximum number of times any given message (except a connect initiate message) will be retransmitted before the logical link is disconnected. The default value is 10. 3 ROUTING TIMER seconds Specifies the maximum amount of elapsed time before a routing update is forced on non-broadcast circuits. The routing update produces a routing configuration message for each adjacent node. You can use a number in the range of 1 to 65535. The default value is 600. 3 SEGMENT BUFFER SIZE number 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.) The default value is equal to the value of the BUFFER SIZE if specified; otherwise the default is 576. The value of the SEGMENT BUFFER SIZE parameter must be less than or equal to the value of the BUFFER SIZE parameter. The two values are normally equal but may differ to permit the network manager to alter buffer size on all nodes without interruption of service. Refer to the DECnet for OpenVMS Networking Manual for information about how to modify buffer sizes. 3 STATE node-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 disconnected. 3 SUBADDRESS range Applies only to DLM circuits. Specifies a range of local DTE subaddresses that the Routing Layer will accept as X.25 DLM calls. VAX P.S.I. will route all incoming X.25 calls within the specified subaddress range to the Routing Layer to be handled as DLM calls. 3 TYPE node-type Indicates the type of the executor node. Possible node types are: ROUTING IV NONROUTING IV AREA A ROUTING IV node has full routing capability. A NONROUTING IV 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 within its own area and between areas. 3 Examples NCP>SET EXECUTOR ALL This command loads all permanent database entries stored for the local node into the volatile database. NCP>SET EXECUTOR ADDRESS 2.11 This command sets the executor node's address to 2.11. (The executor must be in the OFF state to set the ADDRESS parameter.) NCP>SET EXECUTOR STATE ON This command sets the executor node's operational state to ON. NCP>SET NODE 2.13 NAME BIRDY NCP>SET EXECUTOR ALIAS NODE BIRDY The SET NODE command establishes a node address 2.13 with the associated node name BIRDY. The SET EXECUTOR ALIAS NODE command then establishes the node name BIRDY as the alias node identifier. (The executor must be in the OFF state to set the ALIAS NODE parameter.) NCP>SET EXECUTOR ALIAS INCOMING ENABLED This command specifies that incoming connect requests directed to the alias node identifier are permitted. NCP>DEFINE EXECUTOR NAME ROBIN This command defines the executor node's name to ROBIN in the permanent database. ! 2 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 ! 2 LINE Use the SET LINE command to create or modify line parameters in the volatile database on the executor node. Most parameters cannot be SET when the line is in the ON state. However, the COUNTER TIMER, STATE and SERVICE TIMER parameters can be changed when the line is ON. SET KNOWN LINES (parameters ...) LINE line-id Use the DEFINE LINE command to create or modify line parameters in the permanent database on the executor node. DEFINE KNOWN LINES (parameters ...) LINE line-id All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 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. 3 BUFFER SIZE number 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 up to 65,535 for non-broadcast lines. For broadcast lines, BUFFER SIZE should not be raised to a value higher than 1498 bytes. For Ethernet and FDDI lines, the value of 1498 bytes is provided as the default. 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 X.25 lines. You can use BUFFER SIZE to increase the size of NSP messages for logical links over this line. 3 CLOCK clock-mode Applies only to synchronous DDCMP lines. Specifies the hardware clock mode for the line. The values for clock-mode are: INTERNAL For use of the clock in test mode. Setting this value causes the line device to supply a clock signal that will allow all transmitted messages to 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. 3 CONTROLLER mode Specifies the controller mode for the line. There are two possible modes: LOOPBACK Internal device loopback mode. Note that not all devices support this mode. NORMAL Normal operating mode, which is the default. 3 COUNTER TIMER seconds Specifies a timer whose expiration causes a line counter logging event. Specify a decimal integer up to a maximum of 65,535. 3 DEAD TIMER milliseconds Applies only to DDCMP CONTROL lines. Specifies the number of milliseconds between polls of one of the set of dead tributaries. The milliseconds value must be a decimal integer up to a maximum of 65,535. The default is 10000 (10 seconds). 3 DELAY TIMER milliseconds Applies only to DDCMP CONTROL lines. Specifies the minimum number of milliseconds to delay between polls. This timer limits the effect of a very fast control station to slower tributaries. The milliseconds value must be a decimal integer up to a maximum of 65,535. If not set, there is no delay. 3 DUPLEX Applies to DDCMP lines. Specifies the hardware duplex mode of the line. There are two possible modes: HALF Half-duplex FULL Full-duplex (default) 3 ECHO_DATA hex_byte Applies only to FDDI lines. Specifies the byte consisting of two hexadecimal digits used as data in an echo request frame. The size of the frame is determined by the ECHO LENGTH parater. The frame is sent to the address specified by the ECHO TARGET parameter. 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. 3 ECHO_LENGTH number Applies only to FDDI lines. Specifies the number of bytes used in an echo request frame. The hexadecimal bytes are specified by the ECHO DATA parameter. The frame is sent to the address specified by the ECHO TARGET parameter. The number 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. 3 ECHO TARGET p-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. 3 HANGUP option Applies only to asynchronous DDCMP lines. Indicates whether the modem signals are dropped when the line is shut down. Possible values are: ENABLED Indicates that modem signals should be dropped when the line is shut down. DISABLED Indicates that modem signals should not be dropped when the line is shut down. This is the default for static asynchronous DDCMP lines. This parameter is supplied automatically for dynamic asynchronous DDCMP lines. The default is HANGUP ENABLED if the /HANGUP qualifier was specified for the DCL command SET TERMINAL, and HANGUP DISABLED if /NOHANGUP was specified. 3 HOLDBACK TIMER milliseconds Applies only to X.25 lines. Specifies the maximum delay before this X.25 software acknowledges successful receipt of data. If you do not specify this parameter, then the acknowledgment is sent immediately. If you specify a holdback timer, performance may be improved by allowing the acknowledgment to be included with a subsequent data message transmitted. This parameter cannot be set to a value larger than one half the value of the RETRANSMIT TIMER parameter. 3 INTERFACE code Applies only to X.25 lines and the ISO8208 profile. Specifies the way in which the processor acts when it 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. 3 KNOWN LINES Indicates that the specified parameters for all known lines are to be created or modified in the database. 3 LINE line-id Identifies the line for which specified parameters are to be created or modified in the database. 3 LINE SPEED speed Applies only to asynchronous DDCMP lines. Specifies the speed of the line in baud. This parameter must be set to the same value on both sides of the asynchronous DDCMP connection. It is specified automatically for dynamic asynchronous DDCMP lines. If not specified, the vlaue of this parameter is equal to the current speed of the line. 3 MAXIMUM_BLOCK number Applies only to X.25 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) command. 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. See the Public Network Information manual for a network value of this parameter. 3 MAXIMUM_RETRANSMITS number Applies only to X.25 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. See the Public Network Information manual for the network value of this parameter. 3 MAXIMUM_WINDOW number Applies only to X.25 lines. Specifies the maximum number of frames for which outstanding acknowledgments are allowed. Specify a value up to a maximum of 127. By default window size takes the value specified by the PROFILE parameter of the SET or DEFINE MODULE X25-PROTOCOL command. See the Public Network Information manual for the network value of this parameter. 3 MICROCODE DUMP file-spec Applies only to X.25 lines. Dumps the microcode of the specified KMS-11, KMS1P, or KMV1A device to the indicated file. By default, the output file takes the format: SYS$ERRORLOG: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. Refer to the VAX P.S.I. Problem Solving Guide for more information about PSIKDA. 3 NETWORK net-name Applies only to X.25 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. 3 NIF TARGET p-address Applies only to FDDI lines. Specifies the address to which the next Neighborhood Information Frame (NIF) request frame will be sent. The default 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. 3 PROTOCOL protocol-name Specifies the Data Link protocol to be used on this line. The following values can be used for protocol-name: DDCMP CONTROL Specifies this line as a multipoint control station. You can specify multiple circuits for CONTROL lines, but each circuit must have a unique physical tributary address. DDCMP DMC Specifies that this line is in DMC emulator mode. DMC is similar to POINT, except that DMC uses an older version of DDCMP (Version 3.2). This protocol should be set for the local line when the remote line is a DMC. Note that this protocol is valid only when a DMP11 or DMV11 is being used. DDCMP POINT Specifies this line as one of a point-to-point DDCMP connection. You can specify only one circuit per POINT line. DDCMP TRIBUTARY Specifies that this line is a tributary end of a DDCMP multipoint group. You may specify only one circuit per TRIBUTARY line. ETHERNET Specifies that this line uses the Ethernet protocol. FDDI Specifies that this line uses the FDDI protocol. LAPB Specifies that this line uses the X.25 level 2 protocol. The line must be a line for the X25-PROTOCOL module. LAPBE Specifies that this line uses the X.25 level 2 protocol with extended sequencing. The line must be used by the X25-PROTOCOL module. Default line protocols are based on line names. See HELP PARAMETERS DEVICE-TYPE for a list of circuit and line devices. 3 RECEIVE BUFFERS number Specifies the length of the line's receive queue. Use a number in the range of 1 to 32. 3 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. 3 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. 3 RETRANSMIT TIMER milliseconds Applies only to DDCMP and X.25 lines. For a DDCMP multipoint line, specifies the maximum amount of time allowed to elapse before a retransmission is necessary. 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 value is the network default. 3 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 stations on your ring do not conform to the FDDI specification. Except for that case, it should be left ON for improved ring reliability. 3 SCHEDULING TIMER milliseconds Applies only to DDCMP CONTROL lines. Specifies the number of milliseconds between re-calculation of tributary polling priorities. The number of milliseconds must be a decimal integer up to a maximum of 65,535. The default is 50. 3 SERVICE TIMER milliseconds Does not apply to X.25 lines. Specifies the maximum amount of time allowed to elapse before a receive request completes while performing service operations on a line. Milliseconds must be a decimal integer from 1 to 65,535. The default value is 4000 (4 seconds). 3 SIF_CONFIGURATION_TARGET p-address Applies only to FDDI lines. Specifies the address to which the a Status Information Frame (SIF) configuration request frame will be sent. The default 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. 3 SIF_OPERATION_TARGET p-address Applies only to FDDI lines. Specifies the address to which a Status Information Frame (SIF) operation request frame will be sent. The default 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. 3 STATE line-state Specifies the line's operational state. There are three possible line 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. 3 STREAM TIMER milliseconds Applies only to DDCMP CONTROL lines. Specifies the number of milliseconds a tributary or half duplex remote station is allowed to hold the line. The number of milliseconds must be a decimal integer up to a maximum of 65,535. The default is 1000 (1 second). 3 SWITCH option Applies only to asynchronous DDCMP lines. Resets a line currently being used as a DECnet asynchronous communications line back to a terminal line. The two values of the option are: ENABLED The line is switched to a terminal line after it is disconnected from the network (when the channel to the network is deassigned). This is the default for dynamic lines. DISABLED The line is not switched to a terminal line. This is the default for static lines. 3 TRANSMIT PIPELINE number Applies only to DMR11 lines. Specifies the maximum number of DDCMP messages for which outstanding acknowledgments are allowed. Specify a value in the range 1 to 32. By default, the value for outstanding DDCMP messages is 7. To avoid excessive use of system memory, do not arbitrarily set this value higher than necessary. Refer to the DECnet for OpenVMS Networking Manual for the procedure for determining an optimum TRANSMIT PIPELINE value. 3 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. 3 Examples NCP>SET KNOWN LINES ALL This command loads all permanent database entries stored for all known lines into the volatile database. NCP>SET LINE DMC-0 DUPLEX FULL STATE ON This command sets line DMC-0 to the ON state in full duplex mode. NCP>DEFINE LINE DMC-0 PROTOCOL DDCMP POINT This command defines the line protocol to DDCMP POINT for line DMC-0 in the permanent database. NCP>SET LINE DUP-1 RETRANSMIT TIMER 500 MAXIMUM - _ RETRANSMITS MAXIMUM BLOCK 133 MAXIMUM WINDOW 2 STATE ON This command sets up a line called DUP-1 that uses the LAPB protocol and has an associated DUP11-DA synchronous line interface with controller number 1. If a frame is not acknowledged within 500 milliseconds, it is retransmitted, and this operation is to be performed a maximum of 10 times. The maximum frame size is 133 bytes, and the maximum number of frames for which outstanding acknowledgments are allowed is 2. The line is operational. NCP>SET LINE KMX-0-0 MICROCODE DUMP BARRY This command dumps the microcode of the KMX to the file SYS$ERRORLOG:BARRY.DMP. NCP>SET LINE KMV-0 NETWORK PSS STATE ON This command sets up the line KMV-0 to the PSS network. NCP>SET LINE DMF-* CONTROLLER LOOPBACK This command sets the controller mode to loopback for all DMF lines. ! 2 LOGGING Use the SET LOGGING command to create or modify logging parameters in the volatile database. Use the DEFINE LOGGING command to create or modify logging parameters in the permanent database. SET KNOWN LOGGING ALL DEFINE LOGGING CONSOLE NAME prog-name LOGGING FILE STATE ON LOGGING MONITOR OFF HOLD The CIRCUIT, LINE, and NODE parameters in the following commands are for identifying specific sources of events. The SINK parameter is for identifying specific locations to log events. These source and sink parameters are optional. SET KNOWN LOGGING EVENTS event-list CIRCUIT circuit-id DEFINE LOGGING CONSOLE KNOWN EVENTS LINE line-id LOGGING FILE NODE node-id LOGGING MONITOR SINK EXECUTOR NODE node-id All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 3 ALL Indicates that all logging parameters for the specified logging components (CONSOLE, FILE, or MONITOR) are to be added to the database. 3 CIRCUIT circuit-id Identifies the circuit to which the events apply. Events will be logged for this source. This parameter can only be used in conjunction with the EVENTS or KNOWN EVENTS parameters. 3 CONSOLE Indicates that the parameters for logging to the console are to be added to the database. The default logging console is OPA0:. 3 EVENTS event-list Identifies the class and types of events to be added to the database. See HELP EVENTS for a list of valid events. The EVENTS event-list parameter may be followed by a specific source for events (using the CIRCUIT, LINE, or NODE parameters) or a specific location for logging these events (using the SINK parameter). Only one source or sink can be specified per command. 3 FILE Indicates that the parameters for logging to a file are to be added to the database. 3 KNOWN_EVENTS Indicates that all events are to be logged to the specified logging component or components. The KNOWN EVENTS parameter may be followed by a specific source for events (using the CIRCUIT, LINE, or NODE parameters) or a specific location for logging these events (using the SINK parameter). Only one source or sink can be specified per command. 3 KNOWN_LOGGING Indicates that the specified parameters for all known logging components (CONSOLE, FILE, and MONITOR) are to be added to the database. 3 LINE line-id Identifies the line to which the events apply. Events will be logged for this source. This parameter can only be used in conjunction with the EVENTS or KNOWN EVENTS parameters. 3 MONITOR Indicates that the parameters for logging to a monitor program are to be added to the database. The default logging monitor is OPCOM. 3 NAME prog-name Identifies the name of a console, file, or monitor program to which events will be logged. The logging component must be in the OFF state to SET the NAME parameter. If NAME parameter is not specified for the monitor sink, events will be sent to the default monitor, OPCOM. If NAME parameter is not specified for the console sink, events will be sent to OPA0:. 3 NODE node-id Identifies the node to which the events apply. Events will be logged for this source. This parameter can only be used in conjunction with the EVENTS or KNOWN EVENTS parameters. 3 SINK sink-name Identifies the location where the events will be logged. This parameter can only be used in conjunction with the EVENTS or KNOWN EVENTS parameters. There are two possible sink-names: NODE node-id Identifies the node at which events to be logged. EXECUTOR Identifies the executor node. If this parameter is omitted, the executor node is assumed to be the sink node affected. 3 STATE component-state Specifies the operational state of the logging component or all known logging components. There are three possible component states: HOLD The logging component is temporarily unavailable and events should be queued. OFF The logging component is unavailable for receiving events. ON The logging component is available for receiving events. 3 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>DEFINE LOGGING MONITOR LINE FZA-1 KNOWN EVENTS This command defines logging so that all events for line FZA-1 will be logged to the logging monitor the next time DECnet is restarted. NCP>SET LOGGING CONSOLE EVENTS 4.* SINK NODE LAMCHP This command causes all class 4 events to be logged on the console of the remote node LAMCHP. NCP>SET LOGGING MONITOR EVENTS 7.* This command causes all X.25-related events to be logged to OPCOM, the default monitor. NCP>SET KNOWN LOGGING ALL This command loads all permanent database entries stored for all logging components into the volatile database. 2 MODULE Introduces the various module entities. 3 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. The DEFINE MODULE CONFIGURATOR command creates or modifies the parameters of the configurator module component in the permanent database. You must specify a qualifier following the CONFIGURATOR command verb. The configurator module constructs a list of systems active on the Ethernet circuit or circuits specified. SET MOD CONFIGURATOR KNOWN CIRCUITS ALL DEFINE CIRCUIT circuit-id SURVEILLANCE control All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 4 ALL Copies the configurator module information from the permanent database into the volatile database at the local node. 4 CIRCUIT circuit-id Applies only to Ethernet circuits. Specifies that configurator information on the identified circuit is to be stored in the database. 4 KNOWN CIRCUITS Specifies that configutor information on all known Ethernet circuits is to be stored in the database. 4 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. 4 Examples NCP>SET MODULE CONFIGURATOR KNOWN CIRCUITS SURVEILLANCE ENABLED This command specifies that a list of active systems on all known Ethernet circuits is to be kept. NCP>SET CONFIGURATOR CIRCUIT MNA-0 SURVEILLANCE ENABLED This command specifies that a list of active systems on Ethernet circuit MNA-0 is to be kept. NCP>SET MODULE CONFIGURATOR KNOWN CIRCUITS ALL This command loads all permanent database entries for the configurator module into the volatile database. 3 X25-ACCESS Use the SET MODULE X25-ACCESS and DEFINE MODULE X25-ACCESS commands to associate the host node with the specified multi-host connector node for the purpose of accessing a specified X.25 network. The multi-host node connected to the specified X.25 network is an OpenVMS VAX node with VAX P.S.I. multi-host software installed. SET MODULE X25-ACCESS NETWORK net-name ALL DEFINE KNOWN NETWORKS ACCOUNT account NODE node-id PASSWORD password USER user-id All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 4 ACCOUNT account Identifies the user account for use when connecting to the multihost connector node. Specify a string of from 1 to 39 characters. By default, no account is used. 4 ALL Copies all X25-ACCESS parameters from the permanent data base into the volatile data base. Use this parameter only with the SET MODULE X25-ACCESS command. 4 KNOWN NETWORKS Identifies all known networks. 4 NETWORK net-name Identifies the network whose parameters are to be set in the data base. 4 NODE node-id Specifies the multihost connector node connected to the PSDN that you want to access. When you specify an X25-ACCESS network for the first time, this parameter is mandatory. 4 PASSWORD password Specifies the password for use by the access routines when connecting to a multihost connector node. Specify a string of from 1 to 39 characters. The default is that no password is used. 4 USER user-id Specifies the user identification for use by the access routines in connecting to the multihost connector node. Specify a string of from 1 to 16 characters. The default is that no user identification is used. 4 Examples NCP>SET MODULE X25-ACCESS NETWORK TELENET1 NODE FRED NCP>SET MODULE X25-ACCESS NETWORK PSS1 NODE GINGER These two commands allow users on the host node to access the network called TELENET1 through node FRED, and the network called PSS1 through node GINGER. NCP>SET MODULE X25-ACCESS KNOWN NETWORKS ALL This command loads all permanent database entries stored for the X25-ACCESS database into the volatile database. ! 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. The X25-PROTOCOL module contains records that identify the packet switching data networks (PSDNs) your DTE is connected to, associate your local DTE (and possibly a group name) with VAX P.S.I., and control transmission of packets. SET MOD X25-PROTOCOL DTE dte-addr NETWORK net-name dte-params DEFINE KNOWN DTES KNOWN NETWORKS SET MOD X25-PROTOCOL GROUP group-name ALL DEFINE KNOWN GROUPS DTE dte-addr NETWORK net-name NUMBER group-number TYPE BILATERAL SET MOD X25-PROTOCOL NETWORK net-name PROFILE profile-name DEFINE KNOWN NETWORKS ALL All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 4 DTE_dte-addr Identifies a local DTE. See the Public Network Information manual for the format of the DTE address. SET MOD X25-PROTOCOL DTE dte-addr NETWORK net-name dte-params DEF KNOWN NETWORKS If you have only one network set up, that network is the default for SET commands. If you have more than one network set up or if you are using a DEFINE command, then you must specify the network using either the NETWORK parameter or the KNOWN NETWORKS parameter. In any case, you must follow the DTE qualifiers with one or more of the following dte-params. 5 ALL Copies DTE parameters from the permanent database into the volatile database. Use this parameter only with the SET MODULE X25-PROTOCOL command. 5 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. See the Public Network Information manual for the network value of this parameter. 5 CHANNELS list Specifies a list of logical channel numbers (LCNs) reserved for outgoing calls. The list can consist of one or more LCNs. Separate multiple channel numbers with hyphens to indicate ranges and with commas to indicate individual numbers. Specify a value in the range 0 to 4095 for each LCN. If a DTE is to make outgoing calls, this parameter is mandatory when you specify a DTE for the first time. The LCN range at the DTE is defined by PSDN authorities at subscription time. 5 CLEAR TIMER seconds Specifies a timer that starts when a request to clear an X.25 virtual circuit is transmitted, and whose termination 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 PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 COUNTER TIMER seconds Sets a timer whose expiration causes a DTE counter logging event. Specify a decimal integer in the range 1 to 65,535. 5 DEFAULT_DATA bytes Specifies the default packet size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 DEFAULT_WINDOW number Specifies the default window size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 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. 5 INTERRUPT TIMER seconds 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. 5 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. 5 MAXIMUM_CIRCUITS count Specifies the maximum number of circuits for the DTE. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_CLEARS count Specifies the maximum number of attempts to clear an X.25 virtual circuit. Specify a value in the range 1 to 255. By default the value is the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_DATA bytes Specifies the maximum packet size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_RESETS count Specifies the maximum number of attempts to reset an X.25 virtual circuit. If this number is exceeded, the virtual circuit will be cleared. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_RESTARTS count Specifies the maximum number of attempts to restart an X.25 virtual circuit. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_WINDOW count Specifies the window size allowed for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 RESET TIMER seconds 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. See the Public Network Information manual for the network value of this parameter. 5 RESTART TIMER seconds 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. See the Public Network Information manual for the network value of this parameter. 5 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. This is the default state. SHUT The DTE is to be closed down and a reset is sent. Use only with the SET MODULE X25-PROTOCOL command. !end of DTES 4 GROUP_group_name Identifies a closed user group (CUG) or bilateral closed user group (BCUG). SET MOD X25-PROTOCOL GROUP group-name ALL DEFINE DTE dte-addr NETWORK net-name NUMBER group-number TYPE BILATERAL Each group specified should have a unique group-name from 2 to 16 characters long. You must follow the GROUP qualifiers with one or more of the following group parameters. 5 ALL Copies the group parameters from the permanent data base into the volatile data base. Used only with the SET MODULE X25-PROTOCOL command. 5 DTE dte-addr Identifies the local DTE associated with the group name. This parameter is mandatory when creating a group. 5 NETWORK net-name Identifies a network to which the DTE is connected. This parameter is mandatory when you are creating a group. 5 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 you are associating a DTE with a group. 5 TYPE BILATERAL Specifies the user group as a BCUG. Omit this parameter if the user group is a CUG. This parameter is mandatory when you are associating a DTE with a BCUG. !end of group parameters 4 KNOWN_DTES Refers to all known DTEs. SET MOD X25-PROTOCOL KNOWN DTES NETWORK net-name dte-params DEF KNOWN NETWORKS If you have only one network set up, that network is the default for SET commands. If you have more than one network set up or if you are using a DEFINE command, then you must specify the network using either the NETWORK parameter or the KNOWN NETWORKS parameter. In any case, you must follow the KNOWN DTES qualifier with one or more of the following dte params. 5 ALL Copies DTE parameters from the permanent database into the volatile database. Use this parameter only with the SET MODULE X25-PROTOCOL command. 5 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. See the Public Network Information manual for the network value of this parameter. 5 CHANNELS list Specifies a list of logical channel numbers (LCNs) reserved for outgoing calls. The list can consist of one or more LCNs. Separate multiple channel numbers with hyphens to indicate ranges and with commas to indicate individual numbers. Specify a value in the range 0 to 4095 for each LCN. If a DTE is to make outgoing calls, this parameter is mandatory when you specify a DTE for the first time. The LCN range at the DTE is defined by PSDN authorities at subscription time. 5 CLEAR TIMER seconds Specifies a timer that starts when a request to clear an X.25 virtual circuit is transmitted, and whose termination 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 PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 COUNTER TIMER seconds Sets a timer whose expiration causes a DTE counter logging event. Specify a decimal integer in the range 1 to 65,535. 5 DEFAULT_DATA bytes Specifies the default packet size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 DEFAULT_WINDOW number Specifies the default window size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 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. 5 INTERRUPT TIMER seconds 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. 5 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. 5 MAXIMUM_CIRCUITS count Specifies the maximum number of circuits for the DTE. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_CLEARS count Specifies the maximum number of attempts to clear an X.25 virtual circuit. Specify a value in the range 1 to 255. By default the value is the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_DATA bytes Specifies the maximum packet size for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_RESETS count Specifies the maximum number of attempts to reset an X.25 virtual circuit. If this number is exceeded, the virtual circuit will be cleared. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_RESTARTS count Specifies the maximum number of attempts to restart an X.25 virtual circuit. Specify a value in the range 1 to 255. By default, the count takes the network value specified by the PROFILE parameter. See the Public Network Information manual for the network value of this parameter. 5 MAXIMUM_WINDOW count Specifies the window size allowed for X.25 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. See the Public Network Information manual for the network value of this parameter. 5 RESET TIMER seconds 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. See the Public Network Information manual for the network value of this parameter. 5 RESTART TIMER seconds 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. See the Public Network Information manual for the network value of this parameter. 5 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. This is the default state. SHUT The DTE is to be closed down and a reset is sent. Use only with the SET MODULE X25-PROTOCOL command. !end of DTES 4 KNOWN_GROUPS Specifies all known groups. SET MODULE X25-PROTOCOL KNOWN GROUPS ALL DEFINE DTE dte-addr NETWORK net-name NUMBER group-number TYPE BILATERAL Each group specified should have a unique group-name from 2 to 16 characters long. You must follow the KNOWN GROUPS qualifier with one or more of the following group parameters. 5 ALL Copies the group parameters from the permanent data base into the volatile data base. Used only with the SET MODULE X25-PROTOCOL command. 5 DTE dte-addr Identifies the local DTE associated with the group name. This parameter is mandatory when creating a group. 5 NETWORK net-name Identifies a network to which the DTE is connected. This parameter is mandatory when you are creating a group. 5 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 you are associating a DTE with a group. 5 TYPE BILATERAL Specifies the user group as a BCUG. Omit this parameter if the user group is a CUG. This parameter is mandatory when you are associating a DTE with a BCUG. !end of group parameters 4 KNOWN_NETWORKS Identifies all known networks. You must also specify the PROFILE or the ALL parameter. SET MODULE X25-PROTOCOL KNOWN NETWORKS PROFILE profile-name DEFINE ALL 5 ALL Copies the network parameters from the permanent data base into the volatile data base. Use only with the SET MODULE X25-PROTOCOL command. 5 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. Refer to the Public Network Information manual for the valid profile-name. 4 NETWORK_net-name Identifies a network. You must also specify the PROFILE or the ALL parameter. SET MOD X25-PROTOCOL NETWORK net-name PROFILE profile-name DEF ALL 5 ALL Copies the network parameters from the permanent data base into the volatile data base. Use only with the SET MODULE X25-PROTOCOL command. 5 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. Refer to the Public Network Information manual for the valid profile-name. ! end of network parameters 4 Examples NCP>SET MODULE X25-PROTOCOL DTE 123789456 NETWORK TELENET - _ CHANNELS 20-10,3,9 LINE DUP-0 MAXIMUM CIRCUITS 400 STATE ON This command creates a record for your local DTE (DTE address 123789456) and associates a line DUP-0 and a set of logical channels with this DTE. NCP>SET MODULE X25-PROTOCOL NETWORK NET1 PROFILE PSDNC This command specifies that you are going to use PSDNC, and that you are going to connect to this PSDN through the network NET1. NCP>SET MODULE X25-PROTOCOL GROUP ESECUG DTE 123789456 - _ NETWORK NET1 NUMBER 12 This command specifies that your DTE is a member of closed user group ESECUG with group number 12. ! 3 X25-SERVER Use the SET MODULE X25-SERVER and SET MODULE X29-SERVER commands to create or modify the parameters of the X.25 or X.29 Call Handler in the volatile data base. Use the DEFINE MODULE X25-SERVER and DEFINE MODULE X29-SERVER commands to create or modify the parameters of the X.25 or X.29 Call Handler in the permanent data base. Use separate SET/DEFINE MODULE X25-SERVER or SET/DEFINE MODULE X29-SERVER commands to specify the module parameters and the destinations. The server modules contain records that identify and specify parameters for a destination, specify a maximum number of circuits that each module (that is, all destinations for a particular module) may have, and specify the state of the module. SET MODULE X25-SERVER ALL DEFINE X29-SERVER COUNTER TIMER seconds MAXIMUM CIRCUITS count STATE ON OFF SHUT SET MODULE X25-SERVER DESTINATION dest-name dest-params DEFINE X29-SERVER KNOWN DESTINATIONS All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 4 ALL Copies the Call Handler parameters from the permanent database into the volatile database. Use only for the SET MODULE X25-SERVER command or the SET MODULE X29-SERVER command. 4 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. 4 DESTINATION_dest-name Identifies a destination. Dest-name is an id string. SET MODULE X25-SERVER DESTINATION dest-name dest-params DEFINE X29-SERVER The DESTINATION qualifier must be followed by one or more of the following dest-params: 5 ACCOUNT account Identifies the user account used in connecting to a host node for incoming calls to a destination. Specify a string of from 1 to 39 characters. By default, no account is used. 5 ALL Copies the destination parameters from the permanent database into the volatile database. Use only with the SET MODULE X25-SERVER or the SET MODULE X29-SERVER command. 5 CALL_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. 5 CALL_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. 5 CALLED ADDRESS dte-addr 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. 5 EXTENSION_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. 5 EXTENSION_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. 5 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. 5 INCOMING ADDRESS dte-addr Identifies the address of the DTE receiving the call (as specified in the call packet). 5 NETWORK net-name Specifies the network for which calls are accepted. By default, no network name is used. 5 NODE node-id Identifies the P.S.I. Access node that is to be the destination of the incoming X.25 call. Specify this parameter if the executor node is a VMS node with VAX P.S.I. software in multihost mode installed, serving as a connector node. This parameter is mandatory when you specify this destination for first time. Use only with the SET MODULE X25-SERVER or the DEFINE MODULE X25-SERVER command. 5 OBJECT object-id Identifies the object used in connecting to a host node for incoming calls to a destination. The object-id is an ID string. If the object name looks like a number, enclose the string in quotation marks. This parameter is mandatory when you specify a destination for the first time. 5 PASSWORD password Specifies the password used in connecting to a host node for incoming calls to a destination. Specify a string of from 1 to 39 characters. The default is that no password is used. 5 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. 5 RECEIVING DTE dte-addr 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. 5 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 not 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. 5 SENDING ADDRESS dte-addr Identifies the address of the remote DTE that originated the call. By default, no sending DTE is used. 5 SUBADDRESSES range Specifies the range of local DTE subaddresses that identify the destination for the incoming call. Range consists of one or two subaddresses. The subaddress is a decimal integer in the range 0 to 9999. See the Public Network Information manual for the maximum length of the subaddress for your network. 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. 5 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. 4 KNOWN DESTINATIONS Specifies all known destinations. SET MODULE X25-SERVER KNOWN DESTINATIONS dest-params DEFINE X29-SERVER The KNOWN DESTINATIONS qualifier must be followed with one or more of the following parameters: 5 ACCOUNT account Identifies the user account used in connecting to a host node for incoming calls to a destination. Specify a string of from 1 to 39 characters. By default, no account is used. 5 ALL Copies the destination parameters from the permanent database into the volatile database. Use only with the SET MODULE X25-SERVER or the SET MODULE X29-SERVER command. 5 CALL_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. 5 CALL_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. 5 CALLED ADDRESS dte-addr 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. 5 EXTENSION_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. 5 EXTENSION_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. 5 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. 5 INCOMING ADDRESS dte-addr Identifies the address of the DTE receiving the call (as specified in the call packet). 5 NETWORK net-name Specifies the network for which calls are accepted. By default, no network name is used. 5 NODE node-id Identifies the P.S.I. Access node that is to be the destination of the incoming X.25 call. Specify this parameter if the executor node is a VMS node with VAX P.S.I. software in multihost mode installed, serving as a connector node. This parameter is mandatory when you specify this destination for first time. Use only with the SET MODULE X25-SERVER or the DEFINE MODULE X25-SERVER command. 5 OBJECT object-id Identifies the object used in connecting to a host node for incoming calls to a destination. The object-id is an ID string. If the object name looks like a number, enclose the string in quotation marks. This parameter is mandatory when you specify a destination for the first time. 5 PASSWORD password Specifies the password used in connecting to a host node for incoming calls to a destination. Specify a string of from 1 to 39 characters. The default is that no password is used. 5 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. 5 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. 5 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 not 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. 5 SENDING ADDRESS dte-addr Identifies the address of the remote DTE that originated the call. By default, no sending DTE is used. 5 SUBADDRESSES range Specifies the range of local DTE subaddresses that identify the destination for the incoming call. Range consists of one or two subaddresses. The subaddress is a decimal integer in the range 0 to 9999. See the Public Network Information manual for the maximum length of the subaddress for your network. 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. 5 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. 4 MAXIMUM CIRCUITS count Specifies the maximum number of circuits that the module (that is, all destinations) may have. By default, the maximum is 512. 4 STATE module-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. For the X.25 server module, ON is the default state. OFF The module is not in use. For the X.29 server module, OFF is the default state. 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. 4 Examples NCP>SET MODULE X25-SERVER DESTINATION JOE SUBADDRESSES 12-24 - _ SENDING ADDRESS 987321654 PRIORITY 3 OBJECT OBJONE This command creates a destination called JOE that will handle incoming X.25 calls from a DTE with an address of 987321654 and a subaddress in the range 12 to 24 specified in the DECnet object database. NCP>SET MODULE X25-SERVER DESTINATION DEFDES OBJECT LAST - _ PRIORITY 0 This command modifies the destination called DEFDES that will handle any incoming calls. The destination has the lowest priority and will only handle calls that fail to find another destination. NCP>SET MODULE X25-SERVER DESTINATION THRUSH - _ SUBADDRESSES 11-20 OBJECT 36 NODE THRUSH This command creates a destination called THRUSH for node THRUSH that will match incoming X.25 calls with a subaddress in the range 11 to 20. This command is used if the executor node is a VMS node with VAX P.S.I. software in multihost mode installed, serving as a connector node. Object 36 is the object number for VAX P.S.I. Access on the remote node. 3 X29-SERVER Use the SET MODULE X29-SERVER and SET MODULE X25-SERVER commands to create or modify the parameters of the X.29 or X.25 Call Handler in the volatile data base. Use the DEFINE MODULE X29-SERVER and DEFINE MODULE X25-SERVER commands to create or modify the parameters of the X.29 or X.25 Call Handler in the permanent data base. Use separate SET/DEFINE MODULE X29-SERVER or SET/DEFINE MODULE X25-SERVER commands to specify the module parameters and the destinations. The server modules contain records that identify and specify parameters for a destination, specify a maximum number of circuits that each module (that is, all destinations for a particular module) may have, and specify the state of the module. SET MODULE X29-SERVER ALL DEFINE X25-SERVER COUNTER TIMER seconds MAXIMUM CIRCUITS count STATE ON OFF SHUT SET MODULE X29-SERVER DESTINATION dest-name dest-params DEFINE X25-SERVER KNOWN DESTINATIONS Please refer to help on SET MODULE X25-SERVER for more details. ! 2 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 ...) DEFINE NODE node-id All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 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. 3 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. 3 ADDRESS node-address Specifies the address of the node to which you want the database entry to refer. 3 CIRCUIT circuit-id Identifies a loop node and specifies the identification of the circuit to be used for all traffic to the loop node. 3 COUNTER TIMER seconds Specifies a timer whose expiration causes a node counter logging event. Seconds must be a decimal integer from 1 to 65,535. 3 CPU cpu-type Identifies the node's CPU type. There are four valid types: DECSYSTEM1020 PDP11 PDP8 VAX 3 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. 3 DUMP_ADDRESS number Identifies the address in memory to begin an upline dump of the adjacent node. 3 DUMP_COUNT number Specifies the default number of memory units to upline dump from the the adjacent node. 3 DUMP_FILE file-spec Identifies which file to write to when the adjacent node is dumped upline. 3 HARDWARE ADDRESS h-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. 3 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. 3 INBOUND node-type Required for nodes when the VERIFICATION INBOUND parameter is specified for the DDCMP 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. 3 KNOWN NODES Indicates that the specified parameters for all known nodes are to be created or modified in the database. 3 LOAD_ASSIST_AGENT file-spec Specifies the VMS image that will define the system software for downline loading and adjacent node. The load assist agent can be used to tailor the system software to be loaded. The LOAD ASSIST AGENT parameter applies to downline load operations to Local Area VAXclusters only. 3 LOAD_ASSIST_PARAMETER item Specifies a parameter to be passed to a load assist agent. The LOAD ASSIST PARAMETER value applies to downline load operations to Local Area VAXclusters only. 3 LOAD_FILE file-spec Specifies a file containing the system software for downline loading to an adjacent node. 3 MANAGEMENT FILE file-spec Specifies a file containing management information for downline loading to an adjacent node. 3 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. 3 NODE node-id Identifies the node (local or remote) for which specified parameters are to be created or modified in the database. 3 NONPRIVILEGED item Specifies nonprivileged inbound access control information for the node. Associate any of the following parameters with the NONPRIVILEGED parameter: ACCOUNT account Identifies the account for the default nonprivileged DECnet account on the designated node. PASSWORD password Identifies the password for the default nonprivileged DECnet account on the designated node. USER user-id Identifies the user name for the default nonprivileged DECnet account on the designated node. 3 PRIVILEGED item Specifies privileged inbound access control information for the node. Associate any of the following parameters with the PRIVILEGED parameter: ACCOUNT account Identifies the account for the default privileged DECnet account on the designated node. PASSWORD password Identifies the password for the default privileged DECnet account on the designated node. USER user-id Identifies the user name for the default privileged DECnet account on the designated node. 3 RECEIVE PASSWORD hex-password Defines the password (1-8 characters) that is expected from the remote node during a Routing initialization sequence. Use this parameter only if verification is enabled or set to INBOUND for the circuit. 3 SECONDARY LOADER file-spec Specifies a file containing the secondary boot loader for downline loading to an adjacent node. 3 SERVICE_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. 3 SERVICE_DEVICE device-type Identifies the target node's line controller for the service circuit over which the operation is to take place. See HELP PARAMETERS DEVICE-TYPE for a list of circuit and line devices. Only the synchronous port on the DMF service device may be used. 3 SERVICE_NODE_VERSION version Specifies the DECnet for OpenVMS 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. 3 SERVICE_PASSWORD hex-password Identifies 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. 3 SOFTWARE_IDENTIFICATION software-id Is the ID of the software to be downline loaded. You include this parameter only if the SOFTWARE TYPE parameter is specified. 3 SOFTWARE_TYPE software-type Identifies a particular file type to be loaded. There are four possibilities: MANAGEMENT FILE SECONDARY LOADER TERTIARY LOADER SYSTEM 3 TERTIARY LOADER file-spec Specifies a file containing a tertiary boot loader for downline loading to an adjacent node. 3 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. This parameter is used only if the VERIFICATION parameter has been set to ENABLED or INBOUND for the circuit. 3 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 and that the network is not divided into multiple areas. NCP>SET NODE LARK HARDWARE ADDRESS 08-00-2B-34-55-FF This command associates with the node LARK the hardware address originally assigned to the DESVA controller at node LARK. This information in the volatile database can be used during downline loading of target node LARK over an Ethernet circuit. NCP>SET KNOWN NODES ALL This command loads all permanent database entries stored for all known nodes into the volatile database. NCP>SET NODE TESTER CIRCUIT FZA-0 This command sets the loop node name (TESTER) and identifies the circuit over which loop information is to be transmitted. ! 2 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 ...) DEFINE KNOWN OBJECTS All underscores found in parameters must be replaced with spaces when parameters are used in NCP commands. 3 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 theuser account for use by incoming X.25 calls to the object; if not specified, no account is used. 3 ALIAS_INCOMING option Does not apply to VAX P.S.I. 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 cluster wide 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. 3 ALIAS_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. 3 ALL The SET object-component ALL command to updates the volatile database with all the object parameters stored in the permanent database for a particular object or all known objects. 3 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 When you specify an object for the first time, this parameter is mandatory. 3 KNOWN OBJECTS Indicates that the specified parameters are applicable to all known objects. 3 NUMBER number Specifies the object number. Numbers 1 through 127 are for use by Digital Equipment Corporation. Numbers 0 and 128 through 255 are for customer use. See the DECnet for OpenVMS Network Management Utilities manual for a comprehensive list of reserved object numbers. When you specify an object for the first time, this parameter is mandatory. 3 OBJECT object-name Identifies the object for which specified parameters are to be created or modified in the database. 3 OUTGOING CONNECT PRIVILEGES privilege-list Specifies the privileges that a user must possess in order to make outbound connections to the object. 3 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. 3 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. 3 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 logical links using the object to request proxy login on the remote node. BOTH Allows both incoming and outgoing proxy login access. This is the default option. NONE Does not allow incoming or outgoing proxy login access. 3 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. 3 Examples NCP>SET OBJECT NML FILE NML NUMBER 19 This command sets 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. NCP>SET OBJECT OBJONE FILE OBJONE.COM NUMBER 0 USER NET - _ PASSWORD NET This command creates an object called OBJONE with a command procedure called OBJONE.COM. The incoming connection uses a password and user identification of NET. NCP>SET EXECUTOR ALIAS NODE 2.13 NCP>SET OBJECT FOX ALIAS OUTGOING ENABLED The SET EXECUTOR ALIAS NODE command establishes address 2.13 as the alias node identifier for the local node. The SET OBJECT command associates the object FOX with the alias node identifier for all outgoing connect requests. NCP>SET OBJECT T* PROXY NONE This command prevents incoming or outgoing proxy login access for all objects with names beginning with "T". NCP>SET OBJECT TEST OUTGOING CONNECT PRIVILEGES READALL OPER This command specifies that a user process must have privileges READALL and OPER in order to make an outbound connection to object TEST. !