|
Function To perform the following functions: - Assign command authority for internal readers.
- Specify a default job class and/or affinity for jobs read by internal
readers.
- Hold all jobs read by internal readers.
- Start or stop tracing of the JES2 processor associated with internal
readers.
Syntax
>>-$T--INTRDR--+---------------------------+-------------------->
'-| Modification keywords |-'
>--+---------------------------------+-------------------------><
'-| Selection limiting keywords |-'
Modification keywords
|--+----------------------------------------------+------------->
| .-,----------------------. |
| V .-No--. | |
'-,--Auth--=--(----+-Device--=--+-Yes-+-+-+--)-'
| .-No--. |
+-Job--=--+-Yes-+----+
| .-No--. |
'-System--=--+-Yes-+-'
>--+------------------------+--+--------------------+----------->
'-,--ASID_TRACE--=--asid-' '-,--Class--=--class-'
>--+---------------------+--+-------------------------+--------->
| .-No--. | '-,--HONORlim--=--+-No--+-'
'-,--Hold--=--+-Yes-+-' '-Yes-'
>--+------------------------------+----------------------------->
'-,--JOBNAME_TRACE--=--jobname-'
>--+------------------------------------+----------------------->
'-,--JOB_NUMBER_TRACE--=--job_number-'
>--+------------------------+--+------------------------+------->
| .-o---. | | .-15--. |
'-,--PRTYINC--=--+-n-n-+-' '-,--PRTYLIM--=--+-n-n-+-'
>--+-------------------------------------------------------------+-->
'-,--Sysaff--=--+-------------------------------------------+-'
+-memname-----------------------------------+
+-ANY---------------------------------------+
+-+-+--+--+-memname-+-----------------------+
| '- --' +-ANY-----+ |
| '-IND-----' |
'-(--+-memname-------------------------+--)-'
+-ANY-----------------------------+
| .-,---------------------------. |
| V (1) | |
'-----+----+--+-memname-+-------+-'
+-+--+ +-ANY-----+
'- --' '-IND-----'
>--+----------------------+-------------------------------------|
| .-No--. |
'-,--TRace--=--+-P---+-'
'-Yes-'
Selection limiting keywords
|--+-----------------------------------------------------------------+--|
| .-,----------------------------------. |
| V .-No--. | |
'-,--+---+--Auth--=--(----+---/----Device--+-=--+--+-Yes-+-+-+--)-'
'-/-' | '-^=-' |
| .-No--. |
+---/----Job--+-=--+--+-Yes-+----+
| '-^=-' |
| .-No--. |
'---/----System--+-=--+--+-Yes-+-'
'-^=-'
Notes: - Multiple Sysaff values can be coded up to 33 times
Parameters - INTRDR
- All internal
readers are affected by this command.
- ASID_TRACE
- Specifies the ASID used when filtering JES2 INTRDR trace points.
Note: If TRACE=YES is specified, any ASID_TRACE, JOBNAME_TRACE,
or JOB_NUMBER_TRACE filter is ignored. If more than one ASID_TRACE=,
JOBNAME_TRACE=, and JOB_NUMBER_TRACE= parameters are specified, only
one of the conditions must match the trace to be taken. For jobs that
are being submitted through the internal reader, the job name, number
and ASID of the job submitter are compared to the filters—not the
job name, number and ASID of the job that is being submitted.
- Auth
- The
command authority for internal readers, that is, the JES2 command
groups that the reader is authorized to enter.
- DEVICE={No|Yes}
- Specifies
whether the commands that have the authority to affect devices can
enter the system from the internal readers.
- Job={No|Yes}
- Specifies
whether the commands that have the authority to affect jobs can enter
the system from the internal readers.
- System={No|Yes}
- Specifies
whether the commands that have the authority to affect system resources
can enter the system from the internal readers.
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: - A reader may not be used to set the command authority for any
local reader device. The $T INTRDR,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.
- CLASS=class
- Specifies the default execution class for jobs that are read by internal
readers and that do not have a job class specified on the JOB statement.
Note: If you specify this parameter, the command requires device
authority.
- Hold|H={No|Yes}
- Specifies whether (Y)
or not (N) all jobs submitted through internal readers are to be held
after JCL conversion. You can release these jobs on an individual
basis using the $A command.
- HONORlim|HONOR={No|Yes}
- Specifies
whether (Y) or not (N) data sets sent to the internal reader are to
be counted toward the byte limit for a job.
- JOBNAME_TRACE
- Specifies the jobname used when filtering JES2
INTRDR trace points.
- JOB_NUMBER_TRACE
- Specifies the job number used when filtering JES2 INTRDR trace
points.
- PRTYINC={n-n}
- Specifies a number (0-15) to be added to the selection priority
of each job entered at this card reader. If the total of this number
and a job's priority exceeds the priority level specified by PRTYLIM=
(described next), JES2 uses the priority level specified by PRTYLIM=.
- PRTYLIM={n-n}
- Specifies the maximum priority level (0-15) that can be assigned
to jobs entered at this card reader. Any job that exceeds this priority
is reduced to this level.
- 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 all of the internal
readers. 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.
Note: If TRACE=YES is specified, any ASID_TRACE, JOBNAME_TRACE,
or JOB_NUMBER_TRACE filter is ignored. If more than one ASID_TRACE=,
JOBNAME_TRACE=, and JOB_NUMBER_TRACE= parameters are specified, only
one of the conditions must match the trace to be taken. For jobs that
are being submitted through the internal reader, the job name, number
and ASID of the job submitter are compared to the filters—not the
job name, number and ASID of the job that is being submitted.
Authority Required This command requires device and 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. 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. The values
supplied for this command will be in effect for this member only.
The $T INTRDR command affects all internal readers generated
and cannot be used to control a single internal reader.
Depending
on your installation's setup, however, you might want this command
to be applied to all members of the MAS (to ensure a consistent environment
across the MAS). If 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 $HASP838 message displays
the characteristics of internal readers and their current characteristics.
Examples 1 $t intrdr,sysaff=(n1m1,n1m2),tr=y
$HASP838 INTRDR
AUTH=(DEVICE=NO,JOB=NO,SYSTEM=NO),BATCH=YES
$HASP838 CLASS=A,HOLD=NO,PRTYINC=0,PRTYLIM=15,
$HASP838 SYSAFF=(N1M1,N1M2),TRACE=YES
JES2 assigns the affinities of N1M1, and N1M2 to all internal
readers and activates tracing for the associated JES2 reader processor.
2 $t intrdr,c=f,s=+ind,sysa
$HASP838 INTRDR
AUTH=(DEVICE=NO,JOB=NO,SYSTEM=NO),BATCH=YES
$HASP838 CLASS=F,HOLD=YES,PRTYINC=0,PRTYLIM=15,
$HASP838 SYSAFF=(IND,SYSA,SYSB),TRACE=NO
JES2 assigns execution class F to all jobs submitted through
internal readers which do not specify a job class on their JOB statements.
In addition, all jobs read by internal readers are eligible to run
on members SYSA and SYSB if these members are operating in independent
mode.
|