Halting a tape reader *CANCEL,TR

Function

Use the *CANCEL,TR command to halt reading immediately. If this is used to halt a hot reader, the input is halted but the reader is not deactivated unless the KN parameter is included; thus, the *CANCEL command can also be used to change the parameters specified on the *START or *CALL command.

If an optional parameter is not specified, the value for that parameter defaults to the value specified on the *CALL command or on the most recent *START or *CANCEL command that modified that parameter.

Syntax

>>-+-*CANCEL-+--+-,--TR------------+--+-------+--+-------+------>
   '-*C------'  +-,--devname-------+  +-,--HN-+  +-,--KN-+   
                '-,--+---+--devnum-'  '-,--H--'  '-,--K--'   
                     '-⁄-'                                   

>--+-------------+---------------------------------------------><
   '-,--P--=--nn-'   

Parameters

TR or devname or devnum or /devnum

Specifies the reader to be halted. If more than one reader of the same type is currently active, use devname or devnum or /devnum to ensure that the proper reader is affected. 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.

Note: If more than one tape reader DSP is running, use devnum, /devnum or devname to stop a specific DSP.

H or HN

Specifies that the control-card processor created with the *CANCEL command be placed in hold (H) or allowed to process those jobs already completely entered (HN).

K or KN

Specifies that the hot reader remain allocated (K) or be completely halted (KN).

P=nn

Specifies the scheduling priority of the JES3 control-card processor job without affecting the priorities of the individual jobs being read in. Valid values are 00 through 15.

Example

*C,TR,P=12