|
Function To perform the following functions: - Specify the characteristics of a line.
- Diagnose line problems.
- Disconnect a line.
Syntax
>>-$T--+-LINE-+--+-nn--+------------+-------------------+------->
'-LNE--' | '- ---+-mm-+-' |
| '-*--' |
| .-,--------------------------. |
| V | |
'-(------+-nn-+--+------------+---+--)-'
'-*--' '- ---+-mm-+-'
'-*--'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+---------------------------+-------------------------------><
'-| Modification keywords |-'
Modification keywords
|--+-------------------------+--+-------------------+----------->
'-,--AUTODISC--=--+-No--+-' '-,--CODE--=--+-A-+-'
'-Yes-' '-B-'
>--+-------------------------+---------------------------------->
'-,--COMPRESS--=--+-No--+-'
'-Yes-'
>--+-------------------------------------------------+---------->
'-,--CONNECT--=--+-+-DEFAULT-+------------------+-'
| +-YES-----+ |
| '-NO------' |
'-(--+-YES-+--+-----------+--)-'
'-NO--' '-,interval-'
>--+-----------------------------+------------------------------>
'-,--Discon--=--+-I---------+-'
+-INTERRUPT-+
+-No--------+
+-Q---------+
'-QUIESCE---'
>--+------------------------+--+-----------------------+-------->
'-,--DUPLEX--=--+-FULL-+-' '-,--INTERFAC--=--+-A-+-'
'-HALF-' '-B-'
>--+-------------------------+--+-------------------------+----->
'-,--JRNUM--=--default--n-' '-,--JTNUM--=--default--n-'
>--+-----------------------------+--+--------------------+------>
'-,--LINECCHR--=--+-EBCDIC--+-' '-,--LOG--=--+-No--+-'
'-USASCII-' '-Yes-'
>--+------------------+--+--------------------------+----------->
'-,--NODE--=--node-' '-,--Password--=--password-'
>--+------------------+----------------------------------------->
'-,--REST--=--rest-'
>--+-------------------------------------------------+---------->
'-,--RESTART--=--+-+-YES-+----------------------+-'
| '-NO--' |
'-(--+-YES-+--+-----------+--)-'
'-NO--' '-,interval-'
>--+-----------------------+--+-------------------------+------->
'-,--SPEED--=--+-HIGH-+-' '-,--SRNUM--=--default--n-'
'-LOW--'
>--+-------------------------+--+------------------------+------>
'-,--STNUM--=--default--n-' '-,--TRaceio--=--+-No--+-'
'-Yes-'
>--+-------------------------+--+------------------+------------|
'-,--TRANSPAR--=--+-No--+-' '-,--UNIT--=--unit-'
'-Yes-'
Selection limiting keywords
|--+-------------------------------------+---------------------->
'-,----/----AUTODISC--+-=--+--+-No--+-'
'-¬=-' '-Yes-'
>--+-------------------------------+---------------------------->
'-,----/----CODE--+-=--+--+-A-+-'
'-¬=-' '-B-'
>--+-------------------------------------+---------------------->
'-,----/----COMPRESS--+-=--+--+-No--+-'
'-¬=-' '-Yes-'
>--+-------------------------------------------------------------+-->
'-,----/----CONNECT--+-=--+--+-+-DEFAULT-+------------------+-'
'-¬=-' | +-YES-----+ |
| '-NO------' |
'-(--+-YES-+--+-----------+--)-'
'-NO--' '-,interval-'
>--+-----------------------------------------+------------------>
'-,----/----Discon--+-=--+--+-I---------+-'
'-¬=-' +-INTERRUPT-+
+-No--------+
+-Q---------+
'-QUIESCE---'
>--+------------------------------------+----------------------->
'-,----/----DUPLEX--+-=--+--+-FULL-+-'
'-¬=-' '-HALF-'
>--+-----------------------------------+------------------------>
'-,----/----INTERFAC--+-=--+--+-A-+-'
'-¬=-' '-B-'
>--+--------------------------------+--------------------------->
'-,----/----JRNUM--+-=--+--jrnum-'
+-¬=-+
+->--+
'-<--'
>--+--------------------------------+--------------------------->
'-,----/----JTNUM--+-=--+--jtnum-'
+-¬=-+
+->--+
'-<--'
>--+-----------------------------------------+------------------>
'-,----/----LINECCHR--+-=--+--+-EBCDIC--+-'
'-¬=-' '-USASCII-'
>--+--------------------------------+--------------------------->
'-,----/----LOG--+-=--+--+-No--+-'
'-¬=-' '-Yes-'
>--+------------------------------+----------------------------->
'-,----/----NODE--+-=--+--node-'
'-¬=-'
>--+------------------------------+----------------------------->
'-,----/----REST--+-=--+--rest-'
+-¬=-+
+->--+
'-<--'
>--+-------------------------------------------------------------+-->
'-,----/----RESTART--+-=--+--+-+-YES-+----------------------+-'
'-¬=-' | '-NO--' |
'-(--+-YES-+--+-----------+--)-'
'-NO--' '-,interval-'
>--+-----------------------------------+------------------------>
'-,----/----SPEED--+-=--+--+-HIGH-+-'
'-¬=-' '-LOW--'
>--+--------------------------------+--------------------------->
'-,----/----SRNUM--+-=--+--srnum-'
+-¬=-+
+->--+
'-<--'
>--+--------------------------------+--------------------------->
'-,----/----STNUM--+-=--+--stnum-'
+-¬=-+
+->--+
'-<--'
>--+----------------------------------------+------------------->
'-,----/----TRaceio--+-=--+--+-No------+-'
'-¬=-' +-Yes-----+
+-JES-----+
+-+-YES-+-+
| '-NO--' |
+-COMMON--+
+-+-YES-+-+
| '-NO--' |
+-VERBOSE-+
'-+-YES-+-'
'-NO--'
>--+-------------------------------------+---------------------->
'-,----/----TRANSPAR--+-=--+--+-No--+-'
'-¬=-' '-Yes-'
>--+-----------------------------------------------+------------|
'-,----/----UNIT--+-=--+--unit--TCP--+-TCPIP--+-'
+-¬=-+ '-TCP/IP-'
+->--+
'-<--'
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: - You can change this parameter only if the specified line is drained.
- 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: - Compression compatibility is standard for SNA remotes and BSC
multi-leaving workstations. NJE data will always be compressed.
- 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: - This parameter is applicable only to 360/20 sub-models 2 and 4.
- 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: - 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.
- 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.
Examples 1 $t line(4),autodisc=y,transpar=y
$HASP880 LINE4 UNIT=0C14,STATUS=DRAINED,AUTODISC=YES,
CODE=A,COMPRESS=YES,DUPLEX=HALF,INTERFAC=A,
LINECCHR=EBCDIC,LOG=NO,PASSWORD=(SET),
REST=0,SPEED=HIGH,TRACEIO=NO,TRANSPAR=YES
When the local modem disconnects, JES2 automatically disconnects
line 4 from the remote terminal. The text transparency feature of
the BSC adapter is present on line 4. 2 $t line(12),log=y,p=
$HASP880 LINE12 UNIT=SNA,STATUS=INACTIVE,COMPRESS=YES,
LOG=YES,PASSWORD=(NOTSET),REST=2,
SESSIONS=(JESA/INACTIVE),TRACEIO=YES
JES2 deletes the password for line 12 and no password
is required. JES2 issues a diagnostic message for each SNA event detected
on line 12. In the $HASP880 message, the SESSIONS= parameter displays
the name of the SNA session (JESA) on this line and the status of
that session (INACTIVE). 3 $t line(26),unit=sna
$HASP880 LINE26 UNIT=SNA,STATUS=DRAINED,COMPRESS=YES,LOG=NO
$HASP880 PASSWORD=(NOTSET),REST=0,SESSIONS=,TRACEIO=NO
JES2 specifies that previously defined line 26 is an SNA
line. Its status is drained, so a $S LINE command is necessary to
start it. 4 $t line(1),unit=026
$HASP880 LINE1 UNIT=0026,STATUS=DRAINED,AUTODISC=YES,CODE=A,
$HASP880 COMPRESS=YES,DUPLEX=FULL,INTERFAC=A,
$HASP880 LINECCHR=EBCDIC,LOG=NO,PASSWORD=(NOTSET),
$HASP880 REST=0,SPEED=LOW,TRACEIO=NO,TRANSPAR=YES
JES2 specifies that line 1 has an address of 0026. When
the local modem disconnects, JES2 automatically disconnects line 1
from the remote terminal.
5 $tline15,restart=(yes,1)
$HASP880 LINE15
$HASP880 LINE15 UNIT=SNA,STATUS=ACTIVE,COMPRESS=YES,
$HASP880 DISCON=NO,LOG=NO,PASSWORD=(NOTSET),REST=0,
$HASP880 NODE=0,RMTSHARE=YES,SESSIONS=,
$HASP880 CONNECT=(DEFAULT),RESTART=(YES,1),
$HASP880 TRACEIO=(NO),JRNUM=DEFAULT,JTNUM=DEFAULT,
$HASP880 SRNUM=DEFAULT,STNUM=DEFAULT
|