Previous Topic: $PSCALL OPT=PUT

Next Topic: $PSCALL OPT=RELEASE


$PSCALL OPT=QUEUE

Presents the Output Queue.

&CONTROL NOSHRVARS
-EXEC $PSCALL   OPT=QUEUE
              [ USERID={ userid | prefix* } ]
              [ PRINTER={ printer name | prefix* } ]

Presents the Output Queue showing print requests that are currently on the spool. When the Output Queue is terminated by the user entering the EXIT or RETURN command (or pressing the Function key to which those commands are assigned), control is returned to the NCL procedure that executed $PSCALL.

Operands:

OPT=QUEUE

Specifies the Output Queue is to be presented.

USERID={ userid | prefix* }

Specifies the user ID of the user whose print requests are to be displayed on the Output Queue. For the Output Queue to be displayed with print requests for users whose user ID starts with a particular prefix, specify the prefix followed by an asterisk (*).

PRINTER={ printer name | prefix* }

Specifies the PSM printer name, JES remote destination, or VTAM defined network name (LU name), at which print requests to be displayed on the Output Queue are to be printed. For the Output Queue to be displayed with print requests for printers which the name, JES remote destination, or VTAM defined network name, starts with a particular prefix, specify the prefix followed by an asterisk (*).

Return Codes:

&RETCODE = 0

$PSCALL completed successfully. &$PSFDBK may be set to the following value:

RETURN command entered (or the Function key to which it is assigned was pressed)

&RETCODE = 4

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

User not authorized for the request

&RETCODE = 8

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

Examples: OPT=QUEUE

&CONTROL NOSHRVARS 
-EXEC $PSCALL OPT=QUEUE
&CONTROL NOSHRVARS
-EXEC $PSCALL OPT=QUEUE USERID=ZXPSD
&CONTROL NOSHRVARS
-EXEC $PSCALL OPT=QUEUE USERID=ZXP*
&CONTROL NOSHRVARS
-EXEC $PSCALL OPT=QUEUE PRINTER=FLOOR5
&CONTROL NOSHRVARS
-EXEC $PSCALL OPT=QUEUE USERID=ZXPSD PRINTER=FLOOR5