Offloading selected jobs and SYSOUT

Offloading selected jobs and SYSOUT from the JES2 spool to a sequential data set requires the operator to complete the following 5-step procedure:

Display the job output forms queue, information about active jobs, and the number of jobs queued on the current spool.
Display the offload device's characteristics and the status of its transmitters and receivers.
Set and verify the offload characteristics.
Start the offload device to begin offloading selected data.
Stop the offload device when all transmitters are inactive and the transmission is complete.

JES2 offloads selectable SYSOUT (ready data sets) by default if output disposition is specified in the SYSOUT transmitter work selection criteria (WS=OUTDisp). However, you can offload held SYSOUT data sets by specifying OFF(n).ST OUTDisp=HOLD|LEAVE.

The following explains each step in this procedure and the JES2 processing considerations that apply to offloading data selectively.

The spool offload facility supports selective offloading of pre-execution jobs and SYSOUT from the spool to offload data sets through the work selection (WS=) parameter. As devices select work selection criteria, so do spool offload devices. These work selection criteria are the same as those used by local and remote printers and punches to select work.

JES2 offloads all selectable work (ready data sets) by default, but can offload held data by specifying OUTDisp=(HOLD,LEAVE) on the OFF(n).ST initialization statement. Specify these selection criteria on the job transmitter and receiver statements during JES2 initialization. The 4 offload transmitter and receiver statements can be modified through $T operator commands.

Display the job output forms queue, information about active jobs, and the number of jobs queued on the current spool.
You can use SPOOL Display and Search Facility (SDSF) or the following JES2 commands to display the current status of jobs on spool. Performing this task before offloading ensures that you have data to compare when you display the contents of the new spool after reloading.
Command

Console Display

$D N

Displays job queue information about jobs processed on the spool offload device.

$D F

Displays the job output forms queue.

$D OJ

Displays the output processing characteristics of individual job output elements.

$D Q

Displays the number of jobs on a queue and the percentage of spool use.

Note: Because the system is not quiesced, the status of jobs on spool can change before you begin offloading jobs.
To display the offload device's characteristics and the status of its transmitters and receivers, enter the command:
```
$D U,OFFLOAD1
```

To change work selection characteristics before transmitting jobs and SYSOUT to spool, enter the command:

$T OFF1.ST WS=(n)

where n is a work selection criterion.

The criteria that you can specify in a specific work selection (WS) list is individualized for the offload job and SYSOUT receivers and the offload job and SYSOUT transmitters. See Table 1 for the complete list.

You can tailor your offload procedure to filter based upon the work selection of your choice. If you want to offload SYSOUT based on queue selection, enter:

$T OFF1.ST WS=(Q/)

To offload SYSOUT based on job selection, enter:

$T OFF1.ST WS=(JOB/)

To offload jobs based on job name, enter:

$T OFF1.JT WS=(JOBNAME/)

If you find these selection criteria inadequate, you can create installation-defined work selection criteria through the $WSTAB macro. (See z/OS JES2 Macros for details on using this macro and extending this function.) You are limited, however, to a maximum of 19 WS criteria (USER and JES2 combined) for any one device.

Table 1. WS Criteria for Spool Offload Devices
Job Receivers	Job Transmitters	SYSOUT Receivers	SYSOUT Transmitters
CLass CReator Hold JOBname RANGE Routecde SYSaff	CLass CReator Hold JOBname LIMit Priority RANGE Routecde SYSaff Volume	Burst CReator FCB\|C FLash\|O Forms Hold JOBname OUTDisp PRMode Queue RANGE Routecde UCS\|T Writer	Burst CReator FCB\|C FLash\|O Forms Hold JOBname LIMit OUTDisp Priority PRMode Queue RANGE Routecde UCS\|T Writer Volume

To begin offloading jobs and SYSOUT, enter the command:
```
$S OFFLOAD1,TYPE=TRANSMIT
```
Note: To change work selection characteristics after you have begun transmitting jobs and SYSOUT to spool, enter the command:
```
$Z OFFLOAD(1)
```
It halts an offload device temporarily, without deallocating the offload data set.
To stop the offload device when the job and SYSOUT transmitters are inactive and the transmission is complete, enter the command:
```
$P OFFLOAD1
```