[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 3

mailq Command


Prints the contents of the mail queue.


/usr/sbin/mailq [ -v ]


The mailq and MAILQ commands print a list of messages that are in the mail queue. The first line printed for each message shows:

The second line shows the error message that caused the message to be retained in the in the queue, it is not displayed if the message is being displayed for the first time. The status characters are either:

Indicates the job is being processed

Indicates that the load is too high to process the job

Indicates that the job is too young to process

The following lines show message recipients, one per line.

The mailq command is the same as the sendmail -bp command.

Specify the -v flag to display message priority.


-v Prints verbose information. This adds the priority of the message and a single character indicator (+ or blank) indicating wheather a warning message has been sent on the first line of the message. Additionally, extra lines may be intermixed with the recipents indicating the controlling user information; this shows who owns any program that are executed on behalf of this message and the name of the alias this command expanded from, if any.

Exit Status

The command returns the following exit values:

0 Exits successfully.
>0 An error occurred.


The mailq command prints two types of lists:

The fields have the following meanings:

QID Contains the message queue ID of the message.
Size Contains the number of bytes in the body of the message (heading information not included).
Priority Contains the priority of the message, based primarily on the size of the message.
Q-Time Contains the time the message entered the queue.
Sender/Recipient Contains the user ID of the sender and the recipient of the message. A message on the line between the sender and the recipient indicates the status of the message.


/usr/sbin/mailq Contains the mailq command.
/var/spool/mqueue directory Contains the log file and temporary files associated with the messages in the mail queue.

Related Information

The sendmail command.

Managing the Mail Queue Files and Directories in AIX 5L Version 5.1 System Management Guide: Communications and Networks.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]