Parameter Description for OFF(n).ST

Burst=Yes|No

Specifies the burst specification for which output is selected.

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

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

Modification: $T OFF(n).ST operator command.

CReator=cccccccc

Specifies the 1- to 8-character userid whose output is to be offloaded to the offload data set. Wildcard specifications are allowed on this parameter. If you allow this parameter to default, JES2 can select all output, regardless of its userid, for transmission.

Modification: $T OFF(n).ST operator command.

DISP=KEEP|HOLD|DELETE

Specifies the disposition of all output that is selected for offload to the offload data set as follows:

KEEP: Indicates that selected output will not change status after offloading to the offload data set.
HOLD: Indicates that selected held output remains held after offloading to the offload data set, or HOLD indicates that selected non-held output is marked as non-selectable after offloading to the offload data set. The operator must issue a $T O command to release jobs specified here as “HOLD”.
Note: Marking this output as non-selectable is not the same as putting a job in HOLD status.
DELETE: Indicates that the selected output groups are deleted after offloading to the offload data set.

Modification: $T OFF(n).ST operator command.

FCB|C=xxxx

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

Modification: $T OFF(n).ST operator command.

FLash|O=xxxx

Specifies the 1- to 4-character name of a particular flash for which output is selected.

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

Modification: $T OFF(n).ST operator command.

Forms=xxxxxxxx

Specifies the 1- to 8-character forms specification for which output is selected. Wildcard specifications are allowed on this parameter.

If you allow this parameter to default, JES2 can select all output, regardless of its forms specification, for transmission.

Modification: $T OFF(n).ST operator command.

Hold=Yes|No

Specifies whether SYSOUT for held jobs can be transmitted to the offload data set. Output for held jobs is output from jobs that the operator placed on hold using the $H command.

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 transmission. If you allow this parameter to default and HOLD is in the work selection list, no output can be transmitted.

Yes: Specifies that output for held jobs can be transmitted to the offload data set.
No: Specifies that output for held jobs cannot be transmitted to the offload data set.

Modification: $T OFF(n).ST operator command.

JOBname=jccccccc

Specifies the 1-8 character job name of the job(s) to be offloaded to the offload data set. Wildcard specifications are allowed on this parameter.

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

Modification: $T OFF(n).ST operator command.

LIMit=m|m-n|m-*

Specifies the amount of output (in records) for which output can be selected.

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

Default: If you omit this parameter, JES2 uses the default values m=0 and n=4294967295.

Modification: $T OFF(n).ST operator command.

NOTify=Yes|No

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

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

Modification: $T OFF(n).ST operator command.

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

Specifies the disposition(s) that the output must have in order to be eligible for processing by this offload transmitter. 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.
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, When the output is released, the disposition changes to KEEP.
WRITE|W: Process the output then purge it. If there is a piece of output with an OUTDISP of WRITE, the offloader will select it.

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

Default: Only output with dispositions WRITE and KEEP are selected by this offload transmitter if you do not specify values for OUTDisp=.

Modification: $T OFF(n).ST operator command

PLIM=m|m-n|m-*

Specifies the amount of output (in pages) for which output can be selected.

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

Default: If you omit this parameter, JES2 uses the default values m=0 and n=4294967295.

Modification: $T OFF(n).ST operator command.

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 the processing mode, for transmission.

Modification: $T OFF(n).ST operator command.

Queue=c1[...cn]

Specifies the class(es) (A-Z, 0-9) for which output can be selected. A maximum of 15 classes can be specified on this parameter. If you need to exceed the limit of 15 classes, specify Queue=, (that is, null) and do not code Queue in the WS= list on this statement; this allows all defined classes to be transmitted.

Modification: $T OFF(n).ST operator command.

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

Specifies the job ID range (J), started task range (S), or TSU range (T) of those jobs that can be loaded from the offload data set. Use the Jnnnnn form for job routing, the Snnnnn form for STC routing, and the Tnnnnn form for TSU job routing. 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.

Modification: $T OFF(n).ST operator command.

Routecde=rtcode

Specifies the one to four destination selection criteria for which output can be selected. If more than one route code is specified, enclose the list in parentheses.

If Routecde is not provided, this transmitter will be allowed to select ALL output.

The maximum size of a route code is 18 characters. Wildcard specifications are allowed on this parameter for userids only. You can specify a route code in any of the forms listed below. 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 a route code.

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

Note: If destid is used, it must be previously defined on a DESTID statement in the initialization stream. Explanations of the different forms of specifying route codes follow:

LOCAL | ANYLOCAL

Indicates that output routed to the local node is selected.

Nnnnnn

Indicates that output routed to the node specified by its binary node identifier is selected. The value specified for nnnnn can range from 1 to 32767.

destid

Indicates that output routed to the specified node(s) is selected. You can specify the name of a node, or an alias for the name of a node, for destid.

nodename

Indicates that output routed to the node specified by its EBCDIC node name is selected.

NnnnnnRmmmmm

Indicates that output routed to the remote Rmmmmm at the node Nnnnnn is selected. 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 that output for special local routing is selected. The special routing numbers range from 1 to 32767.

destid

Indicates that output routed to the specified node(s) is selected. If destid is specified alone, it refers to both the node and the remote.

node.remote

Indicates that output routed to a remote at the specified node is selected.

node.user

Indicates that output routed to a user at the specified node is selected.

node.Ummmmm

Indicates that output for special local routing at the specified node is selected. The special routing numbers range from 1 to 32767.

node.destid

Indicates that output to be routed to a destination at the specified node is selected. 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 that output routed to a remote is selected. Remote can be specified in any of the following ways:

Rmmmmm: Indicates that output routed to the specified remote is selected. Rmmmmm can also be specified as RMmmmmm or RMTmmmmm. The value specified for mmmmm can range from 1 to 32767.
destid: Indicates that output routed to a destid referring to a remote is selected.

user

Indicates that output routed to a userid, or a generic userid, is selected. 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 ( @ # $ ), and the remaining characters may 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.*

Indicates that all output destined for the specified node is selected, regardless of the userid or remote specified.

*

Indicates that all output specified for the local node is selected, regardless of the userid or remote specified.

If you allow this parameter to default, JES2 can select all output, regardless of the route code, for transmission.

Modification: $T OFF(n).ST operator command.

START=Yes|No

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

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

Modification: $S OFF(n).ST operator command or $T OFF(n).ST operator command.

UCS|T=xxxx

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

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

Modification: $T OFF(n).ST operator command.

Volume=(v1[,v2][,v3][,v4])|()

Specifies the 5- or 6-character volume serial of a volume containing a spool data set. Only jobs using tracks on this volume(s) can be selected for dumping. As many as four volumes can be specified. Use commas to separate individual volume IDs and enclose the list in parenthesis if more than one ID is specified.

Modification: $T OFF(n).ST operator command.

Writer=xxxxxxxx

Specifies the 1- to 8-character writer name for which output can be selected. Wildcard specifications are allowed on this parameter.

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

Modification: $T OFF(n).ST operator command.

WS= (Queue,OUTDisp)

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. If the criterion is not listed here, the criterion is not considered during work selection.

A slash can be used within the work selection list to further specify work selection. The use of a slash has the following general meaning: 1) those criterion listing several specifications is prioritized in a left to right priority order when placed to the left of the slash; 2) the placement of a criterion to the left of the slash indicates a required exact match of work selection and job criteria; and 3) placement of a criterion to the right of the slash indicates a preferred (but not required match) of work selection and job criteria. Exceptions to these rules are noted in the following descriptions.

Note: Embedded comments are not allowed within the WS= parameter specification.

Burst: Specifies that the current burst specification is preferred. If specified to the left of the slash, an exact match is required.
CReator: Specifies that the creator is preferred. If specified to the left of the slash, an exact match is required.
FCB|C: Specifies that the current FCB specification is preferred. If specified to the left of the slash, an exact match is required.
FLash|O: Specifies that the current flash specification is preferred. If specified to the left of the slash, an exact match is required.
Forms: Specifies that the current forms specification is preferred. If specified to the left of the slash, an exact match is required.
Hold: Specifies that the current hold specification is preferred. If specified to the left of the slash, an exact match is required.
JOBname: Specifies that the current job name is preferred. If specified to the left of the slash, an exact match is required.
LIMit: Specifies that the current output quantity limit is preferred. If specified to the left of the slash, output to be transmitted must fall within the specified range.
This subparameter has no effect as a work selection value for files received from a node that does not provide a page count for its files. For more information, see the sending node's reference documentation.
OUTDisp: Specifies that the disposition of the output must match the disposition specified on the OUTDisp= parameter in order for the output to be selected by this SYSOUT transmitter.
Priority: Specifies that JOE priority is considered. The higher the priority value, the higher priority this criterion receives. The priority specification receives greater importance relative to its left to right placement in the criteria string.
The offload SYSOUT transmitter uses priority to select the best output group. Then, all output groups in the same job that meet the required selection criteria are offloaded together, regardless of priority. Priority is not used to order JOEs within a job on the offload data set.
PRMode|PMD: Specifies that one of the current process modes must match. If specified to the left of the slash, an exact match is required and priority order is indicated from left to right. If specified to the right of the slash, an exact match is still required; however, no priority order is indicated.
Queue: Specifies that the current class specification must match. If specified to the left of the slash, an exact match is required and priority order is indicated from left to right. If specified to the right of the slash, an exact match is still required; however, no priority order is indicated.
RANGE: Specifies that the current job range is preferred. If specified to the left of the slash, the current job number must be within the range specified for this device.
Routecde: Specifies that one of the current route codes must match. If specified to the left of the slash, an exact match is required and priority order is indicated from left to right. If specified to the right of the slash, an exact match is still required; however, no priority order is indicated.
UCS|T: Specifies that the current universal character set is preferred. If specified to the left of the slash, an exact match is required.
Volume: Specifies that one of the currently specified volumes must match. If specified to the left of the slash, an exact match is required and priority order is indicated from left to right. If specified to the right of the slash, an exact match is still required; however, no priority order is indicated.
Writer: Specifies that the current writer name is preferred. If specified to the left of the slash, an exact match is required.

Modification: $T OFF(n).ST operator command.