Function

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

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Parameters

n [-m | *]

The subscript defining the offload job transmitters that are affected by this command. The subscript can specify a single numeric value n (1-8) or a range of values n-m (1-8) associating offload job transmitters with offload devices. The asterisk character (*) can be used to specify the first or last offload job transmitter in a range (n-*, for example). A comma-delimited list of values or ranges is also supported. For details about specifying a range of values for this subscript, see Command syntax conventions.

CLass=classlist | (class,class...)

The job classes specified for this device. These classes are to be considered during job selection if CLass is specified in the work selection (WS) list. If job class is not a criterion for job selection, you may specify a null parameter of (CLass=).

The classlist variable specifies a list of single-character job classes A-Z and 0-9 (for example, 'ABCDEF'). A range of 1-36 single-character job classes can be specified.

The class variable specifies a comma separated list of job classes or job class groups (each 1-8 characters in length). A range of 1-8 items can be specified in the list. For example: (CLASS1,CLASS2,CLASS3).

CReator=creator

Specifies the 1 through 8 character userid that creates the SYSOUT data sets to be processed. You can also specify wild cards on this parameter. See Using wildcards for additional information.

j

An alphabetic character (A-Z) or any of the special characters ($, #, or @).

ccccccc

Any combination of EBCDIC characters except a comma, a right parenthesis, or an equal sign.

DISP={DELETE|HOLD|KEEP}

The disposition of all jobs that are selected for dumping to the offload data set.

DELETE

The jobs are purged after being dumped.

HOLD

The jobs are held after being dumped. These jobs are eligible for processing by another offload job transmitter that can select held jobs.

KEEP

The jobs retain their current status after being dumped. These jobs are eligible for processing by another offload job transmitter.

Hold=[No|Yes]

The Hold specification for this device.

No

Only non-held jobs are to be selected.

Yes

Only held jobs are to be selected.

If both held and non-held jobs are to be selected, specify a null parameter of (Hold=).

JOBname=jobname

A 1 to 8 character jobname that is considered as a work selection criterion, if JOBname is also specified in the WS= list. You can also specify wild cards on this parameter. See Using wildcards for additional information.

If the jobname is not a criterion for job selection, you may specify a null parameter of (JOBname=).

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

Specifies the limits (in records) set by this device for the amount of input records in a job. This range is considered as a work selection criterion if LIMit is also specified in the WS= list.

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

NOTify={No|Yes}

Specifies whether a notification message is sent to the TSO userid specified on the JOB statement or /*NOTIFY JECL statement. If you specify Y, a notification message is sent when a pre-execution job is dumped to the offload data set. If you specify N, no notification message is sent.

SCHenv=schenv

Specifies the 1 to 16 alphanumeric, special ($, #, or @), or wildcard character (or combination of them) scheduling environment. Only those jobs with this SCHENV will be selected.

SRVclass=srvclass

Specifies the 1 to 8 alphanumeric, special ($, #, or @), or wildcard character (or a combination of them) service class name. Only those jobs with this service class will be selected.

RANGE=low [-high]|J1–999999

The range of jobs that are to be selected by this device (1-999999). If you code this parameter, you can specify one or two values:

• If you specify one value, that value becomes both the low and the high end of the range.
• If you specify two values, the first value is the low end of the range and the second value the high end. The two values can be equal. If they are not equal, the second value must be larger than the first value.

Routecde=routecde

Specifies the execution node selection criteria for jobs to be transmitted. Use commas to separate individual route codes and enclose the list in parentheses if more than one route code is specified. You may specify up to four route codes. If you allow this parameter to default, JES2 can select all jobs, regardless of execution node, for transmission.

Note: NODENAME=REQUIRED on the DESTDEF initialization statement will cause JES2 to require that a userid be prefixed with a node name.

You can specify any of the following values for node:

LOCAL|ANYLOCAL

Indicates that only jobs routed to the local node for execution can be selected.

destid

Indicates that only jobs routed to the specified location through an alias for the name of a node can be selected for execution.

Nnnnn|nodename

Indicates that only jobs routed to the specified location through the decimal node identifier from 1 to 32767 or the EBCDIC nodename can be selected for execution.

If route code is not a criterion for job selection, you may specify a null parameter of (Routecde=()). You must specify the empty parentheses.

SYSaff=ANY|memname

The affinity selection criteria, if SYSaff is also specified in the WS= list.

memname

A specific member name. Jobs that have affinity for the specified member can be selected. You may specify up to 32 member names. Multiple member names must be separated by commas and the list must be enclosed in parentheses.

ANY

Jobs that have affinity for any member in the JES2 complex can be selected.

If affinity is not a criterion for job selection, you may specify a null parameter of (SYSaff=()). You must specify the empty parentheses.

Volume=volume

The volume serial (5-6 characters) of a volume containing a spool data set. If Volume is also specified in the WS= list, only those jobs that reside on one or more of the specified volume(s) can be selected for dumping. You may specify up to 4 volumes. Multiple entries must be separated by commas and the list must be enclosed in parentheses.

If volume is not a criterion for job selection, specify a null parameter of (Volume=()) and do not specify Volume in the WS= list. You must specify the empty parentheses ().

WS=ws

Specifies the work selection criteria for the 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 an offload job 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 matched exactly except in the following cases:
   • Class
   • Routecde
   • SYSaff
   • Volume

   Table 1 describes the effect of each criterion when placed before and after the slash.

2. Class, Routecde, SYSaff, and Volume can be specified as multiple values on the offload job transmitter initialization statement. Placing these criteria before the slash in the WS= list, indicates a left to right priority order of multiple values, if multiple values have been specified. Placing these criteria after the slash indicates no priority order of multiple values, but a match is still required.
3. 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.
4. 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 $toff1.jt,ws=(-jobname) and jobname is not in the current work selection list for off1.jt, you get the $HASP003 message.
5. 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.
6. 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.
7. 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 that is currently specified in the work selection (WS=) list, for example, CLass=(), you must remove that criterion from the WS= list. If you do not remove the criterion from the WS= list, this device does not select any jobs.
• If you are uncertain of the characteristics in effect, enter the $D or $D U command for the particular offload job transmitter.

Scope

Single member. The values supplied for this command will be in effect for this member only.

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 $HASP884 message displays the current settings of all the parameters on the OFF.JT initialization statement.

Offload transmitter 1 selects only held jobs whose execution class is A. Because the RANGE criterion is placed after the slash in the work selection (WS=) list, it is preferred but not necessary that the job numbers of these jobs be within the job range (RANGE=) specification of this transmitter. When the transmitter dumps these jobs to the offload data set, they are to retain their current status.

JES2 removes the hold specification from the work selection criteria of all defined offload job transmitters. Both held and non-held jobs are eligible for selection by any offload job transmitter.