lpstat(1) MPE/iX Shell and Utilities lpstat(1)
______________________________________________________________________
NAME
lpstat -- show status of print queue(s).
SYNOPSIS
lpstat [-dst] [-a[list]] [-c[list]] [-o[list]] [-p[list]] [-
-u[list]] [queue_id ...]
DESCRIPTION
The lpstat utility shows the status of the print queue or queues,
specified by queue_id. On MPE/iX, queue_id may be a print job ID,
printer name, class name, or ldev. If no queue_id is given,
lpstat lists information for all of the printers on the system.
On MPE/iX, lpstat displays the print queue status in the follow-
ing format:
PRINTER:
Rank Owner File Job Pri Copies State SFN
1 LEE.SYS STDIN #O181 8 1 READY
The following list describes the contents of each column:
Rank
is the position of the print job in the queue.
Owner
is the user who submitted the job (in USER.ACCOUNT format).
File
is the name of the file submitted (truncated to eight charac-
ters). If the submitted file was read from standard input,
the string STDIN is displayed.
Job is the print job ID of the submitted job.
Pri is the priority of the print job (0-14).
Copies
is the number of copies to be printed.
State
is the current printing state. For details on the values
that can appear in this column, see the description of the
MPE/iX LISTSPF command in MPE/iX Commands Reference Manual
Volume I.
SFN is a three-character string that relates additional informa-
tional about the print job. If the spoolfile is to be saved,
an S appears as the first character of the string. Otherwise,
the first character is a space. If a message to change forms
is to be sent to the operator, an F appears as the second
character of the string. Otherwise, the second character is
1
lpstat(1) MPE/iX Shell and Utilities lpstat(1)
______________________________________________________________________
a space. If the spoolfile is incomplete, an N appears as the
third character of the string. Otherwise, the third charac-
ter is a space.
Also, the capabilities possessed by individual users determine
whether or not a given print request is displayed. For users
with SM or OP capability, lpstat displays all print requests.
For users with AM capability, lpstat displays all print requests
belonging to the same account as the user. For generic users and
those with capabilities other than SM, OP, or AM, lpstat displays
only that user's print requests.
Options
The options to lpstat change the information displayed. Many of
these options take an optional list as an arguments. If speci-
fied, this list must not be separated from the option by a space
and can be in one of two forms:
a,b,c,d
where each element is delimited by a comma; or
"a,b c d"
where each element is delimited by a comma or white space. In
the second form, the list must be quoted to prevent interpreta-
tion by the shell.
lpstat accepts the following options:
-a[list]
displays the "acceptance" status of all printers with out-
standing requests. The optional list is a list of ldevs and
class names.
-c[list]
displays class names and their members. The optional list is
a list of class names.
-d displays the default destination for requests.
-o[list]
lists the current status of all output requests. The
optional list is a list of ldevs, class names, and print job
IDs.
-p[list]
printer status. The optional list is a list of printer
names.
-s displays a summary showing the status of each printer, the
default destination, and the class names and their members.
2
lpstat(1) MPE/iX Shell and Utilities lpstat(1)
______________________________________________________________________
-t displays all status information. This is the same as speci-
fying -a, -o, -p, and -s.
-u[list]
displays the list of all requests, by user. The optional
list is a list of login names. Login names are specified in
the USER.ACCOUNT format.
DIAGNOSTICS
Possible exit status values are:
0 Successful completion.
1 An error occurred.
2 An error occurred, resulting in a usage message. This is most
commonly caused by an invalid command line option or argument.
Message: could not get list of print requests
Cause: An MPE/iX Architected Interface Facility (AIF) error
occurred.
Action: Consult the MPE/iX Architected Interface Facility:
Operating System Reference Manual or consult your sys-
tem administrator.
Message: no spool devices found with print requests
Cause: There are no spool devices with active print requests
or there are no spool devices.
Action: Consult your system administrator.
Message: dev: spool device not found
Cause: The system does not have this spool device.
Action: Ensure that you have specified the correct spool device
or consult you system administrator.
Message: print_ID: no such print request id
Cause: This print request does not exist.
Action: Ensure that you have specified the correct print
request.
Message: dev: no such device with print requests
Cause: The system does not have this spool device.
Action: Ensure that you have specified the correct spool device
or consult you system administrator.
Message: user: no spoolfiles for user or unknown user
Cause: There are no spoolfiles for the specified user or the
specified user is unknown to the system.
Action: Ensure that you have specified the user correctly.
Message: no print requests
Cause: There are no print requests spooled for the specified
printer.
3
lpstat(1) MPE/iX Shell and Utilities lpstat(1)
______________________________________________________________________
Action: Ensure that you have specified the correct printer.
PORTABILITY
x/OPEN Portability Guide 4.0.
Some traditional implementations of lpstat do not support class
names.
NOTE
This implementation of lpstat is only a front-end to an existing
line printer subsystem.
SEE ALSO
cancel(1), lp(1), lpalt(1)
4