Function

To specify the work selection and processing characteristics of one or more indicated SYSOUT transmitters.

Parameters

(nnnn)

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 SYSOUT transmitter or transmitters that are affected by this command. The subscript can specify a numeric value (1-7) or a range of values for SYSOUT 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. This number applies to the total lines of all non-spun output in the job or to individual spun SYSOUT data sets (or data set fragments) in a job.

For both variables m and n, you can specify a range of values from 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.

OUTDISP={H|HOLD|K|KEEP|L|LEAVE| W|WRITE}

Specifies the disposition(s) that the output must have in order to be eligible for processing by this transmission line. The operator can specify one to four of the following valid dispositions: Hold, Keep, Leave, or Write.

PLIM={m|m-n|m-*}

Specifies the limits (in pages) for SYSOUT data sets that the SYSOUT transmitter will select. This number applies to the total pages of all non-spun output in the job or to individual spun SYSOUT data sets in a job.

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=(criteria)

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 SYSOUT transmitter work selection list are:

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

2. 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.
3. Specifying a minus sign (-) before a criterion causes that criterion to be removed from the list.
   Note: An invalid operand message ($HASP650) 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 $toff1.st,ws=(-jobname) and jobname is not in the current work selection list for off1.st, you get the $HASP650 message.
4. 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.
5. 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.
6. 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.
7. In general, the smaller the work selection list the less the placement of certain criteria within the list affects the work selection.
8. For both line and page mode devices, the LIM= and PLIM= values must be satisfied.

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 $HASP603 message displays the current settings of all the parameters on the L(nnnn).ST(n) initialization statement.

SYSOUT transmitter 1 on line 1 takes work selection limits of 0-100 lines and 0-5 pages.