Previous Topic: $PSCALL OPT=QUEUE

Next Topic: Banner Exit


$PSCALL OPT=RELEASE

Releases a held print request.

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

To release a print request for printing that is held on the spool. The request to be released must have a status of BUILD-HELD, HELD, or HELD-ERROR.

Operands:

OPT=RELEASE

Specifies that a print request is to be released for printing.

REQ=n

Specifies the number of the print request to be released.

Return Codes:

&RETCODE = 0

$PSCALL completed successfully.

&RETCODE = 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

18

Print request not found on the spool

21

Print request locked by the system or another user

22

Status of the print request was not BUILD-HELD, HELD or HELD-ERROR

&RETCODE = 8

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

Example: OPT=RELEASE

&CONTROL NOSHRVARS 
-EXEC $PSCALL OPT=RELEASE REQ=4555