Parameter Description for OFFLOAD(n)

ARCHIVE=ONE | ALL

Specifies which offload devices JES2 prevents from reselecting jobs for offload that have a disposition of DISP=KEEP or DISP=HOLD.

ONE: JES2 prevents a specific offload device from reselecting a job with DISP=KEEP or DISP=HOLD when it was offloaded by that device.
ALL: JES2 prevents all offload devices from reselecting a job with DISP=KEEP or DISP=HOLD when it is offloaded by any device.

Modification: $T OFFLOAD(n) operator command (if the device is drained).

CRTIME

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).

Modification: $TOFFLOAD(n) operator command.

DSName=jxxx...x

Specifies the offload data set used to define this offload device. The data set name can be 1- to 44-alphanumeric characters. A period (.) or a hyphen (-) can be included for any character except the first. This parameter does not support the use of a generation data set (GDG) or a partitioned data set (PDS). See “Spool Offload Facility” in z/OS JES2 Initialization and Tuning Guide for more information concerning offload data set allocation.

Modification: $T OFFLOAD(n) operator command (if the device is drained).

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

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.

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

Modification: $T OFFLOAD(n) operator command (if the device is drained).

PROTECT=Yes|No

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

Modification: $T OFFLOAD(n) operator command (if the device is drained).

RETPD=nnnn | 30

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

Modification: $T OFFLOAD(n) operator command (if the device is drained).

TRACE=Yes|No

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

Modification: $T OFFLOAD(n) operator command.

UNIT=({hhhh | /hhhh | nnnn | cccccccc},nn | 1)

hhhh | /hhhh

Specifies a 3- or 4-digit hexadecimal device number. Device numbers can be specified by any of the following formats:

UNIT=hhh
UNIT=/hhh
UNIT=/hhhh

where hhh and hhhh represent the device numbers. A slash (/) must precede a 4-digit device number.

nnnn

Specifies a device type.

cccccccc

Specifies a 1- to 8-character group name assigned to the device or group of devices that are to be used to receive non-cataloged spool offload data sets.

nn

Specifies the number (1-59) of devices, that are allocated to mount the volumes containing the offload data set. If you do not specify a second value, JES2 allocates 1 device.

Note: If enough devices are not available to satisfy the value specified here, the allocation will fail.

Generally, the medium used for spool offload is tape; however, the assigned unit can be a DASD device. If a DASD device is specified, and the data set specified does not exist, then the size of the data set is determined from your installation's default as specified on the SPACE parameter in the ALLOCxx parmlib member. However, the default size will likely be too small for an offload data set. Therefore, when using DASD as your spool offload media, IBM suggests that the data set be pre-allocated with a space parameter value large enough to hold the data being offloaded. If the data set becomes full, the spool offload subtask will abnormally end.

UNIT= is only honored on an OFFLOADn TYPE=TRANSMIT operation. Therefore, if you do not specify UNIT=, the offload data set must be pre-cataloged if JES2 is to dynamically allocate a new data set. If the data set is not pre-cataloged and UNIT= is not specified, no data set is allocated.

For an OFFLOAD TYPE=RECEIVE operation, JES2 requires that the data set be pre-cataloged regardless of the UNIT= specification because the catalog information overrides the UNIT= specification.

Modification: $T OFFLOAD(n) operator command (if the device is drained).

The second value, nn, specifies the number (1-59) of devices that will be allocated to the offload data set.

VALIDATE=Yes

|No

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

Yes: JES2 drains the offload device and issues $HASP595 OFFLOADn ERROR READING FIRST RECORD - DRAINING OFFLOAD DEVICE.
No: JES2 continues to read from the offload data set, but skips to the next job header. JES2 then issues $HASP595 OFFLOADn ERROR READING FIRST RECORD - SKIPPING FOR JOB HEADER. The offload device continues to read from the offload data set and passes the records to the appropriate receiver(s). However, the receiver(s) discards all records until it encounters a job header at which time it continues to process jobs normally.

Modification: $T OFFLOAD operator command (if the device is drained).

VOLS=nnn|255

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

Note: If your spool offload data set is to be a system-managed DASD data set, specify a VOLS= value no greater than 59.

Modification: $T OFFLOAD operator command (if the device is drained).