Function

To dynamically add a line.

Parameters

nnnn

The subscript defining 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 (Yes) or not (No) this line is to be disconnected automatically from a terminal when the local modem disconnects.

Note: If you use AUTODISC=Yes for a leased, dedicated line, you may cause serious performance impact without receiving the $HASP094 I/O ERROR message. This may also occur if a modem is disconnected or powered-off during a session or a line started with a modem disconnected or powered off.

CODE={A|B}

Specifies the code for this line.

A

Specifies code A for this line; code A refers to the first code in a BSC adapter that has the dual code feature.

B

Specifies code B for this line. Code B refers to the second code in a BSC adapter that has the dual code features. If the dual code feature is not present, B should not be specified. See 2701 Data Adapter Unit Component Description , GA22-6864 for information about BSC CCWs and sense codes.

COMPRESS={No|Yes}

For RJE workstations only, specifies whether (Yes) or not (No) BSC hardware terminals attached to this line can utilize data compression. If you specify NO, it overrides the specification of the COMPRESS= parameter on the RJE workstation (RMT(nnnn) ) initialization statement for any workstation that might use this line and any remote device statement. Compression compatibility is standard for BSC multileaving workstations.

If you specify COMPRESS=Yes, the specification of the COMPRESS= parameter on the RMT(nnnn) and the COMP parameter on the remote device (Rnnnn.xxx) statements is allowed to take effect. IF RMT(nnnn) specifies COMPRESS=No, or Rnnnn.xxx specifies NOCOMP, no compression will take place.

This parameter defaults to Yes, which specifies that the line allows data compression.

CONNECT= (Yes|No|DEFAULT,interval)

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

DUPLEX={FULL|HALF}

Specifies whether this is a full-duplex (FULL) or half-duplex (HALF) line.

INTERFAC={A|B}

A specifies interface A for this line; interface A refers to the first interface in a BSC adapter that has the dual-communications interface feature. B specifies interface B for this line; interface B refers to the second interface in a BSC adapter that has the dual-communications interface feature. If the adapter for this line does not have the dual-communications interface feature, B should not be specified.

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}

USASCII specifies that the BSC adapter is configured for ASCII line-control characters. When USASCII is specified, this line must be used with 2770, 2780, or 3780 USASCII terminals. EBCDIC specifies that the BSC adapter is configured for EBCDIC line-control characters.

LOG={No|Yes}

Specifies whether (Yes) or not (No) JES2 is to monitor this line for channel-end completions or SNA events. If you specify LOG=Yes, JES2 issues $HASP094 message for every transmission across this BSC line. You should specify LOG=No if your installation performs extensive networking activity.

Password=password

Specifies a 1 to 8 character security password JES2 uses to prevent unauthorized terminal users from using this line. This password can be used in the connection request from RJE workstations.

If you do not specify a password, one does not exist.

REST=rest

Specifies an integer between 0 and 2000 which represents the resistance rating of the line as viewed by the installation management and coordinated with other installations. Resistance is an arbitrary value set to indicate a specific line's ability/inability to route work due to “normal” workload requirements and line speed. Refer to z/OS JES2 Initialization and Tuning Guide, SA32-0991 for details concerning resistance selection.

RESTART=(Yes|No,interval)

Specifies whether this line will be restarted if it is drained. The interval is the approximate 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. The default RESTART value is No, and the default interval value is 0.

SPEED={HIGH|LOW}

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

Note: This parameter is only applicable to 360/20 submodels 2 and 4.

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 (Yes) or not (No) the text transparency feature of the BSC adapter is present on this line. Yes must be specified for NJE lines.

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 will have no effect and TRANSPAR=YES will be forced at initialization.

UNIT=unit

UNIT can be specified as one of the following:

• A 3- or 4-digit hexadecimal device number. Device numbers can be specified in any of the following formats:

  UNIT=hhh
  UNIT=hhhh
  UNIT=/hhh
  UNIT=/hhhh

  where hhh and hhhh represent the device numbers.

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

• For RJE BSC lines, specify the device number as the same address that you specified for the subchannel address defined for the communication controller.
• NJE protocols support an ESCON®® Basic Mode CTC (defined to the hardware configuration dialog as BCTC) and a 3088 CTC but do not support an ESCON CTC (defined to the hardware as SCTC).

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

Authority Required

This command requires device 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. The values supplied for this command will be in effect for this member only.

Messages

The $HASP880 message displays the current status of all parameters that define this LINE.