z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$D OFFn.ST - Display offload SYSOUT transmitter

z/OS JES2 Commands
SA32-0990-00

Function

To display offload SYSOUT transmitter associated with an individual offload device.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$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:
  1. 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=

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014