PSM Interface › $PSCALL OPT=HOLD

$PSCALL OPT=HOLD

Holds a print request.

&CONTROL NOSHRVARS
-EXEC $PSCALL   OPT=HOLD 
                REQ=n

Holds a print request so that it is not printed until released. The request to be held must have a status of BUILD or QUEUED.

Operands:

OPT=HOLD

Specifies that a print request is to be held.

REQ=n

Specifies the number of the print request to be held.

Return Codes:

0

$PSCALL completed successfully.

4

$PSCALL completed successfully. The request was denied. &SYSMSG is set to an error message and &$PSFDBK is set to one of the following values:

1

User not authorized for the request.

8

Print request not found on the spool.

21

The print request is locked by the system or another user.

22

Status of the print request was not BUILD or QUEUED.

8

An error occurred. &SYSMSG is set to an error message.

Example: OPT=HOLD

&CONTROL NOSHRVARS 
-EXEC $PSCALL OPT=HOLD REQ=2345