Commands Reference, Volume 3

lpstat Command

The lpstat command includes information for lpstat on a POWER-based platform and the System V Print Subsystem lpstat command on the POWER-based and Itanium-based platforms.

lpstat Command on POWER-based Platform

Purpose

Displays line printer status information.

Syntax

lpstat [ -aList ] [ -cList ] [ -d ] [ -oList ] [ -pList ] [ -r ] [ -s ] [ -t ] [ -uList ] [ -vList ] [ -W ]

Description

The lpstat command displays information about the current status of the line printer.

If no flags are given, lpstat prints the status of all requests made by the lp command.

Flags can appear in any order and can be repeated. Some flags take an optional list as a parameter. Enter the list as either a list of items separated by commas, as in lpstat -aQueue1,Queue2, or as a list of items enclosed in single or double quotes and separated either by commas or one or more spaces, as in, for example, lpstat -a"Queue1 Queue2" or lpstat -a"Queue1,Queue2" or lpstat -a'Queue1 Queue2' or lpstat -a'Queue1,Queue2'.

If you specify a flag with no parameters, all information pertaining to that flag is printed.

The display generated by the lpstat command contains two entries for remote queues. The first entry contains the client's local queue and local device name and its status information. The second entry contains the client's local queue name followed by the remote queue name. The spooling subsystem first displays remote print requests on the local queue. When the remote machine begins to process the remote print job, the status display for the print job moves to the remote queue.

When a status command communicates with a remote host, the display occasionally appears to hang while the command waits for a response from the remote machine. The command eventually times out if no connection is established between the two machines.

Flags

Exit Status

This command returns the following exit values:

Examples

1. To display the status for all print queues, enter:

   lpstat
   

2. To display the long status for all printers, enter:
   lpstat -t
   
3. To display a job number in the print queue lp0, enter:
   lpstat -plp0
   This command displays a list similar to the following:

   Queue  Dev      Status      Job    Files      User      PP      %      Blks      CP      Rnk
   lp0    dlp0     running     39     motd       guest     10      83      12        1       1
   

4. To display the status for users root, ghandi, and king, enter:
   lpstat -u"root,ghandi,king"
   
5. To display the status of all print queues in wide format for AIX 4.3.2 or later, enter:
   lpstat -W
   

Files

Related Information

The disable command, enable command, enq command, lp command, lpr command, qchk command.

Checking Print Job Status in AIX 5L Version 5.1 System User's Guide: Operating System and Devices.

Printers, Print Jobs and Queues Overview for Users in AIX 5L Version 5.1 System User's Guide: Operating System and Devices.

Queuing System Overview for System Management in AIX 5L Version 5.1 System Management Guide: Operating System and Devices.

lpstat Command on POWER-based and Itanium-based Platforms

Note: This is a System V Print Subsystem command.

Purpose

Prints information about the status of the LP print service.

Syntax

lpstat [flags] [request-ID-list]

Description

The lpstat command displays information about the current status of the LP print service. If no flags are given, lpstat displays the status of all print requests made by you. (See lp for more information.)

The command lpstat -o printername is used to list all the requests queued on the specified printer. If printername points to a remote printer (see lpadmin), then lpstat -o printername lists all the requests on the remote printer, not just those submitted locally.

Any arguments that are not flags are assumed to be request-IDs as returned by lp. The lpstat command displays the status of such requests. The flags may appear in any order and may be repeated and intermixed with other arguments. Some of the keyletters below may be followed by an optional list that can be in one of two forms:

• a list of items separated by commas, for example, -p printer1,printer2
• a list of items separated by spaces and enclosed in quotes, for example, -u "user1 user2 user3"

Specifying all after any keyletter that takes list as an argument causes all information relevant to the keyletter to be displayed. For example, the command lpstat -a all lists the accepting status of all print destinations.

The omission of a list following such keyletters causes all information relevant to the keyletter to be displayed. For example, the command lpstat -a is equivalent to lpstat -a all. The exception to the behavior of the all keyword is when it is used in conjunction with the -o flag: lpstat -o all only lists requests submitted locally to remote printers.

Flags

-a [list]

Report whether print destinations are accepting requests. list is a list of intermixed printer names and class names.

-c [list]

Report names of all classes and their members. list is a list of class names.

-d

Report what the system default destination is (if any).

-f [list] [-l]

Verify that the forms in list are recognized by the LP print service. list is a list of forms; the default is all. The -l option will list the form parameters.

-o [list] [-l]

Report the status of print requests. list is a list of intermixed printer names, class names, and request-IDs. The keyletter -o may be omitted. The -l option lists for each request whether it is queued for, assigned to, or being printed on a local printer, the form required (if any), and the character set or print wheel required (if any). Note that required forms (if any) are not listed for remote printers.

-p [list] [-D] [-l]

If the -D flag is given, a brief description is printed for each printer in list. If the -l flag is given, a full description of each printer's configuration is given, including the form mounted, the acceptable content and printer types, a printer description, the interface used, and so on.

In order to maintain system security access information, the information needed to produce the printer status given by lpstat -p is available only if the LP scheduler is running.

-r

Report the status of the LP request scheduler (whether it is running).

-R

Report a number showing the rank order of jobs in the print queue for each printer.

-s [-l]

Display a status summary, including the status of the LP scheduler, the system default destination, a list of class names and their members, a list of printers and their associated devices, a list of the systems sharing print services, a list of all forms and their availability, and a list of all recognized character sets and print wheels. The -l flag displays all parameters for each form and the printer name where each character set or print wheel is available.

-S [list] [-l]

Verify that the character sets or the print wheels specified in list are recognized by the LP print service. Items in list can be character sets or print wheels; the default for list is all. If the -l flag is given, each line is appended by a list of printers that can handle the print wheel or character set. The list also shows whether the print wheel or character set is mounted or specifies the built-in character set into which it maps.

-t [-l]

Display all status information: all the information obtained with the -s flag, plus the acceptance and idle/busy status of all printers and status of all requests. The -l flag displays more detail as described for the -f, -o, -p, and -s flag.

-u [login-ID-list]

Display the status of output requests for users. The login-ID-list argument may include any or all of the following constructs:

login-ID

a user on the local system

system-name!login-ID

a user on system system-name

system-name!all

all users on system system-name

all!login-ID

a user on all systems

all

all users on the local system

all!all

all users on all systems

The default value of login-ID-list is all.