Function

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

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

Parameters

n [-m | *]

The subscript defining the offload job receivers 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 receivers with offload devices. The asterisk character (*) can be used to specify the first or last offload job receivers 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 only job classes that this device selects, if CLass is also specified in the WS= list. If job class is not a criterion for job selection, specify a null parameter of (CLass=) and do not specify CLass in the WS= list.

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.

Hold=[No|Yes]

The Hold specification for this device.

No

Only non-held jobs can be selected, if Hold is also specified in the WS= list.

Yes

Only held jobs can be selected, if Hold is also specified in the WS= list.

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. If JOBname is also specified in the WS= list, only those jobs with this jobname can be selected. 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, specify a null parameter of (JOBname=) and do not specify JOBname in the WS= list.

MOD=

Defines modifications to the specified characteristics of pre-execution jobs that are selected for reloading. These modifications are assigned during the reload process. If you specify more than one of the following parameters, each must be separated by commas and the list must be enclosed in parentheses.

CLass=class

The new execution class of all pre-execution jobs that are loaded by this receiver. A null parameter of (CLass=) specifies that the execution class is not modified.

Hold={No|Yes}

Specifies whether pre-execution jobs are to be held when loaded. If you specify Y, all pre-execution jobs that are loaded are held until released for execution. If you specify N, all pre-execution jobs that are loaded are to be released for execution. A null parameter of (Hold=) specifies that the Hold specification is not modified.

Routecde=routecde

Specifies the node from which jobs loaded by this device are run.

LOCAL|ANYLOCAL

Indicates that jobs are to be run at the local node.

destid

Indicates that jobs are to be run at the specified node. This location can be specified by an alias.

Nnnnn|nodename

Indicates that jobs are to be run at the node specified by its decimal node identifier from 1 to 32767 or through an EBCDIC nodename.

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

SYSaff=sysaff

The new affinity for all pre-execution jobs loaded by this receiver. ANY indicates the job can execute on any member in the JES2 complex. A null parameter of (SYSaff=) specifies that the affinity is not to be modified.

NOTify={No|Yes}

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

RANGE=low [-high]

The specific range of jobs that this device can select, if RANGE is also specified in the WS= list. The upper limit is the default value 2147483647. 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 loaded. Use commas to separate individual route codes and enclose the list in parenthesis if more than one route code is specified.

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

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 through the EBCDIC nodename can be selected for execution.

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

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.

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, specify a null parameter of (SYSaff=()) and do not specify SYSaff in the WS= list. You must specify the empty parentheses.

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

Specifying a minus sign (-) before the criterion causes that criterion to be removed from the list. Specifying a criterion that is not currently specified in the list adds it to the end of the list. 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.

Note:

1. You must always enclose the criterion or criteria in parentheses, for example, WS=(CLass).
2. If you specify more than one criterion, each must be separated by commas, for example, WS=(CLass,RANGE).
3. The slash (/) is not used for receiver criterion. All specifications are required to match and are assumed to be listed prior to a slash.
4. As with other work selection lists, priority for a criterion that specifies multiple values (Class, Routecde, and SYSaff) is in left to right priority order.

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

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 $HASP883 message displays the current settings of all the parameters on the OFF(n).JR initialization statement.

Offload receiver 1 selects only held jobs who's jobname is REPORT.