$PSCALL OPT=CONFIRM

Presents the Confirm Printer panel and returns the entered details to the caller.

&CONTROL SHRVARS=($PS)
-EXEC $PSCALL     OPT=CONFIRM 
                [ USERID=userid ]

Confirms the printer name, number of copies, hold and keep settings required to satisfy a print request. The Confirm Printer panel is presented with the fields set to the values last used by the user.

You can modify any of the fields. The Printer Name field supports prompting. When you confirm the details by pressing Enter, the information is returned to the caller.

Operands:

OPT=CONFIRM: Specifies that the Confirm Printer panel is to be presented.
USERID=userid: Specifies the user ID of the user whose last used printing details are to be used to prime the fields on the Confirm Printer panel. The default is the user ID set in the system variable &USERID.

Return Codes:

0

$PSCALL completed successfully. The following variables are set:

&$PSPRTNAME: Printer name
&$PSCOPIES: Number of copies
&$PSHOLD: Hold setting, YES or NO
&$PSKEEP: Keep setting, YES or NO

4

$PSCALL completed successfully. The request was denied. &SYSMSG is set to an information message and &$PSFDBK is set to the following value:

23: CANCEL command was executed
8: An error occurred. &SYSMSG is set to an error message.

Examples: OPT=CONFIRM

& CONTROL SHRVARS =($PS)
-EXEC $PSCALL OPT=CONFIRM

&CONTROL SHRVARS =($PS)
-EXEC $PSCALL OPT=CONFIRM USERID=USER01