Function
To specify the work selection
and processing characteristics of one or more indicated job transmitters.
Syntax
>>-$T----------------------------------------------------------->
>--L--+-nn--+------------+-------------------+--.JT--+-nn--+------------+-------------------+-->
| '- ---+-mm-+-' | | '- ---+-mm-+-' |
| '-*--' | | '-*--' |
| .-,--------------------------. | | .-,--------------------------. |
| V | | | V | |
'-(------+-nn-+--+------------+---+--)-' '-(------+-nn-+--+------------+---+--)-'
'-*--' '- ---+-mm-+-' '-*--' '- ---+-mm-+-'
'-*--' '-*--'
>--+----------------------+--+----------------------------+----><
'-,--LIMit--=--+-m---+-' '-,--WS--=--+-ws-----------+-'
+-m-n-+ | .-,--. |
'-m-*-' | V | |
'-(----ws-+--)-'
Parameters
- (nn)
- The subscript defining the NJE transmission line or lines
that are affected by this command. The subscript can specify a numeric
value (1-65535) or a range of values associating lines with SYSOUT
transmitters.
- (n)
- The subscript defining the job transmitter or transmitters that are
affected by this command. The subscript can specify a numeric value
(1-7) or a range of values for job transmitters on the specified line.
- LIMit={m|m-n|m-*}
- Specifies the limits (in records) for SYSOUT data sets
that the SYSOUT transmitter will select.
For both variables m and n, you can specify a range of values 0-4294967295. m and n can be equal. If they
are not equal, n must be larger than m.
If you code only m, that value becomes both the lower and
upper limit. If m-* is specified, the upper limit is set to the default
value of 4294967295.
- WS=ws
- Specifies the work selection criteria for this device. Using any combination
of user and JES2-defined criteria, you can specify up to 19 criteria
in the WS= list. Multiple entries must be separated by commas and
the list must always be enclosed in parentheses (even if only one
criterion is specified). If a criterion is specified in the list,
work selection is based on the current setting of the corresponding
parameter. If a criterion is not specified in the list, the criterion
is not considered during work selection.
The general rules for
specifying a job transmitter work selection list are:
- You can use one slash (/) before or after one of the criterion
to further specify work selection. Criteria placed before the slash
must be matched exactly if the work is to be selected. Criteria placed
after the slash do not have to match exactly.
Table 1, describes the effect of
each criterion when placed before and after the slash.
- The order of those criteria specified after the slash indicates
the priority (highest to lowest, in left to right order) in which
JES2 attempts to match them.
- Specifying a minus sign (-) before a criterion causes that criterion
to be removed from the list.
Note: An invalid operand message ($HASP003)
is issued if an error is found in the WS operand, that is, if you
try to remove a criterion that is not there. For example: If you
enter $tl1.jt1,ws=(-limit) and limit is not in the current work selection
list for l1.jt1, you get the $HASP003 message.
- Specifying a criterion that is not currently specified in the
list adds it to the end of the list either before or after the slash,
depending on the placement of the slash in the command. If the slash
is omitted from the command, JES2 assumes that the slash is at the
end of the command.
- Specifying a criterion currently in the list causes that criterion
to be moved to the end of the list, thereby decreasing its priority.
To correct a WS list that was erroneously changed by an incorrect
operator command, remove any criterion that should not be in the list
(specify a minus sign (-) before the criterion). If necessary, reorder
the remaining criterion.
- The LIMit subparameter has no effect as a work selection value
for files received from a node that does not provide a page count
for its files. For more information, refer to the sending node's
reference documentation.
- In general, the smaller the work selection list the less the placement
of certain criteria within the list affects the work selection.
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.
Processing Considerations
- If you specify a null value for a characteristic, make sure that
characteristic is not specified as an exact match criterion in the
work selection list. If the characteristic is specified as an exact
match criterion, this device does not select any output.
- If you are uncertain of the characteristics in effect, enter the
$D or $D U command for the particular SYSOUT transmitter.
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 $HASP003 message displays
the current settings of all the parameters on the L(nnnn).JT(n) initialization
statement.
Example
1 $t l1.jt1,ws=(lim),lim=(0-100)
$HASP603 L1.JT1 UNIT=0022,STATUS=DRAINED,LIMIT=(0,100),
$HASP603 WS=(LIM/)
Job transmitter 1 on line 1 takes work selection limits
of 0-100 records.
Table 1. SYSOUT Transmitter
Work Selection CriteriaCRITERION |
BEFORE SLASH (/) |
AFTER SLASH (/) |
---|
LIMit |
The amount of output generated by an output group
must fall within the limits (LIMit=) set for this device. This
subparameter has no effect as a work selection value for files received
from a node that does not provide a page count for its files. For
more information, refer to the sending node's reference documentation.
|
It is not required that the amount of output generated
by the output group fall within the limits (LIMit=) set for this device.
This subparameter has no effect as a work selection value for
files received from a node that does not provide a page count for
its files. For more information, refer to the sending node's reference
documentation.
|