 |
Function To specify the characteristics
of one or more indicated logical offload devices.
Syntax 
>>-$T--OFFLOAD--+-n--+-----------+-------------------+---------->
| '- ---+-n-+-' |
| '-*-' |
| .-,------------------------. |
| V | |
'-(------+-n-+--+-----------+---+--)-'
'-*-' '- ---+-n-+-'
'-*-'
>--+---------------------------------+-------------------------->
'-| Selection limiting keywords |-'
>--+---------------------------+-------------------------------><
'-| Modification keywords |-'
Modification keywords
|--+------------------------+--+---------------------------+---->
'-,--ARCHIVE--=--+-ALL-+-' | .-RESET---. |
'-ONE-' '-,--CRTIME--=--+-RESTORE-+-'
>--+-------------------+--+----------------------+-------------->
'-,--DSN--=--dsname-' '-,--LABEL--=--+-AL--+-'
+-AUL-+
+-BLP-+
+-NL--+
+-NSL-+
+-SL--+
'-SUL-'
>--+------------------------+--+-------------------+------------>
'-,--PROTECT--=--+-No--+-' '-,--RETPD--=--nnnn-'
'-Yes-'
>--+-----------------------------------------------+------------>
'-,--UNIT--=--+-+-devnum---+------------------+-'
| +-/devnum--+ |
| +-nnnn-----+ |
| +-cccccccc-+ |
| '-+-----+--' |
| '-,nn-' |
'-(--+-devnum---+--+-------+--)-'
+-/devnum--+ '-,--nn-'
+-nnnn-----+
+-cccccccc-+
'-+-----+--'
'-,nn-'
>--+----------------------+--+-------------------------+-------->
'-,--TRACE--=--+-No--+-' '-,--VALIDATE--=--+-No--+-'
'-Yes-' '-Yes-'
>--+------------------+-----------------------------------------|
'-,--VOLS--=--vols-'
Selection limiting keywords
|--+-------------------------------+---------------------------->
'-,----/----DSN--+-=--+--dsname-'
+-^=-+
+->--+
'-<--'
>--+----------------------------------+------------------------->
'-,----/----LABEL--+-=--+--+-AL--+-'
'-^=-' +-AUL-+
+-BLP-+
+-NL--+
+-NSL-+
+-SL--+
'-SUL-'
>--+------------------------------------+----------------------->
'-,----/----PROTECT--+-=--+--+-No--+-'
'-^=-' '-Yes-'
>--+-------------------------------+---------------------------->
'-,----/----RETPD--+-=--+--nnnn-'
+-^=-+
+->--+
'-<--'
>--+----------------------------------+------------------------->
'-,--+---+--TRACE--+-=--+--+-No--+-'
'-/-' '-^=-' '-Yes-'
>--+-------------------------------------+---------------------->
'-,----/----VALIDATE--+-=--+--+-No--+-'
'-^=-' '-Yes-'
>--+------------------------------+-----------------------------|
'-,----/----VOLS--+-=--+--vols-'
+-^=-+
+->--+
'-<--'
Parameters - (n)
- The
subscript defining the logical offload device(s) affected by this
command. The subscript can specify a numeric value (1-8) or a range
of values for offload devices defined by an OFFLOAD(n) initialization
statement. For information about specifying a range for this subscript,
see Command syntax conventions.
- ARCHIVE={ALL|ONE}
- Specifies
whether to allow the offload device to select a job whose disposition
is KEEP or HOLD.
If you specify ARCHIVE=ONE, that offload device
will not reselect a job whose disposition is KEEP or HOLD; if you
specify ARCHIVE=ALL, all offload devices are prevented from re-selecting
the job.
- 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=dsname
- The
1 to 44 character offload data set and member name. The use of a generation
data set (GDG) or a Partitioned Data Set (PDS) is not supported for
this parameter.
- LABEL = {AL|AUL|BLP|NL|NSL|SL|SUL}
- The
type of label processing required for the tape that is allocated for
a non-cataloged spool offload data set. The valid types and their
meanings are:
- Type
- Meaning
- 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 (Y) or not (N) the spool offload data set requires System
Authorization Facility (SAF) protection.
- RETPD=nnnn
- The
period (0-9999), in days, for which this offload data set is retained.
- UNIT=({devnum|/devnum|nnnn|cccccccc} [,nn])
-
- devnum|/devnum
- Specifies a 3-digit or 4-digit hexadecimal device number. A slash
(/) must precede a 4-digit device number.
- nnnn
- Specifies a device type.
- cccccccc
- Specifies a one to eight character group name assigned to the
device or group of devices that are to receive non-cataloged spool
offload data sets.
- nn
- Specifies a number, one to 59, that are allocated to mount the
volumes containing the offload data set.
- TRACE={No|Yes}
- Specifies whether trace records are to be cut for data read or
written by this offload device. See specific trace IDs for more information.
- VALIDATE={No|Yes}
- Specifies
whether JES2 should validate the logical record length of the first
(header) record read from the offload data set.
- If YES is specified, JES2 will validate the logical record length
of the first record.
- If NO is specified, JES2 will not validate the logical record
length of the first record. Specifying NO allows the offload device
to continue to read the offload data set, even if the first record
is not valid or missing.
- VOLS=vols
- Specifies
the volume count (1-255) to be used for the offload data set.
Authority Required This command requires system authority.
The description of the $T RDRnn command explains how to ensure that
the authority of the appropriate MVS™ system
command group is assigned.
This command requires control security
access authority. For a description of assigning command input authority,
see z/OS JES2 Initialization and Tuning Guide, SA32-0991.
Processing Considerations - This command is valid only if the indicated offload device is
drained.
- If you are uncertain of the characteristics in effect, enter the
$D or $D U command for the offload device in question.
Scope Single member. This command
will be in effect for this member only. There is no need to have this
command issued to all members of the MAS.
Messages The $HASP882 message displays
the current settings of all the parameters on the OFFLOAD(n) initialization
statement.
Examples 1 $t offload1,dsn=off.dump1,label=sl,unit=/c045
$HASP882 OFFLOAD1 DSN=OFF.DUMP1,STATUS=DRAINED,ARCHIVE=ONE,
$HASP882 CRTIME=RESET,LABEL=SL,PROTECT=NO,RETPD=30,
$HASP882 TRACE=NO,UNIT=(/C045,1),VALIDATE=YES,VOLS=255
The offload data set for OFFLOAD1 is named OFF.DUMP1.
The tape allocated for this data set requires IBM standard
label (SL) processing. 2 $t offload3,protect=yes,retpd=40
$HASP882 OFFLOAD3 DSN=OFF.DUMP3,STATUS=DRAINED,ARCHIVE=ONE,
$HASP882 CRTIME=RESET,LABEL=SL,PROTECT=YES,RETPD=40,
$HASP882 TRACE=NO,UNIT=(,1),VALIDATE=YES,VOLS=255
The offload data set named OFF.DUMP3 requires SAF protection.
JES retains this data set for 40 days.
|
z/OS JES2 Commands
Copyright IBM Corporation 1990, 2014