SMSG SMTP command for the authorized user

Purpose

As an authorized user, use the privileged SMSG SMTP command to monitor the status of SMTP.

Format


>>-SMSG SMTP--+-DEbug---------------+--------------------------><
              +-EXpire-- IP_address-+   
              +-NODebug-------------+   
              +-NOTrace-------------+   
              +-SHutdown------------+   
              +-STOPEXIT------------+   
              +-STARTEXIT-----------+   
              '-TRace---------------'

Note: The minimum abbreviation for each parameter is shown in uppercase letters.

Parameters

DEbug: Enables connection debugging and tracing information to the SMTP DEBUG data set. Specifying this parameter is the same as adding the DEBUG statement to the SMTP configuration data set (SMTPCONF).
EXpire IP_address: Causes the domain name resolution for mail queued for delivery to this IP address to expire. SMTP will again try to resolve the IP addresses for this mail if it is still within the retry time window.
NODebug: Disables connection debugging and tracing.
NOTrace: Disables resolver tracing.
SHutdown: Causes the SMTP server to shut down.
STARTEXIT: Causes SMTP to enable a user exit program by issuing the initialization call to the user exit program if one exists. For more information regarding user exit programs, see the z/OS Communications Server: IP Configuration Guide.
STOPEXIT: Causes SMTP to disable a currently running user exit program by issuing the termination call to the user exit program if one exists. For more information regarding user exit programs, see the z/OS Communications Server: IP Configuration Guide.
TRace: Enables resolver tracing. The output of the resolver trace is sent to the SMTP console. This is the same as adding TRACE RESOLVER to the TCPIP.DATA data set.

Examples

Note: If the screen remains inactive even after you issue the SMSG SMTP command, press Enter a few times until any one of the following messages is displayed.

In this example, MVSUSER starts the debugging and tracing:

 System:    READY
 
  User:  smsg smtp debug
System:    +Msg from SMTP:  * Session Debugging Enabled

Stop debugging and tracing:

 System:    READY
 
  User:  smsg smtp nodebug
System:    +Msg from SMTP:  * Session Debugging Disabled
           READY

Begin resolver tracing:

 System:    READY
 
  User:  smsg smtp trace
System:    +Msg from SMTP:  * Resolver Tracing Enabled
           READY

Stop resolver tracing:

 System:    READY
 
  User:  smsg smtp notrace
System:    Msg from SMTP:  * Resolver Tracing Disabled
           READY

Shut down the SMTP server:

System:    READY
 
  User:  smsg smtp shutdown
System:    +Msg from SMTP:  * ok, About to End SMTP
           READY

Cause all mail queued for name resolution to expire:

 System:    READY
 
  User:  smsg smtp3 expire 9.67.112.25
System:    +Msg from SMTP3:  * No Mail Found for IP address: 9.67.112.25
           READY

Usage

SMSG commands from authorized users are accepted only from users that are specified in the SMSGAUTHLIST statement.

Context

See the z/OS Communications Server: IP Configuration Reference for information about the SMTP configuration data set (SMTPCONF) and for a description of how to assign authorized users with the SMSGAUTHLIST configuration statement.