ZMAIL - Control the z/TPF Internet mail servers

Use this command to control the operation of the z/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 when the z/TPF system is in CRAS state or higher.

Format

Read syntax diagramSkip visual syntax diagramZMAIL STARtSTOp ALl ACcept Deliver ReadFlushSTATusSYSlog OFFON
STARt
starts the appropriate z/TPF Internet mail server. If you do not specify an additional parameter, all the z/TPF Internet mail servers are started.
STOp
stops the z/TPF Internet mail server after processes that are currently running end. If you do not specify an additional parameter, all the z/TPF Internet mail servers are stopped.
ALl
starts or stops the delivery of Internet mail to other servers, and starts or stops all the z/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 z/TPF Internet mail server queue; that is, any mail that is waiting to be delivered is removed.
STATus
displays the status of the z/TPF Internet mail servers.
SYSlog
enables or disables syslog daemon logging for the z/TPF Internet mail servers, where:
OFF
disables logging for mail messages. This is the default setting when the z/TPF Internet mail servers are started.
ON
enables logging for mail messages.
Note:
  1. One or more z/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 z/TPF Transmission Control Protocol/Internet Protocol for more information about the syslog daemon.

Additional information

  • Online help information is available for this command. To display the help information, enter one of the following:
    • ZMAIL HELP
    • ZMAIL ?
  • The ZMAIL command is based on the postfix command of the Secure Mailer, also known as Postfix, and on the Cyrus project.
  • If you must stop the Internet Daemon, enter ZMAIL STOP to stop the z/TPF Internet mail servers before you enter ZINET STOP to stop the Internet Daemon.

Examples

When you configure your z/TPF system for z/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 z/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 z/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
The following example shows that all the z/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+
The following example shows that 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
The following example shows that 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
The following example shows that 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
The following example shows that logging to the syslog daemon for the z/TPF Internet mail servers is started. Any mail messages that are generated by the z/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

For more information about the Secure Mailer, see http://www.postfix.org.

For more information about the Cyrus project, see https://www.cyrusimap.org/