Canceling the current activity *CANCEL,devname

Function

Use this command to cancel the current activity which can be the setting up of a device for a data set or the processing of a data set.

For a 3800 printer, the current job is the job whose output is visible at the transfer station. The display includes the number of pages remaining in the printer's buffer for all data sets that had been sent to the printer at the time you entered the command. This count can include data sets from more than one job. If the copy of the data set that is visible at the transfer station fills the entire buffer and more records remain to be sent to the printer, the display includes a second count: the approximate number of records remaining to be sent. For a 3800 printer running in FSS mode, the approximate number of pages and records remaining for the data set visible at the transfer station are displayed.

Pressing the Cancel key on a 3800 printer has the same effect as entering the *CANCEL,devname command.

Use the *CANCEL command to cancel WTR and reset the output service diagnostic mode.

Syntax

>>-+-*CANCEL-+--+-,--devname-------+--+-------------+----------->
   '-*C------'  +-,--+---+--devnum-+  '-,--+---+--D-'   
                |    '-⁄-'         |       '-/-'        
                '-,--J--=--jobno---'                    

>--+------+----------------------------------------------------><
   +-,--G-+   
   +-,--J-+   
   +-,--P-+   
   '-,--T-'   

Parameters

devname or devnum or /devnum or J=jobno

Specifies the output device or the job number to be stopped. Always use the JNAME of a device when selecting devices that are not directly connected to a channel. The device number can be a 3-digit or 4-digit hexadecimal number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd
dddd
/ddd
/dddd

where ddd and dddd represent the device numbers.

D

Specifies that the diagnostic mode is to be set. This causes message IAT7006 to be issued for each data set that is selected for processing. In addition, message IAT7060 is issued when the *CALL, *START, *RESTART, and *CANCEL commands are processed. The diagnostic mode remains active until it is reset.

Use the D parameter on the *CANCEL,devname command to stop the current activity immediately and set the diagnostic mode. See z/OS JES3 Diagnosis for a description of the data displayed during diagnostic mode.

/D

Specifies that the diagnostic mode is to be reset (turned off). The /D parameter can be specified on any *CALL, *START, *RESTART, or *CANCEL writer command.

G

Specifies that only the output destined for this device for the current job be canceled immediately.

J

Specifies that all the output of the appropriate type (that is, PRT or PUN) for the current job be canceled immediately.

P

Specifies that the approximate number of pages or records remaining to be written for the current copy of the data set be displayed.

Use the P parameter on the *CANCEL,devname command to stop the current writer activity and determine the current page or record position of a data set being processed by a writer.

T

Specifies that the writer stop automatically once the current activity is canceled.

Result

JES3 issues message IAT7060.