$T OFF(n).SR - Set offload SYSOUT receiver characteristics
Function
To specify the work selection and processing characteristics of one or more indicated offload SYSOUT receivers.
One or more parameters on this command accepts wild cards. Parameter descriptions will note that.
- 1 prmode can be coded up to 8 times
- 2 form can be coded up to 8 times
Parameters
- n [-m | *]
- The subscript defining the offload SYSOUT 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 SYSOUT receivers with offload devices. The asterisk character (*) can be used to specify the first or last offload SYSOUT receiver 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.
- Burst=[No|Yes]
- The
burst specification for this device.
- No
- Only output that is not to be bursted can be selected, if Burst is also specified in the WS= list.
- Yes
- Only output that is to be bursted (page-separated) can be selected, if Burst is also specified in the WS= list.
- 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.
- FCB|C=fcb
- The 1 to 4 alphanumeric or special character ($ # @) character identifier of a particular forms control buffer image or carriage control tape. If FCB is also specified in the WS= list, only those output data sets with this FCB specification can be selected. If the FCB characteristic is not a criterion for output selection, specify a null parameter of (FCB=) and do not specify FCB in the WS= list.
- FLash|O=flash
- The 1 to 4 alphanumeric or special character ($ # @) character flash name for this device. If FLash is also specified in the WS= list, only those output data sets with this flash name can be selected. If the FLash characteristic is not a criterion for output selection, specify a null parameter of (FLash=) and do not specify FLash in the WS= list.
- Forms=form
- The
1 to 8 alphanumeric or special character ($ # @) character forms name
for this device. If Forms is also specified in the WS= list, only
those output data sets with this forms name can be selected. You can
also specify wild cards on this parameter. See Using wildcards for additional information. You may
specify up to 8 forms.
If the Forms characteristic is not a criterion for output selection, specify a null parameter of (Forms=) and do not specify Forms in the WS= list.
- Hold=[No|Yes]
- The
Hold specification for this device.
- Y
- Only held post-execution jobs can be selected, if Hold is also specified in the WS= list.
- N
- Only non-held post-execution jobs can be selected, if Hold is also specified in the WS= list.
- JOBname=jobname
- A
1 to 8 character jobname. If JOBname is also specified in the WS=
list, only those post-execution jobs with this jobname can be selected.
You can also specify wild cards on this parameter. See Using wildcards for additional information.
If jobname is not a criterion for job selection, specify a null parameter of (JOBname=) and do not specify JOBname in the WS= list.
- MOD=
- Specifies
modifications to the indicated characteristics of post-execution jobs
and output data sets that are selected for reloading. These modifications
are assigned during the reload process. If more than one of the following
parameters is specified, each must be separated by commas and the
list must be enclosed in parentheses.
- Burst=[No|Yes]
- Specifies whether (Y) or not (N) reloaded output is to be burst (page-separated). A null parameter of (Burst=) specifies that the Burst specification is not to be modified.
- FCB=fcb
- A 1 to 4 character identifier of the forms control buffer image or carriage control tape assigned to output when reloaded. A null parameter of (FCB=) specifies that the FCB specification is not to be modified.
- FLash|O=flash
- The 1 to 4 character flash name assigned to output when reloaded. A null parameter of (FLash=) specifies that the Flash specification is not to be modified.
- Forms=forms
- The 1 to 8 character forms name assigned to output when reloaded. A null parameter of (Forms=) specifies that the Forms specification is not to be modified.
- Hold=[No|Yes]
- Specifies whether post-execution jobs are to be held (Y) or released (N) once reloaded. A null parameter of (Hold=) specifies that the Hold specification 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 statement. If you specify Y, a notification message is sent when a post-execution job is reloaded from the offload data set. If you specify N, no notification message is sent.
- OUTDisp=[H|HOLD|K|KEEP| L|LEAVE|W|WRITE]
- The disposition of the output selected by this offload SYSOUT receiver is changed to the disposition that you specify on the OUTDISP operand.
- PRMode=prmode
- The 1 to 8 alphanumeric character processing mode assigned to output when reloaded. You can also specify wild cards on this parameter. See Using wildcards for additional information. A null parameter of (PRMode=) specifies that the PRMode specification is not to be modified.
- Queue=queue
- The SYSOUT class (A-Z, 0-9) assigned to output when reloaded. A null parameter of (Queue=) specifies that the output class is not to be modified.
- Routecde=routecde
- Specifies a destination for a
piece of output. When used as a subparameter of MOD=, Routecde= specifies the destination(s) for
output you have selected. The value for all routing numbers can range from 1 to 32767. You can also
specify wild cards on this parameter. See Using wildcards for additional information.
For specification requirements, see Route codes. 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 jobs are to be run at the local node.
- destid
- Indicates that jobs are to be run at the specified node(s). You can specify this location by an alias for the name of a node. If destid is specified alone, it refers to both the node and the remote.
- Nnnnn|nodename
- Indicates that jobs are to be run at the specified node(s). You can specify a node using the decimal node identifier or an EBCDIC nodename.
- NnnnnRmmmm|node.remote|node.userid
- Indicates routing to the remote Rmmmm at the node Nnnnn. Rmmmm can also be specified as RMmmmm or RMTmmmm.
- Ummmm
- Indicates special local routing.
- node.destid
- Indicates a destination at the specified node. The destid refers to both the node and the remote. The node specified in the destid must be the same as the node portion of the route code. If the number of the remote is reassigned, you can use the destid to send to this node.
- remote
- Indicates routing to a remote. Remote can be specified in any of the following ways:
- LOCAL|ANYLOCAL
- Indicates that jobs are to be run at the local node.
- Rmmmm
- Indicates routing to the specified remote. Rmmmm can also be specified as RMmmmm or RMTmmmm. The value specified for mmmm can range from 1 to 32767.
- destid
- Indicates routing to a destid referring to a remote.
- userid
- Indicates routing to a valid TSO userid, or a user* (where * means all local, remote, special local unit, and userid output at the specified node).
- node.*
- Indicates that the nodename is to be modified to the specified node name, but the remote node will remain the same.
- T|UCS=ucs
- A 1 to 4 character identifier of the print train or character arrangement assigned to output when reloaded. A null parameter of (UCS=) specifies that the UCS specification is not to be modified.
- Writer=writer
- A 1 to 8 character external writer name assigned to output when reloaded. A null parameter of Writer= specifies that the writer name is not to be modified.
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.
Processing Considerations
- If you specify a null value for a characteristic that is currently specified in the work selection (WS=) list, for example, Burst=(), 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 output.
- If you are uncertain of the characteristics in effect, enter the $D or $D U command for the particular offload SYSOUT 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 for more information on using the ROUTE *ALL command.
Messages
The $HASP885 message displays the current settings of all the parameters on the OFF(n).SR initialization statement.
Example
1 $t off1.sr,outdisp=(leave,keep),prmode=page,
ws=(prmode/)
HASP885 OFF1.SR STATUS=STARTABLE,OUTDISP=(LEAVE,KEEP),HOLD=,JOBNAME=,
NOTIFY=NO,MOD=(BURST=,OUTDISP=,FCB=,FLASH=,
FORMS=,HOLD=,PRMODE=,QUEUE=,ROUTECDE=,
UCS=,WRITER=),NOTIFY=NO,RANGE=(J1,32767),
ROUTECDE=(),START=YES,WS=(Q,OUTD,PRM/),BURST=,
FCB=,FLASH=,FORMS=(,,,,,,,),PRMODE=(PAGE),QUEUE=,
UCS=,WRITER=
Offload SYSOUT receiver 1 selects only held output with a processing mode specification of PAGE.