Function

Parameters

nnnnn

The subscript that defines one or more lines that are affected by this command. The subscript can specify a specific numeric value or a range of values (1-65535). For information about specifying a range for this subscript, see Command syntax conventions.

AUTODISC={No|Yes}

Specifies whether this line is automatically disconnected from a terminal when the local modem disconnects.

Note:

1. You can change this parameter only if the specified line is drained.
2. If you specify AUTODISC=Y for a leased, dedicated line, you might cause serious performance problems without receiving the $HASP094 I/O ERROR message. This might also occur if a modem is disconnected or powered-off during a session or a line is started with the modem disconnected or powered-off.

CODE={A|B}

The BSC adapter code for this line. Code A refers to the first code in a BSC adapter. Code B refers to the second code in a BSC adapter that has the dual code feature. If the dual code feature is not present, do not specify CODE=B.

Note: You may change this parameter only if the specified line is drained.

COMPRESS={No|Yes}

Specifies whether this line allows BSC-attached hardware terminals to use data compression.

If you specify Y, the specification of the COMPRESS= parameter on the RMT(nnnn) initialization statement or the COMP/NOCOMP parameter on any remote device (Rnnnn.xxx) initialization statements is allowed to take affect. For example, if RMT(nnnn) specifies COMPRESS=NO, or Rnnnn.xxx specifies NOCOMP, no data compression takes place.

If you specify N, this parameter overrides the specification of the COMPRESS= parameter on the RMT(nnnn) initialization statement for any remote workstation that might use this line and the COMP/NOCOMP parameter on any remote device (Rnnnn.xxx) initialization statements.

Note:

1. Compression compatibility is standard for SNA remotes and BSC multi-leaving workstations. NJE data will always be compressed.
2. You may change this parameter only if the specified line is drained.

CONNECT=(Yes|No|DEFAULT,interval)

Specifies whether an NJE connection is automatically attempted for this line. If DEFAULT is specified, processing uses the CONNECT=(YES|NO) value that is specified on the associated NODE statement. The interval is the time (in minutes) between attempted connections. The valid range for interval is 0 to 1440. A value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.

Discon={I|INTERRUPT|No|Q|QUIESCE}

Specifies whether the line is to be disconnected immediately (I) or after it completes its current activity (Q).

I|INTERRUPT

A sign-off record is sent to the attached multi-leaving remote workstation or to the connected NJE node.

No

The line is not to be disconnected.

Q|QUIESCE

The disconnection occurs as though the remote operator or NJE node had signed off.

Note: You may change this parameter only if the specified line is not currently drained.

DUPLEX={FULL|HALF}

Specifies whether this is a half-duplex or full-duplex line.

Note: You may change this parameter only if the specified line is drained.

INTERFAC={A|B}

The BSC adapter interface for this line. A refers to the first interface in a BSC adapter; B refers to the second, which has the dual-communications interface feature. If the adapter does not have the dual-communications interface feature, do not specify INTERFAC=B.

Note: You may change this parameter only if the specified line is drained.

JRNUM=n|DEFAULT

Specifies the number (0-7) of network job receivers to be associated with this NJE line. The value of n is an integer that specifies the maximum number of input job streams allowed to be concurrently active on this line. This specification should match the value of JTNUM for this line on other nodes with which this node is to communicate directly. The sum of the values of JRNUM and SRNUM for this line must not exceed 8, or the statement is ignored.

This value overrides the default global value set by the JRNUM= parameter of the NJEDEF statement. If this value is omitted or set to DEFAULT, the value is taken from the JRNUM= parameter of NJEDEF. If omission or use of DEFAULT would result in a sum of JRNUM= and SRNUM= exceeding 8, JRNUM= is reduced so that the sum would equal 8.

JTNUM=n|DEFAULT

Specifies the number (0-7) of network job transmitters to be associated with this NJE line. The value of n is an integer that specifies the maximum number of output job streams allowed to be concurrently active on this line. This value should remain unchanged unless it is known that a particular user has some jobs with extremely large amounts of input to be transmitted and other short jobs that must be transmitted concurrently. If there are not enough receivers on the receiving node to receive jobs over the line, excess transmitters drain automatically. The sum of the values JTNUM= and STNUM= for this line must not exceed 8, or the statement is ignored.

This value overrides the default global value set by the JTNUM= parameter of the NJEDEF statement. If this value is omitted or set to DEFAULT, the value is taken from the JTNUM= parameter of NJEDEF. If omission or use of DEFAULT would result in a sum of JTNUM= and STNUM= exceeding 8, JTNUM= is reduced so that the sum would equal 8.

LINECCHR={EBCDIC|USASCII}

EBCDIC

The BSC adapter is configured for EBCDIC line-control characters.

USASCII

The BSC adapter is configured for ASCII line-control characters. If you specify USASCII, this line must be used with a 2770, 2780, or 3780 USASCII terminal.

Note: You may change this parameter only if the specified line is drained.

LOG={No|Yes}

Specifies whether JES2 is to monitor the specified line for channel-end completions (BSC lines) or SNA events (SNA lines). If you specify Y, JES2 issues a diagnostic message to the console with master level authority for each channel-end completion or SNA event detected on the specified line.

NODE=node

Specifies the NJE node name associated with this node. You can use this to determine what node to connect to when a $SN,LINE=xxx command is issued or the line is automatically connected.

Password=cccccccc

The security password, 1 to 8 alphanumeric characters, used to reject unauthorized terminals attempting to use the specified line. If you specify a null password (P=), JES2 deletes the previously-assigned password.

Note: If you specify a password for an SNA line, it is only meaningful if that line is a dedicated line. You should not specify a password for an SNA line that is used in NJE host-to-host sessions. Be certain to make a note of those passwords assigned because there is no facility for displaying the passwords in effect.

REST=nnnn

An integer (0-2000) that represents the resistance rating of the line as viewed by the installation management and coordinated with other installations. The resistance is an arbitrary value set to indicate a specific line's ability/inability to route work due to “normal” work load requirements and line speed. See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for details about resistance selection.

Note: You may change this parameter only if the specified line is drained.

RESTART=(Yes|No,interval)

Specifies whether this line is restarted if it is drained. The interval is the time (in minutes) between attempted restarts. The valid range for interval is 0 to 1440. An interval value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.

SPEED={HIGH|LOW}

Specifies whether this is a high-speed (greater than 9600 bits per second) or low-speed line.

Note:

1. This parameter is applicable only to 360/20 sub-models 2 and 4.
2. You may change this parameter only if the specified line is drained.

SRNUM=n|DEFAULT

Specifies the number (0-7) of network SYSOUT receivers to be associated with this NJE line. The value of n is an integer which specifies the maximum number of SYSOUT receiver streams allowed to be concurrently active on this line. This specification should match the value of STNUM= for this line on the other nodes with which this member is to communicate directly. The sum of the values JRNUM= and SRNUM= for this line must not exceed 8, or the statement is ignored.

This value overrides the default global value set by the SRNUM= parameter on the NJEDEF statement. If this value is omitted or set to DEFAULT, the value is taken from the SRNUM= parameter of NJEDEF. If omission or use of DEFAULT would result in a sum of SRNUM= and JRNUM= exceeding 8, SRNUM= is reduced so that the sum would equal 8.

STNUM=n|DEFAULT

Specifies the number (0-7) of network SYSOUT transmitters which will be associated with this NJE line. The value of n is an integer which specifies the maximum number of SYSOUT transmitter streams allowed to be concurrently active on this line. If there are not enough receivers on the receiving node to receive SYSOUT data over the line, excess transmitters drain automatically. The sum of the values JTNUM= and STNUM= for this line must not exceed 8, or the statement is ignored.

This value overrides the default global value set by the STNUM= parameter of the NJEDEF statement. If this value is omitted or set to DEFAULT, the value is taken from the STNUM= parameter of NJEDEF. If omission or use of DEFAULT would result in a sum of STNUM= and JTNUM= exceeding 8, STNUM= is reduced so that the sum would equal 8.

TRaceio[=NO|YES|JES=YES|NO|COMMON=YES|NO|VERBOSE=YES|NO]

Specifies whether tracing is to be active and which types of traces are to be activated for the TCP/IP line.

YES

Indicates all types of tracing are to be done.

NO

Indicates no tracing is to be done.

JES=YES|NO

Indicates whether data and control records passed between JES and TCP/IP are to be traced for this line.

COMMON=YES|NO

Indicates whether TCP/IP and other services called by IAZNJTCP are to be traced.

VERBOSE=YES|NO

Indicates whether diagnostic messages are to be issued to the master console and SYSLOG.

TRANSPAR={No|Yes}

Specifies whether the text transparency feature of the BSC adapter is present on this line. You must specify Y for NJE lines.

Note:

1. TRANSPAR=NO is valid only for EP links generated to operate as a D/T2701 without the transparency feature. For device types which require the transparency feature -- such as 2703 and CTC -- specifying TRANSPAR=NO has no effect and TRANSPAR=YES is forced.
2. You may change this parameter only if the specified line is drained.

UNIT=[devnum|/devnum|SNA][TCP|/TCPIP|TCP/IP]

Specifies a 3-digit or 4-digit hexadecimal device number for a binary synchronous communication (BSC) line. Device numbers can be specified by any of the following formats:

  UNIT=ddd
  UNIT=dddd
  UNIT=/ddd
  UNIT=/dddd

where ddd and dddd represent the device numbers.

A slash (/) can optionally precede the device number (for compatibility with other commands that require a slash to denote a 4-digit device number).

Specify UNIT=SNA to obtain an SNA line, or UNIT=TCP to obtain a TCP/IP line.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. This command will be in effect for this member only. There is no need to have this command issued to all members of the MAS.

Messages

The $HASP880 message displays the current values of all the parameters on the LINE(nnnnn) initialization statement.

JES2 specifies that line 1 has an address of 0026. When the local modem disconnects, JES2 automatically disconnects line 1 from the remote terminal.