$PSCALL OPT=MODIFY

Modifies a print request that is on the spool.

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

Presents the print request panel allowing the request to be modified. You can modify the destination, number of copies, keep flag and priority, if authorized. You cannot modify a request with the status of WAIT, PRINTING, BUILD-PRT, or DIRECT-ERR.

When the print request panel is terminated by the user entering the FILE or CANCEL command (or pressing the function key to which those commands are assigned), control is returned to the NCL procedure that executed $PSCALL.

Operands:

OPT=MODIFY: Specifies that a print request is to be modified.
REQ=n: Specifies the number of the print request to be modified.

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:

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 PRINTING, BUILD-PRT or DIRECT-ERR

&RETCODE = 8

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

Example: OPT=MODIFY

&CONTROL NOSHRVARS 
-EXEC $PSCALL OPT=MODIFY REQ=23