Use the SET LINE command to create or modify line parameters in the
volatile database on the executor node. Use the DEFINE LINE command to
create or modify line parameters in the permanent data base on the
executor node.
SET KNOWN LINES (parameters ...)
LINE line-id
All underscores found in parameters must be replaced with spaces
when parameters are used in NCP commands.
1 – KNOWN LINES
Indicates that the specified parameters for all known lines are to be created or modified in the database.
2 – LINE line-id
Identifies the line for which specified parameters are to be created or modified in the database.
3 – ALL
Use the SET LINE ALL command to update the volatile copy of the database on the executor node with all the line parameters stored for a particular line in the permanent database on the executor node.
4 – BUFFER SIZE
Specifies in bytes the size of receive buffers for the specified line, thereby controlling the maximum size of NSP message segments that can be received from or forwarded to an adjacent node which has accepted the line buffer size. Use a value in the range 1 to 65,535. For broadcast lines, a default value of 1498 bytes is provided. For all other types of lines, the default is the executor BUFFER SIZE value (as specified in the SET EXECUTOR command). This parameter does not apply to X25 lines.
5 – CLOCK mode
Specifies the hardware clock mode for the line. The values for clock-mode are: INTERNAL For software controllable loopback use of the clock. This causes the line device to supply a clock signal such that all transmitted messages can be looped back from outside the device. Note that in order to use this parameter, the operator may have to connect a loopback plug in place of the normal line. EXTERNAL For normal clock operating mode. The clock signal is supplied externally to the controller.
6 – CONTROLLER
Specifies the controller mode for the line. There are two
possible modes:
LOOPBACK is the internal device
loopback mode for testing
NORMAL is the normal operating mode.
7 – COUNTER TIMER seconds
Specifies a timer whose expiration causes a line counter logging event.
8 – DEAD TIMER milliseconds
Specifies the number of milliseconds between polls of one of the set of dead tributaries. Applies only to DDCMP CONTROL lines. The default is 10000 (10 seconds).
9 – DELAY TIMER milliseconds
Specifies the minimum number of milliseconds to delay between polls. If not set, there is no delay. Applies only to DDCMP CONTROL lines.
10 – DUPLEX
Specifies the hardware duplex mode of the line. There are
two possible modes:
HALF half-duplex
FULL full-duplex
11 – ECHO
11.1 – DATA hex byte
Applies only to FDDI lines. ECHO LENGTH number of bytes of value ECHO DATA will be used to compose the next echo request frame which will be sent to the address specified by ECHO TARGET. Hex_byte must be a string of exactly two hexadecimal digits. The default ECHO DATA is 55. ECHO DATA can be set in the volatile database, but it cannot be defined in the permanent database.
11.2 – LENGTH count
Applies only to FDDI lines. ECHO LENGTH number of bytes of type ECHO DATA will be used to compose the next echo request frame which will be sent to the address specified by ECHO TARGET. Count must be a decimal value from 0 to 4478. The default ECHO LENGTH is 1. ECHO LENGTH can be set in the volatile database, but it cannot be defined in the permanent database.
11.3 – TARGET address
Applies only to FDDI lines. Specifies the address to which the next echo request frame will be sent. The default ECHO TARGET is 00-00-00-00-00-00. The ECHO TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
12 – HANGUP option
Applies only to asynchronous lines. Indicates whether the connection between the dialin node (the local node) and the remote node is to be broken when the line is turned off. Possible values are: ENABLED DISABLED For dynamic lines the value of this parameter is dependent upon whether the terminal characteristic in the DCL command SET TERMINAL was set to HANGUP or NOHANGUP. If HANGUP was specified, the default is HANGUP ENABLED; if NOHANGUP was specified, the default is HANGUP DISABLED. For static lines the default is HANGUP DISABLED.
13 – INTERFACE code
Applies only to X25 lines and the ISO8208 profile. Specifies the way in which the processor acts when uses the line. There are two values for the code: DTE specifies that the processor operates as a DTE DCE specifies that the processor operates as a DCE The default code is DTE.
14 – LINE SPEED speed
Applies only to asynchronous lines. Specifies the speed of the line. This parameter must be set to the same value on both sides of the asynchronous connection. The default is equal to the current speed of the line.
15 – MAXIMUM
15.1 – BLOCK count
Applies only to X25 lines. Specifies the maximum size in bytes of the frame for the line. This value must be at least 5 bytes larger than the maximum packet size you specify in SET CIRCUIT (for PVCs and DLM circuits) or SET MODULE X25-PROTOCOL (for SVCs). Specify a value in the range 21 to 4103. By default the size of the frame takes the value specified by the PROFILE parameter of the SET MODULE X25-PROTOCOL command.
15.2 – RETRANSMITS count
Applies only to X25 lines. Specifies the maximum number of retransmissions of a frame on the specified line. Specify a value in the range 1 to 255. By default, the retransmission value takes the network value specified by the NETWORK parameter of the SET MODULE X25-PROTOCOL command.
15.3 – WINDOW count
Applies only to X25 lines. Specifies the maximum window size allowed for the X25 circuit - that is, the maximum number of packets for which outstanding acknowledgments are allowed. Specify a value in the range 1 to 127. By default window size takes the value specified by the PROFILE parameter of the SET or DEFINE MODULE X25-PROTOCOL command.
16 – MICROCODE DUMP file-spec
Applies only to X25 lines. Dumps the microcode of the specified KMS-11/KMV-11 device to the indicated file. By default, the output file takes the format: SYS$SYSROOT:[SYSERR]file-id.DMP The KMS/KMV Dump analyzer (PSIKDA) is the utility program used to process the dump file created by the MICROCODE DUMP parameter.
17 – NETWORK net-name
Applies only to X25 lines. Specifies the network to which the line is connected. If only one network is set up, that network is the default. Otherwise the NETWORK parameter is mandatory.
18 – NIF TARGET address
Applies only to FDDI lines. Specifies the address to which the next NIF request frame will be sent. The default Neighborhood Information Frame (NIF) target is 00-00-00-00-00-00. NIF TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
19 – PROTOCOL
Specifies the line protocol for data link protocol operation. The
possible protocols are:
DDCMP CONTROL Specifies a DDCMP multipoint
control station.
DDCMP POINT Specifies a DDCMP point-to-point
line.
DDCMP TRIBUTARY Specifies a DDCMP multipoint
tributary.
DDCMP DMC Specifies a DDCMP point-to-point
line in DMC compatibility mode.
ETHERNET Specifies that the line uses the
Ethernet/IEEE 802.3 protocol.
FDDI Specifies that the line uses the
FDDI protocol.
LAPB Specifies that the line uses
the X25 level 2 protocol.
LAPBE Specifies that the line uses
the X25 level 2 protocol with
extended sequencing.
Default line protocols are based on the line names listed below:
BNA ETHERNET
CEC ETHERNET
CI No protocol specified
DMB DDCMP POINT
DMC/DMR DDCMP POINT
DMF DDCMP POINT
DMP DDCMP POINT
DMV DDCMP POINT
DSB DDCMP POINT
DSF DDCMP POINT
DSV DDCMP POINT
DSW/DW4 DDCMP POINT
DUP/DPV LAPB
EBA ETHERNET
EIA ETHERNET
ELA ETHERNET
ERA ETHERNET
ETA ETHERNET
EWA ETHERNET
FPA FDDI
FZA FDDI
ISA ETHERNET
KMV LAPB
KMX LAPB
KMY LAPB
MFA FDDI
MNA ETHERNET
MXE ETHERNET
QNA ETHERNET
SVA ETHERNET
TRA ETHERNET
TRE ETHERNET
TRP ETHERNET
UNA ETHERNET
VLA ETHERNET
20 – RECEIVE BUFFERS number
Specifies the length of the line's receive queue. Use a number in the range of 1 to 32. A value in the range of 2 to 4 is adequate for line speeds of less than 56K bits. Megabit line speeds may require 8 or more buffers depending on the observed error rate.
21 – REQUESTED TRT microseconds
Applies only to FDDI lines. Specifies the requested value for the token rotation timer in microseconds. Microseconds must be a decimal integer in the range of 4000 to 167772. The default is 8000 microseconds.
22 – RESTRICTED TOKEN TIMEOUT milliseconds
Applies only to FDDI lines. Specifies the limit on how long a single restricted mode dialog may last before being terminated. Milliseconds must be a decimal integer in the range of 0 to 10000. The default is 1000 milliseconds.
23 – RETRANSMIT TIMER milliseconds
Specifies the maximum amount of time allowed to elapse before a retransmission is necessary on a multipoint line. This is the amount of time a control station will wait for a tributary to respond. Milliseconds must be a decimal integer in the range 1 to 65535. The default is 3000.
24 – RING PURGER ENABLE option
Applies only to FDDI lines. The option values are:
ON Participate in the Ring Purger election and,
if elected, perform the Ring Purger function.
This is the default.
OFF Do not participate in the Ring Purger election.
This parameter is to allow operation when certain non-conforming
stations are on your ring; except for that case it should be
left ON for improved ring reliability.
25 – SCHEDULING TIMER milliseconds
Specifies the number of milliseconds between re-calculation of tributary polling priorities. Applies only to DDCMP CONTROL lines. The default is 50.
26 – SERVICE TIMER milliseconds
Specifies the maximum amount of time allowed to elapse before a receive request completes while doing service operations on a line.
27 – SIF
27.1 – CONFIGURATION TARGET address
Applies only to FDDI lines. Specifies the address to which the next SIF configuration request frame will be sent. The default Status Information Frame (SIF) configuration target is 00-00-00-00-00-00. SIF CONFIGURATION TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
27.2 – OPERATION TARGET address
Applies only to FDDI lines. Specifies the address to which the next SIF operation request frame will be sent. The default Status Information Frame (SIF) operation target is 00-00-00-00-00-00. SIF OPERATION TARGET can be set in the volatile database, but it cannot be defined in the permanent database.
28 – STATE
Specifies the line's operational state. There are three
possible states:
OFF The line is not in use.
ON The line is available for
normal use.
SERVICE The line is available only
for service functions.
29 – STREAM TIMER milliseconds
Specifies the number of milliseconds a tributary or half duplex remote station is allowed to hold the line. The default is 1000 (1 second).
30 – SWITCH option
Applies only to asynchronous DDCMP lines. Allow the line currently being used as a DECnet asynchronous communications line to be converted back to a terminal line. The two values of the option are: ENABLED DISABLED The default for dynamic lines is SWITCH ENABLED; the default for static lines is SWITCH DISABLED.
31 – VALID TRANSMISSION TIME microseconds
Applies only to FDDI lines. Specifies the maximum time between arrivals of a valid frame or unrestricted token. Microseconds must be a decimal integer in the range of 2500 to 5222. The default is 2621 microseconds.
32 – Examples
NCP>SET LINE DMC-0 RECEIVE BUFFERS 3 PROTOCOL DDCMP POINT STATE ON
This command sets up the first DMC-11 for normal use.
NCP>SET LINE DMC-0 STATE OFF
NCP>SET LINE DMC-0 RECEIVE BUFFERS 5 STATE ON
These two commands increase the number of receive buffers for
the first DMC-11.