|
Function To perform the following functions: - Assign command authority for the specified reader.
- Specify default routing, affinities, job and message classes for
jobs read by the specified reader.
- Hold all jobs read by the specified reader.
- Start or stop tracing of the JES2 processor associated with the
specified reader.
Syntax
>>-$T--+-RDR----+--+-nn--+------------+-------------------+----->
'-READER-' | '- ---+-nn-+-' |
| '-*--' |
| .-,--------------------------. |
| V | |
'-(------+-nn-+--+------------+---+--)-'
'-*--' '- ---+-nn-+-'
'-*--'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+---------------------------+-------------------------------><
'-| Modification keywords |-'
Modification keywords
|--+----------------------------------------------+------------->
| .-,----------------------. |
| V | |
'-,--Auth--=--(----+-Device--=--+-No--+-+-+--)-'
| '-Yes-' |
+-Job--=--+-No--+----+
| '-Yes-' |
'-System--=--+-No--+-'
'-Yes-'
>--+--------------------+--+---------------------+-------------->
'-,--Class--=--class-' '-,--Hold--=--+-----+-'
+-No--+
'-Yes-'
>--+-----------------------+--+----------------------+---------->
'-,--+-MSGclass-+--=--v-' '-,--PRIOINC--=--+-n-+-'
'-Q--------' '-0-'
>--+-----------------------+--+----------------------------+---->
'-,--PRIOLIM--=--+-n--+-' '-,--+-P-------+--=--prtdest-'
'-15-' '-PRTDEST-'
>--+----------------------------+------------------------------->
'-,--+-PUNDEST-+--=--pundest-'
'-U-------'
>--+-------------------------------------------------------------+-->
'-,--Sysaff--=--+-------------------------------------------+-'
+-memname-----------------------------------+
+-ANY---------------------------------------+
+-+-+--+--+-memname-+-----------------------+
| '- --' +-ANY-----+ |
| '-IND-----' |
'-(--+-memname-------------------------+--)-'
+-ANY-----------------------------+
| .-,---------------------------. |
| V (1) | |
'-----+----+--+-memname-+-------+-'
+-+--+ +-ANY-----+
'- --' '-IND-----'
>--+----------------------+--+-------------------------+-------->
'-,--TRace--=--+-No--+-' '-,--UNIT--=--+-devnum--+-'
+-P---+ '-/devnum-'
'-Yes-'
>--+------------------------+-----------------------------------|
'-,--Xeqdest--=--xeqdest-'
Notes: - Multiple Sysaff values can be coded up to 33 times
Selection limiting keywords
|--+-----------------------------------------------------------------+-->
| .-,----------------------------------. |
| V | |
'-,--+---+--Auth--=--(----+---/----Device--+-=--+--+-No--+-+-+--)-'
'-/-' | '-^=-' '-Yes-' |
+---/----Job--+-=--+--+-No--+----+
| '-^=-' '-Yes-' |
'---/----System--+-=--+--+-No--+-'
'-^=-' '-Yes-'
>--+----------------------------+------------------------------->
'-,----/----Class--+-=--+--a-'
+-^=-+
+->--+
'-<--'
>--+---------------------------------+-------------------------->
'-,----/----Hold--+-=--+--+-----+-'
'-^=-' +-No--+
'-Yes-'
>--+-----------------------------------+------------------------>
'-,--+---/----MSGclass-+--+-=--+--v-'
'---/----Q--------' +-^=-+
+->--+
'-<--'
>--+----------------------------------+------------------------->
'-,----/----PRIOINC--+-=--+--+-n-+-'
+-^=-+ '-0-'
+->--+
'-<--'
>--+-----------------------------------+------------------------>
'-,----/----PRIOLIM--+-=--+--+-n--+-'
+-^=-+ '-15-'
+->--+
'-<--'
>--+----------------------------------+------------------------->
'-,----/----TRace--+-=--+--+-No--+-'
'-^=-' +-P---+
'-Yes-'
>--+-------------------------------------------+----------------|
'-,----/----UNIT--+-=--+--+-devnum--+--unit-'
+-^=-+ '-/devnum-'
+->--+
'-<--'
Parameters - Auth=
- Specifies the
authority assigned to commands issued through the indicated reader.
- Device={No|Yes}
- If Device=Y,
the reader has authority to issue device commands to the local reader.
If Device=N is specified, the reader does not have device command
authority.
- Job={No|Yes}
- If Job=Y, the
reader has authority to issue job-related commands to the local reader.
If Device=N is specified, the reader does not have job command
authority.
- System={No|Yes}
- If System=Y,
the reader has authority to issue system commands to the local reader.
If System=N is specified, the reader does not have system command
authority.
This parameter affects JES2 command statements
only. Use the AUTH parameter of the JOBCLASS initialization statement
to specify the authorization for JCL command statements. JES2 command
statements begin with /* in columns 1 and 2. JCL command statements
begin with // in columns 1 and 2. Note: - DISPLAY authority results when you specify N for
every AUTH= subparameter. By setting each AUTH= subparameter to N, the indicated reader has no specific command authority, and
the indicated reader honors only those few commands requiring no authority
(for example, display commands).
- Network authority requires having system, job, or device authority in addition to network authority to have system, job, or device
commands take effect at another reader.
- This parameter is not valid for remote readers.
- Class=class
- The
default execution class for jobs that are read by the specified reader
and that do not have a job class specified on the JOB statement. If
you specify this parameter, the command requires device authority.
- HOLD=[No|Yes]
- Specifies whether
all jobs read by the specified reader are to be held after JCL conversion.
You can release these jobs on an individual basis using the $A command.
Note: In an NJE environment, if a job contains a /*ROUTE XEQ or /*XEQ
JES2 control statement specifying another node for execution, the
job is not held at the entry node, but at the execution node (that
is, the node which performs the JCL conversion).
- MSGclass|Q=v
- The 1 character
job execution class (A-Z,0-9) for jobs submitted through the specified
reader with no specified job execution class.
- PRIOINC={0|n}
- Specifies
a number (0-15) to be added to the selection priority of each job
entered at this card number.
- PRIOLIM={15|n}
- Specifies
the maximum priority level (0-15) that can be assigned to jobs entered
at this card reader. Any job's priority that exceeds this level will
be reduced to it.
- P|PRTDEST=prtdest
- Specifies the default destination for the print output
from all jobs that are read by the specified reader and that do not
have a /*ROUTE statement or DEST parameter. The value for all routing
numbers can range from 1 to 32767. For specification requirements,
see Route codes.
Note: NODENAME=REQUIRED
on the DESTDEF initialization statement will cause JES2 to require
that a userid be prefixed with a node name.
The valid destinations
are: - LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Nnnnn|nodename
- Indicates that jobs are to be run at the specified node(s). You
can specify a node using the decimal node identifier or an EBCDIC
nodename.
- destid
- Indicates that jobs are to be run at the specified node(s). You
can specify this location by an alias for the name of a node. If destid
is specified alone, it refers to both the node and the remote.
- NnnnnRmmmm|node.remote|node.userid
- Indicates routing to the remote Rmmmm at the node Nnnnn. Rmmmm
can also be specified as RMmmmm or RMTmmmm.
- Ummmm
- Indicates special local routing.
- node.destid
- Indicates a destination at the specified node. The destid refers
to both the node and the remote. The node specified in the destid
must be the same as the node portion of the route code. If the number
of the remote is reassigned, you can use the destid to send to this
node.
- remote
- Indicates routing to a remote. Remote can be specified in any
of the following ways:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Rmmmm
- Indicates routing to the specified remote. Rmmmm can also be
specified as RMmmmm or RMTmmmm. The value specified for mmmm can
range from 1 to 32767.
- destid
- Indicates routing to a destid referring to a remote.
- PUNDEST|U=pundest
- Specifies the default destination
for the punch output from all jobs that are read by the specified
reader and that do not have a /*ROUTE statement or DEST parameter.
Note: NODENAME=REQUIRED on the DESTDEF initialization statement will
cause JES2 to require that a userid be prefixed with a node name.
- Sysaff
- Changes the
system affinity of the job. Up to 33 entries can be coded by using
a combination of the following values:
- memname|*
- Specifies the identifier (1 to 4 alphanumeric characters) of a
member in the JES2 multi-access spool configuration that has affinity
for the job. Use an asterisk to specify the member that executes the
command.
- ANY
- Specifies jobs that are eligible to run on any member in the JES2
multi-access spool configuration. If you specify ANY followed by the
IND parameter, they must be separated by a comma and the list must
be enclosed in parentheses, for example, (ANY,IND).
- +|-
- The subsequent memnames, ANY, and IND, are to be added to (+)
or deleted from (-) the current list of affinities that are associated
with this job. If neither + nor – qualifier is specified anywhere
in the SYSAFF parameter, the affinity of the job is set explicitly
to the affinity entries that are specified in the SYSAFF parameter.
If a + or – qualifier is specified on the first entry in a list of
entries, the current affinity list of this job is affected. A + or
– qualifier on an entry will add (+) or delete (-) that entry from
the current affinity list of this job. If the first entry in a list
of entries has no + or - qualifier, the current affinity list of this
job will be replaced with the affinities that are determined by processing
the SYSAFF parameter. A + or – qualifier on a subsequent entry will
add (+) or delete (-) that entry from the replacement list. When a
+ or - qualifier is encountered in the SYSAFF parameter, the qualifier
becomes the active qualifier that is applied to each of the following
entries in the list until a different qualifier, or the keyword ANY
is encountered in the list.
Note: If you specify IND without any member
names (memname), you must specify + or - qualifier.
- IND
- Specifies the job that must be executed on a processor operating
in independent mode. IND cannot be specified by itself.
Note: The processing of the SYSAFF parameter must
result in at least one member that is eligible to execute this job.
Otherwise, the command will be rejected.
- TRace={No|P|Yes}
- Specifies whether
tracing is to be activated or deactivated for the JES2 processor associated
with the indicated reader. This parameter requires system authority.
- No
- Tracing is disabled.
- P|Yes
- Tracing is activated if trace IDs 11 and 12 are currently enabled.
Note: Trace IDs 11 and 12 may be enabled either at initialization
on the TRACE(n) statement or using the $S TRACE(n) command.
- RDRnn
- The local
reader that is affected by this command.
- Rnnnn.RDm
- The remote
reader that is affected by this command.
Note: - This parameter is not valid for remote readers.
- A reader may not be used to set the command authority for any
local reader device. The $T RDRnn,AUTH= command can be issued only
by a console with device and system authority.
- The command authorities that are set only operate on JES2 commands;
they do not apply to MVS™ commands.
- UNIT={devnum|/devnum}
- Specifies a 3-digit
or 4-digit hexadecimal device number. 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).
Note: This parameter is not valid for remote devices.
- Xeqdest={LOCAL|name|Nnnnn}
- Specifies the
default execution node for all jobs that are read by the specified
reader and that do not specify a /*XEQ statement. The valid node specifications
are:
- LOCAL
- The node to which the reader is attached.
- name
- A node identified by an installation-defined name.
- Nnnnn
- A specific node whose number is nnnn.
Authority Required This command requires device and system authority. See the description of AUTH= parameter for information about assigning the authority
of the appropriate MVS system command group. The $T INTRDR
command sets the command authority for internal readers. The $T NODE(nnnn)
command sets the command authority for a node.
This command
requires update 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 $HASP603 message displays
the status of the specified reader and its current characteristics.
The $HASP003 rc=65 message indicates that the device type specified
through the UNIT= parameter does not match the defined JES2 device
information.
The $HASP003 rc=66 message indicates that the
device type specified through the UNIT= parameter does not exist.
Examples 1 $t rdr3,auth=(d=y,j=y),h=y,tr=y
$HASP603 RDR3 UNIT=0012,STATUS=DRAINED,AUTH=(DEVICE=YES,
$HASP603 JOB=YES,SYSTEM=NO),CLASS=A,HOLD=YES,
$HASP603 MSGCLASS=A,PRIOINC=0,PRIOLIM=15,
$HASP603 PRTDEST=LOCAL,PUNDEST=LOCAL,SYSAFF=(ANY),
$HASP603 TRACE=YES,XEQDEST=LOCAL
JES2 assigns device and job command authority to reader
3 and activates tracing of the JES2 processor associated with reader
3. All jobs that are submitted through this reader are placed in hold
status after JCL conversion until the operator releases them for execution.
2 $t rdr1,s=(ind,sysa)
$HASP603 RDR3 UNIT=000E,STATUS=DRAINED,AUTH=(DEVICE=YES,
$HASP603 JOB=YES,SYSTEM=NO),CLASS=A,HOLD=YES,
$HASP603 MSGCLASS=A,PRIOINC=0,PRIOLIM=15,
$HASP603 PRTDEST=LOCAL,PUNDEST=LOCAL,SYSAFF=(IND,
$HASP603 SYSA),TRACE=YES,XEQDEST=LOCAL
All jobs read by reader 1 are eligible to run only on
SYSA, but only if SYSA is operating in an independent mode. 3 $t rdr2,c=d,q=a,s=+sysa
$HASP603 RDR3 UNIT=0012,STATUS=DRAINED,AUTH=(DEVICE=YES,
$HASP603 JOB=YES,SYSTEM=NO),CLASS=D,HOLD=YES,
$HASP603 MSGCLASS=A,PRIOINC=0,PRIOLIM=15,
$HASP603 PRTDEST=LOCAL,PUNDEST=LOCAL,SYSAFF=(SYSA,
$HASP603 SYSB,SYSC),TRACE=YES,XEQDEST=LOCAL
JES2 assigns execution class D and/or message output class
A to all jobs that are processed by reader 2 and that do not specify
a job and/or message output class in their JCL. SYSA is added to the
lists of systems that are eligible to process jobs read by reader
2. 4 $t r1.rd1,prtdest=local,pundest=r3,xeqdest=n4
$HASP603 R1.RD1 STATUS=DRAINED,CLASS=B,HOLD=NO,MSGCLASS=2,
$HASP603 PRIOINC=0,PRIOLIM=15,PRTDEST=LOCAL,
$HASP603 PUNDEST=R3,SYSAFF=(ANY),TRACE=NO,
$HASP603 XEQDEST=N4
All jobs read at RJE workstation 1 reader 1 that do not
specify a /*XEQ statement are routed by default to node 3 for execution.
The print output of these jobs is routed by default to local devices
and the punch output is routed to RJE workstation 3 off the local
node.
|