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
- 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:- One or more z/TPF Internet mail servers must be running before you can specify this parameter.
- 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:
- Initialize the database queue pointers.
- Start the IMAP and POP servers.
- Create accounts for your users.
- Start all the z/TPF Internet mail servers.
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/