Canceling a DJ DSP *CANCEL,DJ

Function

You can stop a dump job (DJ) DSP at any time by entering a *CANCEL,DJ command. JES3 requests that a DJ DSP be canceled at the successful completion of an *START command. You also must cancel your current DJ DSP (or invoke a new DJ DSP) if you want to switch modes.

If dump job is running in server mode, the DJ DSP does not accept *CANCEL commands while the dump job server address space is initializing and allocating the tape device. If you attempt to cancel DJ at this point, JES3 issues message IAT7130 (*C DJ REJECTED, DJ NOT In USE).

If dump job is running in server mode, a *CANCEL DJ command will automatically cause the dump job server address space to end or be canceled.

Syntax

>>-+-*CANCEL-+--+-,--DJ------------+---------------------------><
   '-*C------'  +-,--+---+--devnum-+   
                |    '-⁄-'         |   
                +-,--DJdevnum------+   
                '-,--J--=--jobno---'   

Parameters

DJ

This form of cancel can only be used if only one DJ DSP is active. If there are multiple DJ DSPs active, you must use one of the other forms of *CANCEL.

devnum

Specifies the device number of the DJ DSP to be canceled. The device number can be a 3-digit or a 4-digit hexadecimal number and may be preceded by a slash (/). If dump job is running in server mode (SERVER=YES), you cannot cancel it by device number; you must use one of the other forms of *CANCEL.

DJdevnum

This is another way to cancel a DJ DSP by device number. The device number can be a 3-digit or a 4-digit hexadecimal number and must not be preceded by a slash (/). Unlike *CANCEL,devnum, this form of *CANCEL is allowed when dump job is running in server mode.

J=jobno

Specifies the job number of the DJ DSP to be canceled.

Rule

Use care when canceling a DJ DSP while dumping or restoring a DJC network. Because DJ processing stops immediately, the network can only be partially dumped or restored.