Offloading selected jobs and SYSOUT
- 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.
- 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:
where n is a work selection criterion.$T OFF1.ST WS=(n)
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:
It halts an offload device temporarily, without deallocating the offload data set.$Z OFFLOAD(1)
- To stop the offload device when the job and SYSOUT transmitters
are inactive and the transmission is complete, enter the command:
$P OFFLOAD1