Parameter Description for OFF(n).SR
- 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 burst specification, for loading.
- 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).SR operator command.
- CReator=cccccccc
- Specifies the 1- to 8-character userid whose output is to be loaded
from the offload data set. Wildcard specifications are allowed on
this parameter. If you allow this parameter to default, JES2 can load
jobs for all userids.
Modification: $T OFF(n).SR 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 loading.
Modification: $T OFF(n).SR operator command.
- FLash|O=xxxx
- 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.
Modification: $T OFF(n).SR operator command.
- Forms=xxxxxxxx,...,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 the forms specification, for loading.
Modification: $T OFF(n).SR operator command.
- Hold=Yes|No
- 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.
- Yes
- Specifies that output from held jobs can be selected by this device.
- No
- Specifies that output from held jobs cannot be selected by this device.
Modification: $T OFF(n).SR operator command.
- JOBname=jccccccc
- Specifies the 1- to 8-character job name of the job(s) to be loaded
from 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 loading.
Modification: $T OFF(n).SR operator command.
- 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. Use commas to separate individual modification
characteristics and enclose the list in parenthesis if more than one
is specified.
- Burst=Yes|No
- Specifies whether job output from this device is to be burst (page-separated).
- FCB=xxxx
- Specifies a valid forms control buffer image or carriage control tape for output loaded from the offload data set.
- FLash|O=xxxx
- Specifies a valid flash name for output loaded from the offload data set.
- Forms=xxxxxxxx,...,xxxxxxxx
- Specifies a valid forms name for output loaded from the offload data set.
- Hold=Yes|No
- Specifies whether all jobs are held after loading.
- Yes
- Specifies that all jobs are held before output processing.
- No
- Specifies that all jobs are released before output processing.
- OUTDisp=disposition
- 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=vvvvvvvv
- Specifies a valid processing mode for output loaded from the offload data set.
- Queue=c1[...cn]
- Specifies a valid output class (A-Z, 0-9) for all output loaded from the offload data set. 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 reloaded.
- Routecde=rtcode
- Specifies a destination for all output loaded from the offload data set.
- UCS|T=xxxx
- Specifies a valid print train or character arrangement table for all output loaded from the offload data set.
- Writer=xxxxxxxx
- Specifies an external writer name for output loaded from the offload data set.
- 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).SR operator command.
- 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. If there is a piece of output with an OUTDISP of WRITE, the offloader will select it.
Default: The offload receiver will select on WRITE, HOLD, KEEP, and LEAVE.
Modification: $T OFF(n).SR 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 its processing mode, for loading.
Modification: $T OFF(n).SR operator command.
- Queue=c1[...cn]
- Specifies the class(es) for which output can be selected. As many
as 15 classes can be specified.
If you allow this parameter to default, JES2 can select all output, regardless of its class, for loading.
Modification: $T OFF(n).SR operator command.
- 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.
Modification: $T OFF(n).SR operator command.
- Routecde=rtcode
- 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.*
- *
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 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.
Modification: $T OFF(n).SR operator command.
- 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.
- Yes
- Indicates that this receiver is started when a corresponding $S OFFLOAD(n) 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.
Modification: $S OFF(n).SR operator command or $T OFF(n).SR operator command.
- UCS|T=xxxx
- 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.
Modification: $T OFF(n).SR 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 its writer, for loading.
Modification: $T OFF(n).SR 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 selection criterion is not listed here, the criterion
is not considered during work selection.
Note:
- A slash is not required in this work selection list; all specifications are required to match and are assumed to be listed before a slash. You can code a slash if criteria are listed before it or use WS=(/) to specify a null work selection list.
- As with other work selection lists, priority for a criterion which specifies multiple values (as do Queue, PRMode, and Routecde) is in left to right priority order.
- Burst
- Specifies that the current burst specification is required.
- CReator
- Specifies that the creator is preferred.
- FCB|C
- Specifies that the current FCB specification is required. “C” can be used rather than FCB; however, its use is not recommended.
- FLash|O
- Specifies that the current flash specification is preferred. “O” can be used rather than FL or FLASH; however, its use is not recommended.
- Forms
- Specifies that the current forms specification is preferred.
- Hold
- Specifies that the current hold specification is considered as a selection criterion.
- JOBname
- Specifies that the current job name must match the job name specified for this device.
- 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 receiver.
- PRMode|PMD
- Specifies that the current data set processing mode must match.
- Queue
- Specifies that the data set's output class must match one of the current output classes set for this device.
- RANGE
- Specifies that the current job number must be within the range specified for this device.
- Routecde
- Specifies that the data set's route code must match one of the currently set route codes. If specified, an exact match is required and priority order is indicated from left to right.
- UCS|T
- Specifies that the data set's UCS specification must match the UCS set for this device.
- Writer
- Specifies that the writer name of the output data set must match the writer name currently set for this device.
Note: Embedded comments are not allowed within the WS= parameter specification.Modification: $T OFF(n).SR operator command.