Function

To display the offload SYSOUT receiver associated with an individual offload device.

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

Burst

Specifies the burst specification for which output is selected.

If you allow this parameter to default, JES2 can select all output, regardless of burst specification, for loading.

No

Indicates that the printed output is not to be burst into separate sheets.

Yes

Indicates that the printed output is to be burst into separate sheets.

CReator

Specifies the 1– to 8–character userid whose output is to be loaded from the offload data set.

FCB|C=fcb

Specifies the 1– to 4–character name forms control image buffer or carriage control tape.

If you allow this parameter to default, JES2 can select all output, regardless of its FCB, for loading.

FLash|O=flash

Specifies a 1– to 4–character flash name for output loaded from the offload data set.

If you allow this parameter to default, JES2 can select all output, regardless of the flash specification, for loading.

Forms=forms

Specifies the 1 to 8 character forms specification for which output is selected.

Hold={No|Yes}

Specifies whether output for held jobs are to be reloaded.

If you allow this parameter to default and HOLD is not in the work selection list, JES2 can select all output, whether held or not, for reloading. If you allow this parameter to default and HOLD is in the work selection list, no output can be reloaded.

No

Specifies that output from held jobs cannot be selected by this device.

Yes

Specifies that output from held jobs can be selected by this device.

JOBname=jobname

Specifies the 1– to 8–character job name of the job(s) to be loaded from the offload data set.

MOD

Specifies those characteristics of the post-execution jobs that are to be automatically modified when post-execution jobs are loaded from the offload data set.

Burst=Yes|No

Specifies whether job output from this device is to be burst (page-separated).

FCB=fcb

Specifies a valid forms control buffer image or carriage control tape for output loaded from the offload data set.

FLash|O=flash

Specifies a valid flash name for output loaded from the offload data set.

Forms=forms

Specifies a valid forms name for output loaded from the offload data set.

Hold=No|Yes

Specifies whether all jobs are held after loading.

No

Specifies that all jobs are released prior to output processing.

Yes

Specifies that all jobs are held prior to output processing.

OUTDisp

Specifies that output selected by this offload SYSOUT receiver should have its disposition changed to this value. You can specify one of the following valid dispositions:

HOLD|H

Hold the output. JES2 does not process the output until you either change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to WRITE.

Note: This specification is honored when the output reaches the destination node.

KEEP|K

Process the output, then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.

LEAVE|L

JES2 does not process the output until you change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to KEEP.

WRITE|W

Process the output then purge it.

This modification defaults to the current disposition.

PRMode=prmode

Specifies a valid processing mode for output loaded from the offload data set.

Queue=queue

Specifies a valid output class (A-Z, 0-9) for all output loaded from the offload data set. Specify Queue=, (that is, null) and do not code Queue in the WS= list on this statement; this allows all defined classes to be reloaded.

Routecde

Specifies a destination for all output loaded from the offload data set.

UCS|T=ucs

Specifies a valid print train or character arrangement table for all output loaded from the offload data set.

Writer=writer

Specifies an external writer name for output loaded from the offload data set.

NOTify={No|Yes}

Specifies whether a notification message is sent to the userid specified on either the JOB statement or the /*NOTIFY control statement.

No

Indicates that a notification message is not sent when a post-execution job is offloaded to the offload data set.

Yes

Indicates that a notification message is sent when a post-execution job is offloaded to the offload data set.

OUTDisp=(disposition[,...disposition])

Specifies the disposition(s) that the output must have in order to be eligible for processing by this offload receiver. The operator can specify one to four of the following valid dispositions:

HOLD|H

Hold the output. JES2 does not process the output until you either change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to WRITE.

KEEP|K

Process the output, then keep a copy of it on spool. After processing, the disposition of this output becomes LEAVE.

LEAVE|L

JES2 does not process the output until you change the disposition to WRITE or KEEP, or release the output. When the output is released, the disposition changes to KEEP.

WRITE|W

Process the output then purge it.

See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for more information about specifying output disposition and how JES2 determines output disposition defaults.

PRMode=(vvvvvvvv[,vvvvvvvv...])

Specifies the processing mode for which output can be selected. Use commas to separate individual processing modes and enclose the list in parenthesis if more than one processing mode is specified. Wildcard specifications are allowed on this parameter.

If you allow this parameter to default, JES2 can select all output, regardless of its processing mode, for loading.

Queue=queue

Specifies the classes that output can be selected for. As many as 36 classes can be specified.

If you allow this parameter to default, JES2 can select all output, regardless of its class, for loading.

RANGE={J | S | T} nnnnnn[-nnnnnn] | J1-2147483647

Specifies the range (1-2147483647) of IDs for jobs (J), started tasks (S), or TSUs (T) of those jobs that can be loaded from the offload data set. 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

Specifies a destination for a piece of output. Its meaning depends on whether it is used as a subparameter of MOD= or not:

• If it is not used as a subparameter of MOD=, Routecde= means that output sent to the specified destination(s) can be selected.
• If Routecde= is used as a subparameter of the MOD= parameter, it specifies the destination(s) to which you want this output to go.

The maximum size of a route code is 18 characters. Use parentheses if more than one route code is specified. You can specify a route code in any of the forms listed. Note that a slash, a colon, or a matched set of parentheses can be used instead of a period anywhere a period appears as a separator in a route code. For example, you could specify node.remote, node:remote, node/remote, or node(remote) for an explicit route code. Wildcard specifications are allowed on this parameter for userids only.

• node
• NnnnnnRmmmmm
• Ummmmm
• destid
• node.remote
• node.user
• node.Ummmmm
• node.destid
• remote
• user
• node.*
• *

statement in the initialization stream. Explanations of the different forms of specifying route codes follow:

LOCAL|ANYLOCAL

Indicates routing to the local node.

Nnnnnn

Indicates routing to the node specified by its binary node identifier. The value specified for nnnnn can range from 1 to 32767.

destid

Indicates routing to the specified node(s). You can specify the name of a node, or an alias for the name of a node, for destid.

nodename

Indicates routing to the node specified by its EBCDIC node name.

NnnnnnRmmmmm

Indicates routing to the remote Rmmmmm at the node Nnnnnn. If the node is the local node, Nnnnnn may be omitted. Values specified for both nnnnn and mmmmm can range from 1 to 32767.

Note: NnnnnnRmmmmm is restricted to a maximum of eight characters. Therefore, the combined number of digits nnnnn plus mmmmm cannot exceed six. Valid combinations are NnnnnnRmm, NnnnRmmm, NnnRmmmmm.

Ummmmm

Indicates special local routing. The special routing numbers range from 1 to 32767.

destid

Indicates routing to the specified node(s). If destid is specified alone, it refers to both the node and the remote.

node.remote

Indicates routing to a remote at the specified node.

node.user

Indicates routing to a user at the specified node.

node.Ummmmm

Indicates special local routing at the specified node. The special routing numbers range from 1 to 32767.

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.

remote

Indicates routing to a remote. Remote can be specified in any of the following ways:

Rmmmmm

Indicates routing to the specified remote. Rmmmmm can also be specified as RMmmmmm or RMTmmmmm. The value specified for mmmmm can range from 1 to 32767.

destid

Indicates routing to a destid referring to a remote.

user

Indicates routing to a specified userid.

If Routecde= is not used as a subparameter of MOD=, a generic userid can be specified. A generic userid is a userid that ends in an asterisk (*), and refers to all userids that begin with any characters preceding the *. Note that the * can only be specified in the last position of the userid.

A userid at the local node must be in the form of a valid TSO/E userid. It must begin with an alphabetic (A-Z) or a special character ( @ # or $ ) and the remaining characters can be alphabetic, numeric, or special characters. Userids at non-local nodes may contain any characters except separators (a period, a colon, a slash, or a set of parentheses), delimiters (a comma, or a blank), or an asterisk (*).

node.*

If Routecde= is not used as a subparameter of MOD=, node.* indicates that all output destined for the specified node is selected, regardless of the userid or remote specified. If Routecde= is used as a subparameter of MOD=, node.* indicates that the node name is to be modified to the specified node name, but the remote node will remain the same.

*

If Routecde= is not used as a subparameter of MOD=, * indicates that all output specified for the local node is selected, regardless of the userid or remote specified. If Routecde is used as a subparameter of MOD=, * indicates that the node number will be changed to the local node. However, the remote number originally specified will remain the same.

STATUS

Specifies that the status of the offload sysout receiver is to be displayed.

START=Yes | No

Specifies the initial status of this receiver when its corresponding offload device is started for a receive operation, that is when a $S OFFLOAD(n),TYPE=RECEIVE command is issued.

No

Indicates that this receiver is not started when a corresponding $S OFFLOAD(n) command is issued. This receiver can later be started individually by issuing the $S OFF(n).SR command and stopped, as required, by issuing the $P OFF(n).SR command.

Yes

Indicates that this receiver is started when a corresponding $S OFFLOAD(n) command is issued.

Modification: $S OFF(n).SR operator command or $P OFF(n).SR operator command.

UCS | T=ucs

Specifies the 1 to 4 character print train (universal character set) for output to be dumped.

If you allow this parameter to default, JES2 can select all output, regardless of its UCS, for loading.

Writer=writer

Specifies the 1 to 8 character writer name for which output can be selected.

If you allow this parameter to default, JES2 can select all output, regardless of its writer, for loading.

WS

Specifies the selection criteria for this device. If a criterion is specified in the work selection list, output selection is based on the corresponding parameter specification on this initialization statement.

Authority Required

This command requires display authority. The description of the $T INTRDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

Scope

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

Messages

The $HASP885 message is issued in response to this command.