lpstat - report line printer status information

lpstat outputs information about the current status of all requests submitted with lp.

Nonprivileged users are shown information relating only to print jobs submitted under their own login names.
Privileged users ($TSOS) are shown information relating to all print jobs.

Currently printing jobs and jobs which have already been submitted can be aborted or canceled with cancel.

Syntax

lpstat[ -drst][ -a[list]][ -c[list]][ -o[list]][ -p[list]][ -u[list]][ ID....]

No option specified

lpstat prints the following information of all the user's print requests made by lp on standard output:

• the job number assigned by lp when invoked,

• the login name of the job originator,

• the size of the file to be printed (in bytes),

• if a job is currently printing, the name of the RSO printer on which the job is being running.

Options

list can be a list of items separated from one another by a comma, or a quoted list of items separated from one another by a comma or one or more blank characters, or combiniton of both.

-a[list]

Write the acceptance status of destinations for output request.
The list argument is a list of intermixed RSO printer names and class names.

-c[list]

Write the class names and their members.
The list argument is a list of class names.

-d

Write the system default destination for output request in the following format:

system default destination: *CENTRAL

-o[list]

Write the status of output requests.
The list argument is a list of intermixed RSO printer names, class names and request IDs.

-p[list]

Write the status of printers.
The list argument is a list of RSO printer names.

-r

Write the status of the line printer request scheduler:

scheduler is running

-s

Write a status summary, including the status of the line printer scheduler, the system default destination, a list of class names and their members:

scheduler is running
system default destination: *CENTRAL

-t

Write all status information (see Example 2).

-u[list]

Write the status of output requests for users.
The list argument is a list of login names.
As a nonprivileged user you are only allowed to specify your own login name.

ID

A request ID, as returned by lp.

Variable

TZ

Defines the time zone within date and time specifications.

Locale

The following environment variables affect the execution of lpstat:

LANG

Provide a default value for the internationalization variables that are unset or null. If LANG is unset of null, the corresponding value from the implementation-specific default locale will be used. If any of the internationalization variables contains an invalid setting, the utility will behave as if none of the variables had been defined.

LC_ALL

If set to a non-empty string value, override the values of all the other internationalization variables.

LC_CTYPE

Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single- as opposed to multi-byte characters in arguments and input files), the classification of characters as upper- to lower-case, and the mapping of characters from one case to the other.

LC_MESSAGES

Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.

LC_TIME

Determine the format of date and time strings output when displaying line printer status information with the -a, -o, -p, -t or -u options.

NLSPATH

Determine the location of message catalogs for the processing of LC_MESSAGES.

Example 1

Information of all submitted and currently running printing jobs:

$ lpstat

TSN-6XDZ QM212JNA 12837 *ACT LE *CENTRAL HP

Example 2

Output of all status information

$ lpstat -t
scheduler is running

system default destination: *CENTRAL

DROS336  accepting requests
DRS03    accepting requests

DR9001   accepting requests

DR9022   accepting requests
EMDRS001 accepting requests

:

:

TC12G002 accepting requests

DROS336   9001RP     idle

DRS03     9022RP     idle

EMDRS003  9022RP     stopped
EMDRS016  9022RP     idle

LB        HP-PRINT   printing

LC        HP-PRINT   printing
LD        HP-PRINT   printing

LE        HP-PRINT   printing

MDRS05    9001RP     idle
:

TSN-6XK4 QM212JNA 329853 *ACT LE       *CENTRAL HP

See also

lp, cancel