gtpo1m8jOperations

ZMAIL-Control the TPF Internet Mail Servers

Use this command to control the operation of the TPF Internet mail servers, which allow users, or mail clients, to send and retrieve Internet mail, also known as electronic mail (e-mail).

Requirements and Restrictions

You can enter this command only in CRAS state or higher.

Format




STARt
starts the appropriate TPF Internet mail server. If you do not specify an additional parameter, all the TPF Internet mail servers are started.

STOp
stops the TPF Internet mail server after processes that are currently running end. If you do not specify an additional parameter, all the TPF Internet mail servers are stopped.

ALl
starts or stops the delivery of Internet mail to other servers, and starts or stops all the TPF Internet mail servers.

ACcept
starts or stops the Simple Mail Transfer Protocol (SMTP) server. If you specify this parameter with the START parameter, the SMTP server will accept and deliver new mail. If you specify this parameter with the STOP parameter, the SMTP server will no longer accept new mail. Existing mail will be delivered. If you want to stop the delivery of mail, you must specify the STOP and DELIVER parameters.

Deliver
starts or stops the delivery of Internet mail to other servers and local users. If you specify this parameter with the START parameter, the SMTP server will start delivering mail. If you specify this parameter with the STOP parameter, the SMTP server will no longer accept or deliver mail.

Read
starts or stops the Internet Message Access Protocol (IMAP) and Post Office Protocol (POP) servers. The IMAP and POP servers allow you to read Internet mail.

Flush
erases the contents of the TPF Internet mail server queue; that is, any mail that is waiting to be delivered is removed.

STATus
displays the status of the TPF Internet mail servers.

SYSlog
enables or disables syslog daemon logging for the TPF Internet mail servers, where:

OFF
disables logging for mail messages. This is the default setting when the TPF Internet mail servers are started.

ON
enables logging for mail messages.

Notes:

  1. One or more TPF Internet mail servers must be running before you can specify this parameter.

  2. The syslog daemon must be configured to receive mail messages. See TPF Transmission Control Protocol/Internet Protocol for more information about the syslog daemon.

Additional Information

Examples

When you configure your TPF system for TPF Internet mail server support for the first time, you will enter a series of ZMAIL commands to do the following:

  1. Initialize the database queue pointers.
  2. Start the IMAP and POP servers.
  3. Create accounts for your users.
  4. Start all the TPF Internet mail servers.

The following example shows the sequence of these ZMAIL commands. In this example, ZMAIL STATUS is entered at various times to show the status of the TPF Internet mail servers at that time. In addition, only one mail account is created in this example.

+--------------------------------------------------------------------------------+
|User:   zmail flush                                                             |
|                                                                                |
|System: MAIL0001I 10.23.46 START OF RESPONSE FROM ZMAIL flush                   |
|        Active Queue has been flushed                                           |
|        Deferred Queue has been flushed                                         |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   zmail start read                                                        |
|                                                                                |
|System: MAIL0001I 10.41.46 START OF RESPONSE FROM ZMAIL start                   |
|        The READ MAIL service has been started                                  |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.41.52 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0050I 10.41.52 POP3       IS NOW ACCEPTING CONNECTIONS ON           |
|                           IP - ANY PORT - 00110 PID - 40270156+                |
|        CSMP0097I 10.41.52 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0050I 10.41.52 IMAP       IS NOW ACCEPTING CONNECTIONS ON           |
|                           IP - ANY PORT - 00143 PID - 40280011+                |
|                                                                                |
|User:   zmail status                                                            |
|                                                                                |
|System: INET0031I 10.42.13 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - IMAP       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMNA       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00143  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582923/00C0000B COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.42.13 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0031I 10.42.13 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - POP3       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMNC       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00110  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582922/00C0000A COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.42.13 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        MAIL0001I 10.42.13 START OF RESPONSE FROM ZMAIL status                  |
|        The ACCEPT MAIL service is not running                                  |
|        The DELIVER MAIL service is not running                                 |
|        The READ MAIL service has been started                                  |
|        END OF DISPLAY                                                          |
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   zmail cm steve                                                          |
|                                                                                |
|System: MAIL0003I 15:00:31 cm COMPLETED SUCCESSFULLY. NO OUTPUT TO DISPLAY      |
|                                                                                |
|User:   zmail password steve stevepwd                                           |
|                                                                                |
|System: MAIL0003I 15:00:31 password COMPLETED SUCCESSFULLY. NO OUTPUT TO DISPLAY|
|                                                                                |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
|User:   zmail start                                                             |
|                                                                                |
|System: MAIL0001I 10.43.46 START OF RESPONSE FROM ZMAIL start                   |
|        The ACCEPT MAIL service has been started                                |
|        The DELIVER MAIL service has been started                               |
|        END OF DISPLAY                                                          |
|        MAIL0002E 10.43.46 START OF ERROR RESPONSE FROM ZMAIL start             |
|        The READ MAIL service has already been started                          |
|        END OF DISPLAY+                                                         |
|        CSMP0097I 10.43.52 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0050I 10.43.52 SMTP       IS NOW ACCEPTING CONNECTIONS ON           |
|                           IP - ANY PORT - 00025 PID - 402900F0+                |
|User:   zmail status                                                            |
|                                                                                |
|System: INET0031I 10.26.35 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - SMTP       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMN0       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00025  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582918/00C00006 COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.26.35 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0031I 10.26.35 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - IMAP       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMNA       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00143  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582917/00C00005 COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.27.01 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0031I 10.27.01 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - POP3       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMNC       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00110  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582919/00C00007 COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.27.01 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        MAIL0001I 10.27.01 START OF RESPONSE FROM ZMAIL status                  |
|        The ACCEPT MAIL service has been started                                |
|        The DELIVER MAIL service has been started                               |
|        The READ MAIL service has been started                                  |
|        END OF DISPLAY                                                          |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, all the TPF Internet mail servers are stopped.

+--------------------------------------------------------------------------------+
|User:   zmail stop                                                              |
|                                                                                |
|System: MAIL0001I 10.27.54 START OF RESPONSE FROM ZMAIL stop                    |
|        The ACCEPT MAIL service has been stopped                                |
|        The DELIVER MAIL service has been stopped                               |
|        The READ MAIL service has been stopped                                  |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.27.54 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0051I 10.27.54 IMAP       IS NO LONGER ACCEPTING CONNECTIONS ON     |
|                           IP - ANY PORT - 00143 PID - 4019010A+                |
|        CSMP0097I 10.27.54 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0051I 10.27.54 SMTP       IS NO LONGER ACCEPTING CONNECTIONS ON     |
|                           IP - ANY PORT - 00025 PID - 40190148+                |
|        CSMP0097I 10.27.54 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0051I 10.27.54 POP3       IS NO LONGER ACCEPTING CONNECTIONS ON     |
|                           IP - ANY PORT - 00110 PID - 40190149+                |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, the SMTP server is started and will begin to accept and deliver mail. In this example, the IMAP and POP servers are not running.

+--------------------------------------------------------------------------------+
|User:   zmail start accept                                                      |
|                                                                                |
|System: MAIL0001I 10.31.10 START OF RESPONSE FROM ZMAIL start                   |
|        The ACCEPT MAIL service has been started                                |
|        The DELIVER MAIL service has been started                               |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.31.16 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0050I 10.31.16 SMTP       IS NOW ACCEPTING CONNECTIONS ON           |
|                           IP - ANY PORT - 00025 PID - 401F01E7+                |
|                                                                                |
|User:   zmail status                                                            |
|                                                                                |
|System: INET0031I 10.39.47 START OF ZINET DISPLAY OF ACTIVE SERVER              |
|        SERVER - SMTP       PROCID - B    ACTIVATION - OPER                     |
|        PGM    - CMN0       PARM   -                                            |
|        PROTOCOL   - TCP    PORT      - 00025  MODEL - NOWAIT   _               |
|        SERVERRORS - 00000  SERVETIME - 00000  USER  - nobody                   |
|        MAXPROC    - 00000  TIMEOUT   - 00000  STATE - NORM                     |
|        AORLENGTH  - 00000                                                      |
|        IP - ANY             SOCKET - 12582921/00C00009 COUNT - 0000000000      |
|                                                  TOTAL COUNT - 0000000000      |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.39.47 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        MAIL0001I 10.39.47 START OF RESPONSE FROM ZMAIL status                  |
|        The ACCEPT MAIL service has been started                                |
|        The DELIVER MAIL service has been started                               |
|        The READ MAIL service is not running                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, the accept mail service is stopped; that is, the SMTP server will no longer accept new mail. Existing mail will continue to be delivered.

+--------------------------------------------------------------------------------+
|User:   zmail stop accept                                                       |
|                                                                                |
|System: MAIL0001I 10.40.23 START OF RESPONSE FROM ZMAIL stop                    |
|        The ACCEPT MAIL service has been stopped                                |
|        END OF DISPLAY                                                          |
|        CSMP0097I 10.40.24 CPU-B SS-BSS  SSU-HPN  IS-01                         |
|        INET0051I 10.40.24 SMTP       IS NO LONGER ACCEPTING CONNECTIONS ON     |
|                           IP - ANY PORT - 00025 PID - 402500BD+                |
|                                                                                |
|User:   zmail status                                                            |
|                                                                                |
|System: MAIL0001I 10.40.31 START OF RESPONSE FROM ZMAIL status                  |
|        The ACCEPT MAIL service is not running                                  |
|        The DELIVER MAIL service has been started                               |
|        The READ MAIL service is not running                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, delivery of mail is stopped entirely; that is, the SMTP server will no longer accept or deliver mail.

+--------------------------------------------------------------------------------+
|User:   zmail stop deliver                                                      |
|                                                                                |
|System: MAIL0001I 10.41.07 START OF RESPONSE FROM ZMAIL stop                    |
|        The DELIVER MAIL service has been stopped                               |
|        END OF DISPLAY                                                          |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, logging to the syslog daemon for the TPF Internet mail servers is started. Any mail messages that are generated by the TPF Internet mail servers after this command is entered will be logged to the syslog daemon.

+--------------------------------------------------------------------------------+
|User:   zmail sys on                                                            |
|                                                                                |
|System: MAIL0003I 09.11.03 sys COMPLETED SUCCESSFULLY. NO OUTPUT TO DISPLAY     |
+--------------------------------------------------------------------------------+

Related Information