Cancel print job
Component: | SPOOL |
Functional area: | Controlling spoolout job |
Domain: | SPOOL-PRINT-SERVICES |
Privileges: | STD-PROCESSING |
Function
The CANCEL-PRINT-JOB command cancels print jobs on any server in any cluster. Depending on the user group, print jobs can be canceled in local clusters or in both local and remote clusters.
Privileged functions
RSO device administrators and spool and cluster administrators can cancel any job scheduled for printing on any device that they manage. For more information on these user groups see also the manuals “RSO” [32], “SPOOL” [43] and “Distributed Print Service” [10].
9025/9026-RENO printers
After a PRINT-DOCUMENT command, the print job can be in one of three possible statuses. The CANCEL-PRINT-JOB command affects the print job in different ways, depending on the status of the print job:
Status of the print job | Effects of the CANCEL-PRINT-JOB command |
|---|---|
Queued | Print job is deleted and nothing is printed |
File transfer from BS2000 to 9025/9026-RENO memory started but not yet completed | Spoolin is interrupted: that part of the print file which has already been transferred or has passed through spoolin is printed; the print job is canceled |
File transfer from BS2000 to 9025/9026-RENO memory completed, spoolout started or already completed | Command has no effect; no error message; the print job is executed in full |
Format
CANCEL-PRINT-JOB | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
JOB-IDENTIFICATION = *TSN(...) / *SERVER-TSN(...) / *MONJV(...) / *FOREIGN(...) / *SYSTEM-FILE(...)
Type of job identification.
JOB-IDENTIFICATION = *TSN(...)
The job is identified by its local task sequence number (TSN).
TSN = <alphanum-name 1..4>
TSN of the job to be canceled.
CLUSTER-NAME = *LOCAL-CLUSTER / <alphanum-name 1..8>
Name of the cluster in which the print job is being processed. If a cluster name is specified, the specified TSN is the TSN on the gateway host in the specified remote cluster. Only a BS2000 cluster can be specified.
JOB-IDENTIFICATION = *SERVER-TSN(...)
The print job is identified by its TSN on the server. Only print jobs in the local cluster can be addressed in this way.
TSN = <alphanum-name 1..4>
TSN of the job to be canceled on the server.
SERVER-NAME = <alphanum-name 1..8>
Name of the server on which the print job can be addressed by means of its TSN.
JOB-IDENTIFICATION = *MONJV(...)
The print job is identified by its MONJV.
MONJV = <filename 1..54 without-gen-vers>
This operand can be used to address a print job by means of its MONJV, provided the specified MONJV is accessible on the host at which the command is issued. Only print jobs in the local cluster can be addressed in this way.
JOB-IDENTIFICATION = *FOREIGN(...)
The print job is identified by a non-BS2000 job name.
IDENTIFICATION = <c-string 1..255 with-lower-case>
This operand can be used to address print jobs being processed in a cluster of UNIX-based systems.
CLUSTER-NAME = <alphanum-name 1..8>
Name of the cluster in which the print job is being processed. See the “Distributed Print Service” manual [10].
JOB-IDENTIFICATION = *SYSTEM-FILE(...)
Identifies the system files *SYSOUT and *SYSLST. This operand resets an earlier PRINT-DOCUMENT ...,START-PROCESSING=*AT-FILE-CLOSING/integer command. The system file is then printed with the default attributes, not those specified for in the PRINT-DOCUMENT command.
NAME = list-poss(16): *SYSOUT / *SYSLST(...)
Specifies the system files *SYSOUT and/or *SYSLST.
NAME = *SYSLST(...)
Specifies the *SYSLST system file.
SYSLST-NUMBER = *STD / <integer 1..99>
The default SYSLST file or one or more numbers of the desired SYSLST files can be specified.
Return codes
(SC2) | SC1 | Maincode | Meaning/Guaranteed messages |
|---|---|---|---|
0 | CMD0001 | No errors | |
2 | 0 | SCP1034 | No response from operator |
2 | 0 | SPS0178 | File lock cannot be canceled |
2 | 0 | SPS0455 | MONJV processing error |
2 | 0 | SPS0464 | JV subsystem not loaded |
2 | 0 | SPS0469 | MONJV validity problem |
2 | 0 | SCP0892 | TSN not found or command processing not permitted |
4 | 32 | SCP0974 | Memory error or system error. Command rejected |
4 | 64 | SCP0976 | Invalid operand value |
6 | 128 | CMD2241 | DPRINTCL subsystem not loaded |
1 | 128 | SPS0266 | SPOOL subsystem not loaded/SPOOL task not available |
Notes
Users must use this command to cancel print jobs they have sent to a different cluster (since local copies are not kept of print jobs sent to a different cluster). For example, the command /CANCEL-PRINT-JOB (TSN=12AB,CLUSTER-NAME=C1) cancels job 12AB in cluster C1.
For their own print jobs in their own cluster, users can also use the existing command CANCEL-JOB, since there will be at least one local copy of such print jobs.
The cluster administrator can cancel any print job in his or her own cluster. For example, to cancel a print job with a TSN of 1234 on remote server S1 that was issued on a remote client (i.e. when there is no local copy on the host at which the cluster administrator issues the CANCEL-PRINT-JOB command), the cluster administrator issues the command CANCEL-PRINT-JOB *SERVER-TSN(1234,S1).
A server need not be specified to cancel a print job in a remote cluster. In the remote cluster, copies of all the print jobs that come back from the local cluster are kept on a selected server that receives all print jobs from remote clusters.