Function

To display the characteristics of a line.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information. One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Parameters

nnnnn

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).

AUTODISC[={No|Yes]

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

CODE[=A|B]

Displays 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.

COMPRESS[=No|Yes]

Displays whether this line allows terminals to use data compression.

CONNECT=(Yes|No|DEFAULT,interval)

Displays whether an NJE connection is automatically attempted for this line. The interval is the approximate time (in minutes) between attempted connections. The valid range for interval is 0-1440. A value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used. A third positional displays the approximate time (yyyy.ddd,hh:mm) when the next attempt is made.

Discon[=I|INTERRUPT|No|Q|QUIESCE]

Displays whether the line is to be disconnected immediately (I), after it completes its current activity (Q), or not at all (NO).

I|INTERRUPT

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

Q|QUIESCE

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

NO

The line is not to be disconnected.

DUPLEX[=FULL|HALF]

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

INTERFAC[=A|B]

Displays 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.

JRNUM[=n|DEFAULT]

Displays 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.

JTNUM[=n|DEFAULT]

Displays 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.

LINECCHR[=EBCDIC|USASCII]

Displays how the adapter is configured.

EBCDIC

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

USASCII

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

LOG[=No|Yes]

Displays whether JES2 is to monitor the specified line for channel-end completions (BSC lines) or SNA events (SNA lines).

NODE=node

Displays the NJE node name associated with this node.

NODES=

Displays and filters all lines through which node can be reached.

Password

Displays the security password used to reject unauthorized terminals attempting to use the specified line.

REST[=nnnn]

Displays an integer (0-2000) that represents the resistance rating of the line as viewed by the installation management and coordinated with other installations.

RESTART=(Yes|No,interval)

Displays 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. A third positional displays the approximate time (yyyy.ddd,hh:mm) when the next attempt is made. A value of 0 indicates that the default interval (from NJEDEF CONNECT=) is used.

RMTSHARE[=NO|YES|N/A]

Displays whether the line is allowed to be dedicated by specifying it on the LINE= parameter of a $ADD RMT(nnnn) command or a $T RMT(nnnn) command. This parameter is displayed for both BSC and SNA lines.

YES

Displays that this line can be shared. That is, this line is:

• An SNA line
• Not dedicated to any RJE workstation or
• Dedicated to one or more BSC RJE workstations with SHARABLE=YES specified on the RMT(nnnn) definition.

NO

Displays that this line cannot be shared. That is, this line is dedicated to one BSC RJE workstation with SHARABLE=NO specified on the RMT(nnnn) definition.

N/A

Displays that this line is not available.

SESsions

Displays the VTAM® application interfaces and their corresponding status associated with this SNA line.

SPEED[=HIGH|LOW]

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

Note: This parameter is applicable only to 360/20 sub-models 2 and 4.

SRNUM[=n|DEFAULT]

Displays 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.

STATUS[=ACTIVE|DRAINED|DRAINING|INACTIVE |SIGNON/AWAITING-MAS(x)|SIGNON/AWAITING-c ]

Displays the current status of the device. The following types of status can be displayed:

Type

Meaning

ACTIVE

JES2 is using the device for job processing and will continue to do so as long as jobs are both available and eligible for the device.

DRAINED

JES2 does not use the device until you start it with a $S command.

DRAINING

JES2 is using the device to process jobs, but will stop using this device once the current function has completed.

INACTIVE

JES2 is not using the device, but would do so if a job were both available and eligible for the device.

SIGNON/AWAITING-MAS(x)

The device signing on is waiting for responses from one or more MAS members. In the message, x can be the member name, or a list of member names, from which a response is required.

SIGNON/AWAITING-c

The device signing on is waiting for an NCC record from the other end of the connection. In the message, c is the NCC record type (J, K, or L) for which the sign-on is waiting.

STNUM=stnum

Displays 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.

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

Displays whether I/O operations on the specified line are to be traced. The following types of status can be displayed:

Type

Meaning

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]

Displays whether the text transparency feature of the BSC adapter is present on this line.

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

Displays a 4-digit hexadecimal device number for a binary synchronous communication (BSC) line. You can specify wild cards on this parameter. See Using wildcards for additional information.

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 character (/) 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 information about a systems network architecture (SNA) line, or UNIT=TCP to obtain information about a TCP/IP line.

Authority Required

This command requires display 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 read 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 response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP880 message displays the status of the specified lines and their current characteristics.