$D OFFLOAD

Function

To display JES2 offload devices.

Syntax


>>-$D--OFFLOAD--+--------------------------------------+-------->
                +-nn--+------------+-------------------+   
                |     '- ---+-mm-+-'                   |   
                |           '-*--'                     |   
                |    .-,--------------------------.    |   
                |    V                            |    |   
                '-(------+-nn-+--+------------+---+--)-'   
                         '-*--'  '- ---+-mm-+-'            
                                       '-*--'              

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+------------+--+---------------------------+--+--------+---->
   '-,--ARCHIVE-'  |               .-RESET---. |  '-,--DSN-'   
                   '-,--CRTIME--=--+-RESTORE-+-'               

>--+----------+--+------------+--+----------+--+-----------+---->
   '-,--LABEL-'  '-,--PROTECT-'  '-,--RETPD-'  '-,--STATUS-'   

>--+---------+--+----------+--+---------+--+-------------+------>
   '-,--TYPE-'  '-,--TRACE-'  '-,--UNIT-'  '-,--VALIDATE-'   

>--+---------+--------------------------------------------------|
   '-,--VOLS-'   

Selection limiting keywords

|--+---------------------------+-------------------------------->
   |               .-RESET---. |   
   '-,--CRTIME--=--+-RESTORE-+-'   

>--+----------------------------+------------------------------->
   '-,--+---+--DSN--+-=--+--dsn-'   
        '-/-'       +-^=-+          
                    +->--+          
                    '-<--'          

>--+----------------------------------+------------------------->
   '-,--+---+--LABEL--+-=--+--+-AL--+-'   
        '-/-'         '-^=-'  +-AUL-+     
                              +-BLP-+     
                              +-NL--+     
                              +-NSL-+     
                              +-SL--+     
                              '-SUL-'     

>--+------------------------------------+----------------------->
   '-,--+---+--PROTECT--+-=--+--+-No--+-'   
        '-/-'           '-^=-'  '-Yes-'     

>--+--------------------------------+--+------------------+----->
   '-,--+---+--RETPD--+-=--+--retpd-'  '-,--+---+--STATUS-'   
        '-/-'         +-^=-+                '-/-'             
                      +->--+                                  
                      '-<--'                                  

>--+----------------------------------+------------------------->
   '-,--+---+--TRACE--+-=--+--+-No--+-'   
        '-/-'         '-^=-'  '-Yes-'     

>--+--------------------------------------+--------------------->
   '-,--+---+--TYPE--+-=--+--+----------+-'   
        '-/-'        '-^=-'  +-RECEIVE--+     
                             '-TRANSMIT-'     

>--+-------------------------------------+---------------------->
   '-,--+---+--VALIDATE--+-=--+--+-No--+-'   
        '-/-'            '-^=-'  '-Yes-'     

>--+------------------------------+-----------------------------|
   '-,--+---+--VOLS--+-=--+--vols-'   
        '-/-'        +-^=-+           
                     +->--+           
                     '-<--'

Parameters

ARCHIVE

Specifies which offload devices JES2 prevents from scheduling jobs for offload.

CRTIME={RESET|RESTORE}

Specifies the creation time to be associated with jobs and output on reload.

RESET: Indicates that the time to be assigned is the time of the reload.
RESTORE: Indicates that the time to be assigned is the original creation time (before the data was offloaded).

DSN=dsn

Specifies the offload data set used to define the offload device.

LABEL={AL|AUL|BLP|NL|NSL|SL|SUL }

Specifies the type of label processing that is required for the tape that is to be allocated for a non-cataloged spool offload data set.

AL: American National Standard label
AUL: American National Standard label and American National Standard user-defined label
BLP: Bypass label processing
NL: No Label
NSL: Non-standard label
SL: IBM® Standard label
SUL: IBM standard label and user-defined label

PROTECT={No|Yes}

Specifies whether the spool offload data set requires System Authorization Facility (SAF) protection.

RETPD=retpd

Specifies the retention period (1-9999), in days, if the offload data set is to be retained.

STATUS

Indicates that the status of the offload device is to be displayed.

TRACE={No|Yes}

Displays whether trace records are to be cut for data read or written by this offload device. See specific trace ids for more information.

TYPE=}TRANSMIT|RECEIVE}

Indicates whether the offload device is in the process of offloading jobs to an offload data set (TYPE=TRANSMIT) or reloading jobs from an offload data set (TYPE=RECEIVE).

VALIDATE={No|Yes}

Specifies the action JES2 takes if it determines that the first record of the offload data set is not LRECL=80.

VOLS=vols

Specifies the volume count (1-255) to be used for the spool offload data set.

Authority Required

For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

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

Example

 1   $DOFFLOAD1

$HASP882 OFFLOAD1  DSN=OFFLOAD.DATASET1,STATUS=DRAINED,
$HASP882           ARCHIVE=ONE,CRTIME=RESET,LABEL=SL,PROTECT=NO,
$HASP882           RETPD=30,TRACE=NO,UNIT=(161,1),VALIDATE=YES,
$HASP882           VOLS=255

JES2 provides information about offload devices.