QUEU command—Get information about mail queued at SMTP for delivery

Purpose

Use the QUEU command to get information about mail queued at SMTP for delivery.

Format


>>-QUEU--+------+----------------------------------------------><
         '-DATE-'

Parameters

DATE: Causes information about the age of the mail to be returned. The default is to not return age information.

Usage

QUEU returns a multiline reply with information about mail queued at SMTP for delivery. The following information is returned about mail:

Spool Queue

Contains mail that is destined for recipients on the local MVS™ system, or for recipients on an NJE system attached to the local MVS system. This queue is generally empty, because SMTP can deliver this mail quickly by spooling it to the local recipient or to the NJE address space for delivery to an NJE network recipient.

Active

Indicates that if SMTP is currently transmitting to a TCP network destination, all the mail queued for that destination is shown to be active.

Queued

All mail that arrives over a batch SMTP connection, and mail from TCP connections that is to be forwarded to another TCP network destination through source routing, is placed on the queued list. As soon as SMTP receives resources from the TCPIP address space, mail that is queued is promoted to active.

Retry Queue

Mail is placed here after SMTP tries to transmit mail to each of the TCP network hosts, but was unable to either open a connection or complete delivery over the connection. After the number of minutes specified by RETRYINT, mail is promoted from the retry queue to the QUEUED state. For more information about the RETRYINT variable, see the z/OS Communications Server: IP Configuration Reference.

Undeliverable Queue

Mail is placed here if SMTP cannot deliver mail to a local MVS recipient, or to a recipient on the NJE network attached to the local MVS system, because spool space on the local MVS system is full. After spool space has been increased and SMTP has been restarted, delivery is attempted again.

Resolution Queues

SMTP uses the following queues for processing queries to the name server. If the SMTP server is configured to use the site tables rather than the name server, these queues are not used.

If the queue is empty, the word Empty appears to the right of the queue. If the queue contains queries, the queries appear on separate lines below the queue. However, due to the speed of the SMTP server, the output might show that the queue is active without containing any entries. In this case, the word Empty does not appear.

Resolver Process Queue: Is generally empty; it contains queries waiting to be sent to the SMTP resolver. After the query has been processed, it is put in the resolver send queue.
Resolver Send Queue: Contains queries waiting to be processed by the SMTP resolver. SMTP staggers the number of queries sent by the resolver to prevent the overloading of the network and the name server.
Resolver Wait Queue: Contains queries for which the SMTP resolver is waiting for responses. Queries remain in this queue for the period of time it takes to receive a reply from the name server. If a reply is not received, the queries are removed from this queue after the resolver timeout has occurred, and are placed in the resolver retry queue. If the query is successful, the query is placed in the resolver completed queue.
Note: The SMTP resolver timeout is specified by the RESOLVERTIMEOUT statement in the TCPIP.DATA data set.
Resolver Retry Queue: Contains queries that have previously failed, either because the name server did not reply, or the name server returned a temporary error that forced the SMTP resolver to try the query again. A temporary error occurs if, for example, the name server truncates a packet, or if the name server detects a processing error.
The RESOLVERRETRYINT statement specifies the number of minutes SMTP waits before trying the query again. The RETRYAGE statement specifies the number of days SMTP should continue to resolve the query before returning the mail to the sender.
Resolver Completed Queue: Contains queries that have been resolved and are waiting to be recorded into the mail. After the Internet addresses are recorded, SMTP attempts to deliver the mail.
Resolver Error Pending Queue: Contains queries that the name server has returned without answers. The corresponding mail message is returned to the sender with an unknown recipient error.