 |
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.
Syntax 
>>-$T--OFF--+-n--+-----------+-------------------+--.SR--------->
| '- ---+-m-+-' |
| '-*-' |
| .-,------------------------. |
| V | |
'-(------+-n-+--+-----------+---+--)-'
'-*-' '- ---+-m-+-'
'-*-'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+---------------------------+-------------------------------><
'-| Modification keywords |-'
Modification keywords
|--+----------------------+--+------------------------+--------->
'-,--Burst--=--+-----+-' '-,--CReator--=--creator-'
+-No--+
'-Yes-'
>--+--------------------+--+------------------------+----------->
'-,--+-C---+--=--fcb-' '-,--+-FLash-+--=--flash-'
'-FCB-' '-O-----'
>--+---------------------------------------+-------------------->
'-,--Forms--=--+-form-----------------+-'
| .-,----------. |
| V (1) | |
'-(----------form-+--)-'
>--+---------------------+--+------------------------+---------->
'-,--Hold--=--+-----+-' '-,--JOBname--=--jobname-'
+-No--+
'-Yes-'
>--+------------------------------------------------+----------->
| .-,-------------------------. |
| V | |
'-,--MOD--=--(----+-Burst--=--+-----+-----+-+--)-'
| +-No--+ |
| '-Yes-' |
+-FCB--=--fcb-----------+
+-+-FLash-+--=--flash---+
| '-O-----' |
+-Forms--=--forms-------+
+-Hold--=--+-----+------+
| +-No--+ |
| '-Yes-' |
+-OUTDisp--=--+-------+-+
| +-H-----+ |
| +-HOLD--+ |
| +-K-----+ |
| +-KEEP--+ |
| +-L-----+ |
| +-LEAVE-+ |
| +-W-----+ |
| '-WRITE-' |
+-PRMode--=--prmode-----+
+-Queue--=--queue-------+
+-Routecde--=--routecde-+
+-+-T---+--=--ucs-------+
| '-UCS-' |
'-Writer--=--writer-----'
>--+-----------------------+------------------------------------>
'-,--NOTify--=--+-No--+-'
'-Yes-'
>--+----------------------------------------------+-------------|
'-,--OUTDisp--=--+-+-H-----+-----------------+-'
| +-HOLD--+ |
| +-K-----+ |
| +-KEEP--+ |
| +-L-----+ |
| +-LEAVE-+ |
| +-W-----+ |
| '-WRITE-' |
| .-,---------------. |
| V (2) | |
'-(----------+-H-----+-+--)-'
+-HOLD--+
+-K-----+
+-KEEP--+
+-L-----+
+-LEAVE-+
+-W-----+
'-WRITE-'
Notes: - form can be coded up to 8 times
- OUTDisp can be coded up to 4 times
|--+----------------------------------------------+------------->
'-,--PRMode--=--+-prmode---------------------+-'
| .-,----------------. |
| V | |
'-(----+--------------+-+--)-'
| (1) |
'-------prmode-'
>--+--------------------+--------------------------------------->
'-,--Queue--=--queue-'
>--+-----------------------------------------+------------------>
'-,--RANGE--=--+-low--------------------+-'
'-(--low--+---------+--)-'
'-,--high-'
>--+--------------------------------------------+--------------->
'-,--Routecde--=--+-routecde---------------+-'
| .-,------------. |
| V | |
'-(----+----------+-+--)-'
'-routecde-'
>--+--------------------+--+----------------------+------------->
'-,--+-T---+--=--ucs-' '-,--Writer--=--writer-'
'-UCS-'
>--+----------------------------+-------------------------------|
'-,--WS--=--+-ws-----------+-'
| .-,--. |
| V | |
'-(----ws-+--)-'
Selection limiting keywords
|--+----------------------------------+------------------------->
'-,----/----Burst--+-=--+--+-----+-'
'-¬=-' +-No--+
'-Yes-'
>--+--------------------------------+--------------------------->
'-,--+---/----C---+--+-=--+--fcb-'
'---/----FCB-' +-¬=-+
+->--+
'-<--'
>--+------------------------------------+----------------------->
'-,--+---/----FLash-+--+-=--+--flash-'
'---/----O-----' +-¬=-+
+->--+
'-<--'
>--+---------------------------------------------------+-------->
'-,----/----Forms--+-=--+--+-form-----------------+-'
'-¬=-' | .-,----------. |
| V (2) | |
'-(----------form-+--)-'
>--+---------------------------------+-------------------------->
'-,----/----Hold--+-=--+--+-----+-'
'-¬=-' +-No--+
'-Yes-'
>--+------------------------------------+----------------------->
'-,----/----JOBname--+-=--+--jobname-'
+-¬=-+
+->--+
'-<--'
>--+-------------------------------------------------------------------+--|
| .-,-------------------------------------. |
| V | |
'-,--+---+--MOD--=--(----+---/----Burst--+-=--+--+-----+-----+-+--)-'
'-/-' | '-¬=-' +-No--+ |
| '-Yes-' |
+---/----FCB--+-=--+--fcb-----------+
| +-¬=-+ |
| +->--+ |
| '-<--' |
+-+---/----FLash-+--+-=--+--flash---+
| '---/----O-----' +-¬=-+ |
| +->--+ |
| '-<--' |
+---/----Forms--+-=--+--forms-------+
| +-¬=-+ |
| +->--+ |
| '-<--' |
+---/----Hold--+-=--+--+-----+------+
| '-¬=-' +-No--+ |
| '-Yes-' |
+---/----OUTDisp--+-=--+--+-------+-+
| '-¬=-' +-H-----+ |
| +-HOLD--+ |
| +-K-----+ |
| +-KEEP--+ |
| +-L-----+ |
| +-LEAVE-+ |
| +-W-----+ |
| '-WRITE-' |
+---/----PRMode--+-=--+--prmode-----+
| +-¬=-+ |
| +->--+ |
| '-<--' |
+---/----Queue--+-=--+--queue-------+
| +-¬=-+ |
| +->--+ |
| '-<--' |
+---/----Routecde--+-=--+--routecde-+
| +-¬=-+ |
| +->--+ |
| '-<--' |
+-+---/----T---+--+-=--+--ucs-------+
| '---/----UCS-' +-¬=-+ |
| +->--+ |
| '-<--' |
'---/----Writer--+-=--+--writer-----'
+-¬=-+
+->--+
'-<--'
Notes: - prmode can be coded up to 8 times
- form can be coded up to 8 times
|--+-----------------------------------+------------------------>
'-,----/----NOTify--+-=--+--+-No--+-'
'-¬=-' '-Yes-'
>--+--------------------------------+--------------------------->
'-,----/----Queue--+-=--+--queue-'
+-¬=-+
+->--+
'-<--'
>--+--------------------------------+--------------------------->
'-,--+---/----T---+--+-=--+--ucs-'
'---/----UCS-' +-¬=-+
+->--+
'-<--'
>--+----------------------------------+-------------------------|
'-,----/----Writer--+-=--+--writer-'
+-¬=-+
+->--+
'-<--'
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.
If the burst specification is not a criterion for
output selection, specify a null parameter of (Burst=) and do not
specify Burst 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.
If both held and non-held jobs are to be loaded,
specify a null parameter of (Hold=) and do not specify Hold 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, 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, 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, SA38-0666 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.
|
z/OS JES2 Commands
Copyright IBM Corporation 1990, 2014