|
Function To display offload SYSOUT transmitter
associated with an individual offload device.
Syntax
>>-$D--OFF--+------------------------------------+--.ST--------->
+-n--+-----------+-------------------+
| '- ---+-m-+-' |
| '-*-' |
| .-,------------------------. |
| V | |
'-(------+-n-+--+-----------+---+--)-'
'-*-' '- ---+-m-+-'
'-*-'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+-------------------------------+---------------------------><
'-| Display limiting keywords |-'
Display limiting keywords
|--+----------+--+------------+--+---------+--+------------+---->
'-,--Burst-' '-,--CReator-' '-,--DISP-' '-,--+-C---+-'
'-FCB-'
>--+--------------+--+----------+--+---------+------------------>
'-,--+-FLash-+-' '-,--Forms-' '-,--Hold-'
'-O-----'
>--+------------+--+----------+--+-----------+------------------>
'-,--JOBname-' '-,--LIMit-' '-,--NOTify-'
>--+------------+--+---------+--+-----------+--+----------+----->
'-,--OUTDisp-' '-,--PLIM-' '-,--PRMode-' '-,--Queue-'
>--+----------+--+-------------+--+----------+--+-----------+--->
'-,--RANGE-' '-,--Routecde-' '-,--START-' '-,--STATUS-'
>--+------------+--+-----------+--+-----------+--+-------+------|
'-,--+-T---+-' '-,--Volume-' '-,--Writer-' '-,--WS-'
'-UCS-'
Selection limiting keywords
|--+----------------------------------+------------------------->
'-,--+---+--Burst--+-=--+--+-----+-'
'-/-' '-^=-' +-No--+
'-Yes-'
>--+------------------------------------+----------------------->
'-,--+---+--DISP--+-=--+--+-DELETE-+-'
'-/-' '-^=-' +-HOLD---+
'-KEEP---'
>--+--------------------------------+--------------------------->
'-,--+-+---+--C---+--+-=--+--fcb-'
| '-/-' | +-^=-+
'-+---+--FCB-' +->--+
'-/-' '-<--'
>--+------------------------------------+----------------------->
'-,--+-+---+--FLash-+--+-=--+--flash-'
| '-/-' | +-^=-+
'-+---+--O-----' +->--+
'-/-' '-<--'
>--+----------------------------------------------------+------->
'-,--+---+--Forms--+-=--+--+-forms-----------------+-'
'-/-' '-^=-' | .-,-----------. |
| V (1) | |
'-(----------forms-+--)-'
>--+---------------------------------+-------------------------->
'-,--+---+--Hold--+-=--+--+-----+-'
'-/-' '-^=-' +-No--+
'-Yes-'
>--+------------------------------------+----------------------->
'-,--+---+--JOBname--+-=--+--jobname-'
'-/-' +-^=-+
+->--+
'-<--'
>--+-----------------------------------+------------------------>
'-,--+---+--NOTify--+-=--+--+-No--+-'
'-/-' '-^=-' '-Yes-'
>--+--------------------------------+--------------------------->
'-,--+---+--Queue--+-=--+--queue-'
'-/-' +-^=-+
+->--+
'-<--'
>--+----------------------------------+--+------------------+--->
'-,--+---+--START--+-=--+--+-No--+-' '-,--+---+--STATUS-'
'-/-' '-^=-' '-Yes-' '-/-'
>--+--------------------------------+--------------------------->
'-,--+-+---+--T---+--+-=--+--ucs-'
| '-/-' | +-^=-+
'-+---+--UCS-' +->--+
'-/-' '-<--'
>--+----------------------------------+-------------------------|
'-,--+---+--Writer--+-=--+--writer-'
'-/-' +-^=-+
+->--+
'-<--'
Notes: - forms can be coded up to 8 times
Parameters - n [-m | *]
- The
subscript defining the offload SYSOUT transmitters 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 transmitters with offload devices. The
asterisk character (*) can be used to specify the first or last offload
SYSOUT transmitters 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}
- 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. - 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 offloaded to the
offload data set.
- 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.
- C|FCB=fcb
- Specifies the 1 to 4 character name
forms control image buffer or carriage control tape.
- FLash|O=flash
- Specifies the 1 to 4 character name
of a particular flash for which output is selected.
- Forms=forms
- Specifies
the 1 to 8 character forms specification for which output is selected.
- Hold={No|Yes}
- 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. - No
- Specifies that output for held jobs cannot be transmitted to the
offload data set.
- Yes
- Specifies that output for held jobs can be transmitted to the
offload data set.
- JOBname=jobname
- Specifies
the 1 to 8 character job name of the job(s) to be offloaded to the
offload data set. Wildcard specifications are allowed on this parameter.
- LIMit
- Specifies
the amount of output (in records) for which output can be selected.
- 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
- Specifies
the disposition(s) that the output must have in order to be eligible
for processing by this offload transmitter.
- PLIM
- Specifies
the amount of output (in pages) for which output can be selected.
- PRMode
- Specifies
the processing mode for which output can be selected.
- Queue=queue
- Specifies
the classes (A-Z, 0-9) that output can be selected for. All 36 classes
can be specified. 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.
- RANGE={J | S | T} nnnnnn[-nnnnnn ] | J1-99999
- 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.
- Routecde
- 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.
The maximum size of a route code is 18 characters.
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.
- START={No|Yes}
- 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.
- 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.
- Yes
- Indicates that this transmitter is started when a corresponding
$S OFFLOAD(n) command is issued.
- STATUS
- Specifies
that the status of the offload SYSOUT transmitter is to be displayed.
- UCS|T=ucs
- Specifies the 1 to 4 character print
train (universal character set) for output to be transmitted.
- Volume
- 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.
- Writer=writer
- Specifies
the 1 to 8 character writer name for which output can be selected.
- 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. If the criterion
is not listed here, the criterion is not considered during work selection.
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 $HASP886 message is issued
in response to this command.
Example 1 $d off1.st
$HASP886 OFF1.ST STATUS=STARTABLE,CREATOR=,DISP=DELETE,
$HASP886 OUTDISP=(),HOLD=,JOBNAME=,NOTIFY=NO,RANGE=(J1,
$HASP886 65534),ROUTECDE=(),START=YES,VOLUME=(,,,),
$HASP886 WS=(OUTD/),BURST=,FCB=,FLASH=,FORMS=(,,,,,,,),
$HASP886 LIMIT=(0,*),PLIM=(0,*),PRMODE=(),QUEUE=,UCS=,
$HASP886 WRITER=
|