Suspend active spoolout job
Component: | SPOOL |
Functional area: | Controlling spoolout job |
Domain: | SPOOL-PRINT-ADMINISTRATION |
Privileges: | STD-PROCESSING |
Routing code: | O |
Function
The HOLD-PRINT-JOB command suspends or resumes an active spoolout job.
The following comments apply to replay jobs assigned with START-TAPE-REPLAY and the operand value OUTPUT-MODE=*DIRECT:
The tape containing the output file is positioned at the desired point, and output is resumed immediately via the specified device.
Current output is stopped. All the spoolout jobs are written back to the SR.vsn file and provided with information relevant for resuming interrupted output. Resumption may then only be initiated by means of the START-TAPE-REPLAY command.
This forwarding cannot be put on hold by /HOLD-PRINT-JOB. The command may therefore now only be used for RSO printers and virtual devices.
Privileged functions
RSO device administrators and spool and cluster administrators can suspend or resume any print job scheduled for printing on any device that they manage. For more information on these user groups see the manuals “RSO” [32], “SPOOL” [43] and “Dprint” [10].
Format
HOLD-PRINT-JOB | ||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
DEVICE-NAME = <alphanum-name 1..8>
RSO device name of the printer on which the SPOOLOUT job is to be suspended.
DEVICE-NAME = <alphanum-name 2..2>
This specification can no longer be used from BS000 OSD/BC V11.0 onwards.
RESUME-CONDITION = *IMMEDIATE / *BY-PRIORITY(...) / *BY-OPERATOR
The spoolout job is to be resumed immediately, resumed after a delay or suspended.
RESUME-CONDITION = *IMMEDIATE
The spoolout job is to be resumed immediately.
RESUME-CONDITION = *BY-PRIORITY(...)
The spoolout job is to be resumed after a delay.
PRIORITY = <integer 30..255>
Priority for the delayed resumption of the spoolout job.
PRIORITY = *UNCHANGED
The spoolout job is placed in the job queue with its original priority (TYPE 4).
RESUME-CONDITION = BY-OPERATOR
The spoolout job is to be suspended until a RESUME-SPOOLOUT command is issued.
RESTART-POSITION =
Determines the point from which the file is to be output in the event of a restart. The restart point for a particular printer after a printer fault must not be confused with the CHECKPOINT-INTERVAL value from the SPOOL parameter file (M-S-P) which is the restart point after a SPOOL or system crash.
RESTART-POSITION = *BEGIN-OF-SPOOLOUT
The spoolout job is to be repeated from the file start.
RESTART-POSITION = *CURRENT-PAGE
The spoolout job is to be restarted from the page which was being output at the time of the interruption.
RESTART-POSITION = *LAST-CHECKPOINT
The spoolout job is to be restarted from the last checkpoint. System administration uses the MODIFY-SPOOL-PARAMETERS statement in the SPSERVE utility routine to define the number of print pages after which a checkpoint is to be set.
RESTART-POSITION = *PREVIOUS-CHECKPOINT
The spoolout job is to be restarted from the last checkpoint but one.
RESTART-POSITION = *PAGE(...)
The spoolout job is to be restarted from a particular page; all print pages preceding this one are skipped.
PAGE-NUMBER = <integer 1..10000000>
Number of the page.
RESTART-POSITION = BACK (...)
The spoolout job is to be restarted from the specified number of pages back from the current page.
PAGES = <integer 1..10000000>
Number of pages.
Note
With SPS jobs it is not permissible to specify the operand values *PAGE(...) and *BACK(...).
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | CMD0202 | Syntax error | |
1 | SCP0973 | Semantic error | |
32 | SCP0974 | System error. Command rejected | |
64 | SCP0975 | No authorization for command | |
64 | SCP0976 | Invalid operand value |