MODIFY command: Communications Server SMTP application (CSSMTP)

Use the MODIFY command to control the Communications Server SMTP (CSSMTP) application from the operator console. For descriptions of terms that are used in this section, see the Configuring the CSSMTP application in z/OS Communications Server: IP Configuration Guide .

Format:

Parameters:

procname

The member name of the cataloged procedure that is used to start the CSSMTP application.

Display,CONFig

Display the CSSMTP application configuration and global values that are used for processing mail.

Display,IPlist

Display all target server IP addresses and their preferences that are used by CSSMTP. A target server is the resolved or configured IP addresses from TargetServer statements. See the TargetServer statement in z/OS Communications Server: IP Configuration Reference for details on how the target server addresses are obtained.

DISplay,LOGlevel

Display CSSMTP active log levels.

Display,SPoolstatusDisplay,SPoolstatus,Summary

Display summary information for all tasks that are processing spool files for CSSMTP. You can use this display to determine the number of mail messages that are pending or you can use it on the long-retry queue for each spool file that is being processed. The summary option is the default for the MODIFY DISPLAY,SPOOLSTATUS command.

Tip: Use this command to obtain the task ID to use on other modify commands that use task ID values as options.

Display,SPoolstatus,DetailDisplay,SPoolstatus,Detail,ALL

Display detailed information for all tasks that are not idle. The ALL option is the default for the MODIFY DISPLAY,SPOOLSTATUS,DETAIL command.

Display,SPoolstatus,Detail,TKID=tkid

Display detailed information for this specific task that processes spool files for CSSMTP.

Tip: You can use the MODIFY DISPLAY,SPOOLSTATUS command to obtain a valid TKID value.

Display,TARgets[,ADDR=ipAddress]

Display global and specific information about target servers. If the ADDR parameter is not specified, all configured target servers are displayed. If the ADDR parameter is specified, then the IP address value must match the IP address of an existing target server that is in use by CSSMTP.

Tip: You can use the MODIFY DISPLAY IPLIST command to obtain IP addresses for the list of target servers that are being used by CSSMTP.

FLUSHRetry,TKID=tkid

Initiate a request for the CSSMTP application to remove mail messages from the long retry queue, and send those mail messages to the list of target servers. If CSSMTP cannot send a mail message, that mail message becomes subject to long-term retry processing; if any mail message is not defined, it becomes an undeliverable mail message. For more information, see Customizing the CSSMTP configuration file to handle undeliverable mail in z/OS Communications Server: IP Configuration Guide .

A nonzero TKID (task ID) value requests that only the mail messages for the specified TKID value is flushed. A TKID value 0 requests that all mail messages in the long-retry queue be flushed.

Tip: You can use the MODIFY DISPLAY,SPOOLSTATUS command to obtain a valid TKID value.

FLUSHRetry,AGE=days

Initiate a request for the CSSMTP application to remove the mail messages that are older than days days from the extended retry queue, and send those mail messages to the list of target servers. If CSSMTP cannot send a mail message, that message becomes an undeliverable mail message. To make this command effective, the target servers must be available. For details, see the information about ExtendedRetry statement in z/OS Communications Server: IP Configuration Reference and the information about Customizing the CSSMTP configuration file to handle undeliverable mail in z/OS Communications Server: IP Configuration Guide.

A days value of 0 specifies that all messages in the extended retry list are to be processed.

Tip: You can use the command to monitor the number of the mail messages in the extended retry list and the state of the target servers used by CSSMTP.

LOGlevel,LEVEL=logLevel

Change the CSSMTP application log level. The logLevel value specifies the log level. If a logLevel value is not specified, then the current log level remains in effect. See LogLevel statement in z/OS Communications Server: IP Configuration Reference for details about defining the CSSMTP application log level.

REFRESH

Initiate a dynamic reconfiguration using the configuration file that is defined at initialization. If a configuration error is detected during a dynamic refresh, the entire refresh is rejected, the error message is written to the log and console, and the CSSMTP application continues to run with the old configuration values.

Results:

While the new configuration file is being processed, the existing log level is used, regardless of how it was set (using the last configuration file or with the MODIFY LOGLEVEL command). After the new configuration file has been successfully processed, the value that is specified on the LogLevel statement of the new configuration file takes effect. If the LogLevel statement is not specified in the new configuration file, the log level defaults to level 7 (ERROR, WARNING, and EVENT). If the new configuration file contains errors that cause it to be rejected, the log level that was in effect prior to the dynamic reconfiguration is used.
If an update to the ExtWrtName statement is detected during a dynamic refresh, then the CSSMTP application continues to run with the old external writer name and a warning message is written to the log and console.
If an update to the Translate statement is detected during a dynamic refresh, then the CSSMTP application continues to run with the old translate value and a warning message is written to the log and console.
If an update to the ChkPointSizeLimit statement is detected during a dynamic refresh, then the CSSMTP application continues to run with the old ChkPointSizeLimit value and a warning message is written to the log and console.
While the new configuration file is being processed, the existing UserExit value is used, regardless of how it was set (using the last configuration file or with the MODIFY USEREXIT command). After the new configuration file has been successfully processed, the value that is specified on the UserExit statement of the new configuration file takes effect when the next JES spool file is opened. If the new configuration file contains errors that cause it to be rejected, the UserExit value that was in effect prior to the dynamic reconfiguration is used.
An update to the TargetServer statement can force CSSMTP to stop and restart connections on the affected IP addresses. If CSSMTP is in the process of sending a mail message on the affected IP address, the mail message is retried at another IP address or placed in the long retry queue. For more information about the TargetServer statement, see the TargetServer statement in z/OS Communications Server: IP Configuration Reference.

REFRESHIPlist

Initiates a dynamic DNS refresh of the target that is identified by the configured TargetName or TargetMx parameter value. This parameter does not cause the configuration file to be reprocessed.

Result: If a TargetServer statement has TargetName or TargetMx parameters configured, new IP addresses might be resolved. If the IP address list is changed, CSSMTP might be forced to stop and restart connections on the affected IP addresses. If CSSMTP is in the process of sending a mail message on the affected IP address, the mail message is retried at another IP address or placed in the long retry queue.

REFRESHTargets

Reinitiates a connection to all target servers. The CSSMTP application can learn about any capability changes from the target servers.

Tip: This command causes all active connections to all target servers to be stopped and restarted; therefore, use this command only when there is a change in the network topology and no work is being done by the CSSMTP application because the command interrupts all active connections.

Result: If you issue this command while CSSMTP is in the process of sending a mail message on the connection, the mail message is retried at another IP address or placed in the long retry queue.

RESume

Resumes processing of any JES spool files whose processing was suspended with the MODIFY SUSPEND operator command.

SUSpendSUSpend,Immediate

Suspends the reading of mail messages immediately for all active spool files. To resume this processing, issue the MODIFY RESUME operator command. The IMMediate option is the default for the MODIFY SUSPEND command.

SUSpend,Delay

Suspends the reading of any new spool files immediately but completes reading any spool files that are already in process. To resume reading of spool files, issue the MODIFY RESUME operator command.

USERexit,LEVEL=userExitValue

Change the CSSMTP application user exit value. The USERexit keyword can be set to NONE, VERSION2, VERSION3, or VERSION 4. If a userExitValue parameter value is not specified, then the current user exit value remains in effect. See the USEREXIT statement in z/OS Communications Server: IP Configuration Reference for details about how to define the CSSMTP application user exit value.

Result: The user exit value does not change until the next JES spool file is opened.

Examples:

Example 1: The MODIFY DISPLAY,LOGLEVEL command displays the current logging level that is being used by CSSMTP.

F CSSMTP,DISPLAY,LOGLEVEL                                    
   EZD1828I CSSMTP DISPLAY LOGLEVEL = 15

Example 2: The MODIFY DISPLAY,CONFIG command displays the current configuration that is being used by CSSMTP.

F CSSMTP,DISPLAY,CONFIG
  EZD1829I CSSMTP CONFIGURATION: 730
  CONFIGFILENAME       : //'USER1.CSSMTP.CNTL(CSSMTP)'
  LOGFILENAME          : /tmp/cssmtp.log
  CHKPOINTFILENAME     : 'USER1.CSSMTP.CHKPOINT'
  PID                  : 67108878
  LOGLEVEL             : 7           USEREXIT        : VERSION3
  CHKPOINTSIZELIMIT    : 64000       CHKPOINT        : WARM
  CONFIG CODEPAGE      : IBM-1047
  
  TRANSLATE            : IBM-930     MBCS            : YES
  START OPTION TCPNAME : N/A         IPV6 ENABLED    : YES
  EXTWRTNAME           : CSSMTP      HOST NAME       : SY1
  DOMAIN NAME          : example.com
  HEADER:
   DATE                : YES
   USERINFO            : YES
  JESJOBSIZE           : 0           JESMSGSIZE      : 0
  JESSYNTAXERRLIMIT    : 6
  BADSPOOLDISP         : HOLD        REPORT          : ADMIN
  OPTIONS:
   NULLTRNC            : YES         DATALINETRUNC   : NO
   ATSIGN              : 7C          REPLACESUBJECTATSIGN : YES                  
   TLSEHLO             : YES          TESTMODE             : NO
   RESTRICTMAILFROM    : YES
  UNDELIVERABLE:
   RETURNTOMAILFROM    : YES         DEADLETTERACTION: STORE
   DEADLETTERDIRECTORY : /var/cssmtp/deadletter/
  SMF119:
   CONFIG              : YES         CONNECT         : YES
   MAIL                : YES         SPOOL           : YES
   STATS               : YES
  RETRYLIMIT:
   COUNT               : 5           INTERVAL        : 1
  EXTENDEDRETRY: ACTIVE
   AGE                 : 5           INTERVAL        : 30
   MAILDIRECTORY       : /var/cssmtp/mail/
  TARGETSERVER:
   TARGETNAME          : mail.example.com
    CONNECTPORT        : 25          CONNECTLIMIT    : 5
    MAXMSGSENT         : 0           MESSAGESIZE     : 524288

    SECURE             : YES       CHARSET         : ISO8859-1
    MBCHARSET          : IBM-5053
    AUTHENTITY         : TARGET.MAIL.SERVER
   TARGETIP            : 10.1.1.1                         
    CONNECTPORT        : 25          CONNECTLIMIT    : 5      
    MAXMSGSENT         : 0           MESSAGESIZE     : 524288 
    SECURE             : YES       CHARSET         : ISO8859-1
    MBCHARSET          : IBM-5053
    AUTHENTITY         : <MAILFROM>
  TIMEOUT:
   ANYCMD              : 300         CONNECTRETRY    : 120
   DATABLOCK           : 180         DATACMD         : 120
   DATATERM            : 600         INITIALMSG      : 300
   MAILCMD             : 300         RCPTCMD         : 300
   CONNECTIDLE         : 60 
  MAILBOXCOMPATIBILITY : STANDARD
  REPORTSYSOUTCLASS    : B              
  REPORTMAILFROM       : reportadm@example.com                          
  MAILADMINISTRATOR    : postmaster@example.com
                         user1@example.com
                         user2@example.com

For definitions of statements and parameters that are obtained from configuration file, see the CSSMTP configuration statements in z/OS Communications Server: IP Configuration Reference .

CONFIGFILENAME

The configuration name from the CONFIG DD statement in the started procedure.

LOGFILENAME

The configured log file name from LOGFILE DD statement in the started procedure.

PID

The process ID.

LOGLEVEL

The logging level.

CHKPOINT

Indicates whether checkpointing is active.

WARM: Checkpointing was initiated using the CHKPOINT DD statement.
COLD: Checkpointing was initiated using the -f start option.
NONE: There was no CHKPOINT DD statement.

CONFIG CODEPAGE

The code page value specified on the CSSMTP_CODEPAGE_CONFIG statement or the default value.

TRANSLATE

The code page value that is configured on the Translate statement.

CHKPOINT FILENAME

The name of the configured checkpoint file, if a CHKPOINT DD statement is configured in the started procedure.

START OPTION TCPNAME

The TCP name that is passed on the -p start option or the value N/A if the -p start option is not used.

IPV6 ENABLED

Indicates whether IPV6 is supported.

EXTENDEDRETRY

Indicates whether extended retry processing is ACTIVE or INACTIVE.

ATSIGN

The hex value of the configured AtSign symbol.

Result: Code page IBM®-1047 is always used for the CSSMTP display. The CSSMTP_CODEPAGE_CONFIG environment variable is not used for the display. The value displayed is the hex value that is defined in the IBM-1047 code page for the configured symbol.

The remaining values that are displayed are the values for the matching statement or parameter from the configuration file.

Example 3: The MODIFY DISPLAY,IPLIST command displays the IP address of the configured target servers from the TargetServer statement and TargetIp parameter, or it displays the resolved target server addresses from the TargetServer statement and TargetName parameter, that are being used by CSSMTP.

F CSSMTP,DISPLAY,IPLIST
EZD1830I CSSMTP IPLIST: 
   TARGETIP            : 10.1.1.2 
    CONNECTPORT        : 25          CONNECTLIMIT   : 5
    MAXMSGSENT         : 1000        MESSAGESIZE    : 524288NO     
    SECURE             : NO       CHARSET        : ISO8859-1
   MBCHARSET          : IBM-5053
   TARGETIP            : mail.example.com                             
    CONFIG TARGETNAME  : RALVMS                                  
    CONNECTPORT        : 25          CONNECTLIMIT   : 2
    MAXMSGSENT         : 2000        MESSAGESIZE    : 524288
    SECURE             : YES        CHARSET        : ISO8859-1
    MBCHARSET          : IBM-5053
    AUTHENTITY         : TARGET.MAIL.SERVER3
   TARGETIP            : 9.200.1.6                               
    CONNECTPORT        : 25          CONNECTLIMIT   : 5
    MAXMSGSENT         : 1000        MESSAGESIZE    : 524288 
    SECURE             : YES         CHARSET        : ISO8859-1
    MBCHARSET          : IBM-5053

For the definitions of statements and parameters that are obtained from the configuration file, see CSSMTP configuration statements in z/OS Communications Server: IP Configuration Reference.

TARGETIP: The IP address of the target server.
CONFIG TARGETNAME: The name that is used to resolve this target server address for a resolver A or AAAA query.

The remaining values that are displayed are the same values that are specified on the matching statement or parameter in the configuration file.

Example 4: The MODIFY DISPLAY,IPLIST command displays the resolved target servers from the TargetServer statement and TargetMx parameter that are being used by CSSMTP.

F CSSMTP,DISPLAY,IPLIST
EZD1830I USER1408 IPLIST:                            
   TARGETIP            : 10.1.1.3                           
    CONFIG TARGETMX    : mxName                                      
    PREFERENCE         : 1                                     
    CONNECTPORT        : 25          CONNECTLIMIT   : 2
    MAXMSGSENT         : 2000        MESSAGESIZE    : 524288
    SECURE             : YES         CHARSET        : ISO8859-1
    MBCHARSET          : IBM-5053
    AUTHENTITY         : TARGET.MAIL.SERVER4
   TARGETIP            : 10.1.1.4
    CONFIG TARGETMX    : mxName                                      
    PREFERENCE         : 1                                     
    CONNECTPORT        : 25          CONNECTLIMIT   : 2
    MAXMSGSENT         : 2000        MESSAGESIZE    : 524288
    SECURE             : NO         CHARSET        : ISO8859-1
    MBCHARSET          : IBM-5053

For the definition of statements and parameters that are obtained from configuration file, see CSSMTP configuration statements in z/OS Communications Server: IP Configuration Reference.

TARGETIP: This is the IP address of the target server.
CONFIG TARGETMX: The name that is used to resolve this target server address for resolver MX query.

The remaining values that are displayed are the values for the matching statement or parameter from the configuration file.

Example 5: The MODIFY DISPLAY,SPOOLSTATUS command displays the summary information for all tasks that are processing JES spool files.

F CSSMTP,DISPLAY,SPOOLSTATUS
   EZD1832I CSSMTP SPOOLSTATUS: 
  TKID JOBNAME  STATE  PEND   LRT     TKID JOBNAME  STATE  PEND   LRT    
 W 002 JOBNM25  ACTVE    15     5    D 003 JOBNM132 READ      5     0
 W 004 JOBNM45  ACTVE    10    10    D 005 JOBNM232 READ     10     0
 W 006 JOBNM48  ACTVE    20     0    D 007 JOBNM332 IDLE      0     0  
 W 008 JOBNM50  ACTVE    20     5    D 009 JOBNM432 IDLE      0     0  
 W 010 JOBNM60  ACTVE    10     0    D 011 JOBNM532 IDLE      0     0  
 W 012 JOBNM80  ACTVE     0     0    D 013 JOB00632 IDLE      0     0  
 W 014 JOBNM90  ACTVE    10    10    D 015 JOB00732 IDLE      0     0  
 W 016 JOBNM190 ACTVE    20     0    D 017 JOB00832 IDLE      0     0  
 W 018 JOBNM150 ACTVE    20     5    D 019 JOB00932 IDLE      0     0  
 W 020 JOBNM160 ACTVE    10     0    D 021 JOB01132 IDLE      0     0

For definitions of terms that relate to this information, see Terms and concepts in z/OS Communications Server: IP Configuration Guide.

W

A writer JES task, if the JES spool file was generated by the IEBGENER utility.

D

A dest JES task, if the JES spool file was generated by the SMTPNOTE command or by the TSO Transmit (XMIT) command.

TKID

The task ID, which can be used to identify a specific task.

Tip: You can use the task ID in the MODIFY FLUSHRetry command and the MODIFY DISPLAY,SPOOLSTATUS,DETAIL,TKID=tkid command.

JOBNAME

The JES job name for this task. If the task is in the IDLE state, this is the name of the previous job.

STATE

This parameter can have one of the following values:

WAITS: The task is waiting because virtual storage is constrained.
READ: The task is reading a spool file.
IDLE: The task is waiting for a JES spool file to process.
ACTVE: The task is actively waiting for all mail in the spool file to be processed.
WAIT: The task is waiting because no target server is active to receive mail.
SUPND: The task was suspended by the MODIFY SUSPEND command.

PEND

The number of mail messages that are waiting to be sent to target server.

LRT

The number of mail messages that are currently queued in the long-retry queue.

The MODIFY DISPLAY SPOOLSTATUS,DETAIL command displays detailed information for all tasks that are not in the IDLE state that are processing JES spool files.

F CSSMTP,DISPLAY,SPOOLSTATUS,DETAIL
EZD1833I CSSMTP SPOOLSTATUS: 
 TASK ACTVE           : WRITER     TKID         : 2    
  JOBNAME             : JOBNM25    JOBID        : STC00055
  PEND                : 15         LRT          : 5
  MAIL READ           : 0          UNDELIVERABLE: 0
 TASK ACTVE           : WRITER     TKID         : 4
  JOBNAME             : JOBNM45    JOBID        : STC00060
  PEND                : 10         LRT          : 10
  MAIL READ           : 10         UNDELIVERABLE: 0

... <active task TKID=006,008,010,012,014,016,018,020 not shown>
 TASK READ            : DEST       TKID         : 3
  JOBNAME             : JOBNM132   JOBID        : STC00055
  PEND                : 5          LRT          : 0
  MAIL READ           : 5          UNDELIVERABLE: 20
 TASK READ            : DEST       TKID         : 5
  JOBNAME             : JOBNM232   JOBID        : STC00255
  PEND                : 10         LRT          : 0
  MAIL READ           : 5          UNDELIVERABLE: 20

The MODIFY DISPLAY SPOOLSTATUS,DETAIL command displays detailed information for all tasks that are not in the IDLE state that are processing JES spool files; in this example all state tasks are idle.

F CSSMTP,Display,Spoolstatus,detail
EZD1833I CSSMTP SPOOLSTATUS: 
No non-idle TKIDs to display

The MODIFY DISPLAY SPOOLSTATUS,DETAIL,TKID=11 command displays detailed information for a specific TKID 11 task that is processing a spool file for the CSSMTP application.

F CSSMTP,DISPLAY,SPOOLSTATUS,DETAIL,TKID=11
EZD1833I CSSMTP SPOOLSTATUS: 
 TASK ACTVE           : WRITER     TKID         : 11
  JOBNAME             : JOBNM532   JOBID        : STC00532
  PEND                : 0          LRT          : 0
  MAIL READ           : 25         UNDELIVERABLE: 0

The MODIFY DISPLAY SPOOLSTATUS,DETAIL,TKID=3 command displays detailed information for a specific TKID 3 task that is currently idle.

F CSSMTP,DISPLAY,SPOOLSTATUS,DETAIL,TKID=2
EZD1833I CSSMTP SPOOLSTATUS: 
 TASK IDLE            : WRITER      TKID            : 2
  JOBNAME             : JOB00032    JOBID           : STC00055
  PEND                : 0           LRT             : 0
  MAIL READ           : 2           UNDELIVERABLE   : 1

TASK

The TASK parameter has the following fields:

state

Possible values are:

WAITS: The task is waiting because virtual storage is constrained.
READ: The task is reading a spool file.
IDLE: The task is waiting for a JES spool file to process.
ACTVE: The task is actively waiting for all mail in the spool file to be processed.
WAIT: The task is waiting because no target server is active to receive mail.
SUPND: The task was suspended by the MODIFY SUSPEND command.

type task

Possible type task values are:

WRITER: This is a writer JES task if the JES spool file was generated by the IEBGENER utility.
DEST: This is a DEST JES task if the JES spool file was generated by the SMTPNOTE command or by the TSO Transmit (XMIT) command.

TKID

The task ID, which can be used to identify a specific task.

Tips:

You can use the task ID in the MODIFY FLUSHRetry command and the MODIFY DISPLAY,SPOOLSTATUS,DETAIL,TKID=tkid command.
You can use the task ID to identify log information that is in the log file. If the tkid value is 2, that TKID value is represented in the following example by the value :002.
```
08/01 07:10:20 CSSMTP DEBUG  :002:mlJESThread:Message(0): ...
```

JOBNAME

The JES job name for this task. If the task is in the IDLE state, then this is the previous job name.

JOBID

This is the JES job ID for this task. If the task is in the IDLE state, then this is the previous job ID.

PEND

The number of mail messages that are waiting to be sent to a target server. If the task is in the IDLE state, then this value is always 0.

LRT

The number of mail messages that are currently in the long-retry queue. If the task is in the IDLE state, then this value is always 0.

MAIL READ

The total number of mail messages that have been read for the job. If the task is in the IDLE state, then this is the mail for the previous job.

UNDELIVERABLE

The total number of undeliverable mail messages for this job name. If the task is in IDLE state, then this value is the undeliverable count of the previous job.

Example 6: The MODIFY DISPLAY,TARGETS command displays the global and specific information that is related to sending email to target servers. For definitions of statements and parameters that are obtained from the configuration file, see CSSMTP configuration statements in z/OS Communications Server: IP Configuration Reference.

F CSSMTP,DIS,TARGETS   
 EZD1831I CSSMTP TARGETS: 
  GLOBAL INFORMATION:                                       
   MAIL SENT : 0                    TOTAL RETRY  : 0
   DEADLETTER: 0                    CURRENT RETRY: 0
   UNDELIVER : 0 
  EXTENDED RETRY:
   CURRENT   : 0                    TOTAL        : 0         
  TARGET SERVER :10.1.1.1                               
   STATE     : ACTIVE                                      
   ESMTP     : YES                  MESSAGE SIZE : 20000000
   STARTTLS  : YES                  MAIL ATTEMPTS: 24
   AUTH STATE : SUCCESSFUL
   MAIL SENT : 24                   CONNECT FAIL : 0       
  TARGET SERVER ::6                               
   STATE     : ACTIVE                                      
   ESMTP     : YES                  MESSAGE SIZE : 20000000
   STARTTLS  : YES                  MAIL ATTEMPTS: 30
   AUTH STATE : SUCCESSFUL
   MAIL SENT : 30                   CONNECT FAIL : 0

The following global target server information for this application is displayed:

MAIL SENT

Count of all mail messages that were processed successfully after all mail messages were sent.

TOTAL RETRY

Cumulative count of mail messages that have been in the long-retry state.

DEADLETTER

Cumulative count of all mail messages that were classified as dead letters.

CURRENT RETRY

Count of mail messages that are currently in the long-retry queue.

UNDELIVER

Count of all mail messages that were undeliverable.

EXTENDED RETRY

CURRENT: Count of mail messages currently in the extended retry directory while extended retry is active.
TOTAL: Cumulative count of mail messages that have been in the extended retry directory.

The following fields are displayed for each target server:

STATE

State of the target server.

ACTIVE: The target server is active.
NOT USABLE: This target server is not usable. For example, CSSMTP has lost connectivity to this target server.
UNKNOWN: This target server is new and its capabilities have not been learned at this time.

ESMTP

Type of target server. If the ESMTP value is YES, the target server type is ESMTP. If the ESMTP value is NO, the target server type is SMTP.

MESSAGE SIZE

The actual message size.

For ESMTP this value was obtained from the SIZE extension when the connection was made. The value 0 indicates that there is no predefined message size limit.
For SMTP, this value is the value that is configured for the MessageSize parameter of the TargetServer statement. For details, see CSSMTP configuration statements in z/OS Communications Server: IP Configuration Reference.

STARTTLS

Indicates that the target server has acknowledged that it is capable of establishing secure connections.

For ESMTP see the information that describes Steps for using Transport Layer Security for CSSMTP in z/OS Communications Server: IP Configuration Guide for details.
For SMTP this is always set to NO.

AUTH STATE

Status of the SMTP AUTH attempt.

NOT CONFIGURED: AuthEntity not configured and server does not require AUTH support.
CONFIGURED: AuthEntity configured.
SAF FAILURE: AuthEntity configured. Failed to retrieve username or password from the System Authorization Facility (SAF).
SUCCESSFUL: AuthEntity configured. SMTP AUTH successful.
REJECTED: AuthEntity configured. Encrypted username and the password sent to the target server were rejected.
REQUESTED: Auth support requested by the target server, but AuthEntity is not configured.
INVALID CERT: Auth support requested by the target server and AuthEntity is configured but the target server hostname does not match the target server certificate’s SAN or CN.
EMAIL LEVEL: Authentication is at email level.

MAIL ATTEMPTS

The total number of mail messages that CSSMTP has sent or has attempted to send to the target server.

Tip: A single mail message operation can be attempted on multiple target servers.

MAIL SENT

The number of mail messages that were sent successfully for this target server.

Tip: A single mail message that contains multiple recipients can be sent successfully on multiple target servers.

CONNECT FAIL

Count of the number of SMTP connections that the application was unable to establish when it attempted to send mail to a target server.

Example 7: The MODIFY DISPLAY,TARGETS,ADDR=x.x.x.x command displays the global and specific information related to sending e-mail to a specific target server.

  F CSSMTP,DIS,TARGETS,ADDR=10.1.1.1   
    EZD1831I CSSMTP TARGETS: 
     GLOBAL INFORMATION:                                       
      MAIL SENT : 24                   LONG RETRY   : 0       
      DEADLETTER: 0                    UNDELIVERABLE: 0       
     TARGET SERVER: 10.1.1.1                               
      STATE     : ACTIVE                                      
      ESMTP     : YES                  MESSAGE SIZE : 20000000
      STARTTLS  : NO                   MAIL ATTEMPTS: 24    
      AUTH_STATE : NOT CONFIGURED  
      MAIL SENT : 24                   CONNECT FAIL : 0

Example 8: The MODIFY LOGLEVEL,LEVEL=15 command requests the CSSMTP application to change the logging level to 15. The EZD1809I message indicates that the logging level was updated successfully.

F CSSMTP,LOGLEVEL,LEVEL=15     
   EZD1809I CSSMTP1 MODIFY LOGLEVEL COMMAND COMPLETED : UPDATED

Example 9: The MODIFY REFRESH command requests that the CSSMTP application reprocess the configuration file. The following messages indicate that the configuration was updated successfully with no errors.

F CSSMTP,REFRESH     
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED                                    
   EZD1840I CSSMTP UPDATED CONFIGURATION
   EZD1846I CSSMTP UPDATED TARGET SERVERS
   EZD1848I CSSMTP MODIFY REFRESH COMMAND COMPLETED

Result: If an update to the TestMode value is detected during a dynamic refresh, the CSSMTP application continues to run with the old TestMode value and a warning message is written to the log and console.

Example 10: The MODIFY REFRESHIPLIST command requests that the CSSMTP application perform a dynamic DNS refresh of the TargetName or TargetMx field. The following messages indicate that the target server addresses were successfully updated.

F CSSMTP,REFRESHIPLIST
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1845I CSSMTP UPDATED TARGET SERVERS
   EZD1842I CSSMTP MODIFY REFRESHIPLIST COMMAND COMPLETED

Example 11: The MODIFY FLUSHRETRY,TKID=0 command initiates a request to move all mail that is in the long-retry queue to the send queue.

The following messages indicate that all mail messages have been moved from the long-retry queue to the send queue.

F CSSMTP,FLUSHRETRY,TKID=0
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1810I CSSMTP MODIFY FLUSHRETRY,TKID=0 COMMAND COMPLETED

Example 12: The MODIFY FLUSHRETRY command initiates a request to move all mail for TKID 2 from the long-retry queue to the send queue.

The following messages indicate that all mail messages for TKID 2 have been moved from the long-retry queue to the send queue.

F CSSMTP,FLUSHRETRY,TKID=2
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1810I CSSMTP MODIFY FLUSHRETRY,TKID=2 COMMAND COMPLETED

Example 13: The MODIFY REFRESHTARGETS command reinitiates a connection to all target servers.

The following messages indicate that the CSSMTP application completed this request.

F CSSMTP,REFRESHTARGETS
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1821I CSSMTP ABLE TO USE TARGET SERVER 9.1.1.1

Example 14: The MODIFY RESUME command resumes processing of any JES spool files when processing was suspended using the MODIFY SUSPEND operator command.

The following messages indicate that the CSSMTP application will start processing any JES spool files.

F CSSMTP,RESUME
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1814I CSSMTP MODIFY RESUME COMMAND COMPLETED

Example 15: The MODIFY SUSPEND command suspends the reading of mail messages immediately for all JES spool files.

The following messages indicate that the CSSMTP application has suspended the processing of mail messages for all JES spool files.

F CSSMTP,SUSPEND
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1822I CSSMTP MODIFY SUSPEND IMMEDIATE COMMAND COMPLETED

Example 16: The MODIFY FLUSHRETRY,AGE=0 command initiates a request to move all the mails that are in the extended retry queue to the send queue.

The following messages indicate that all mail messages have been moved from the extended retry queue to the send queue.

F CSSMTP,FLUSHRETRY,AGE=0
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1823I CSSMTP MODIFY FLUSHRETRY,AGE=0 COMMAND COMPLETED

Example 17: The MODIFY FLUSHRETRY,AGE=2 command initiates a request to move all mail messages that have been in the extended retry queue for more than two days from the extended retry queue to the send queue.

The following messages indicate that all the extended retry mail messages that are older than two days have been moved from the extended retry queue to the send queue.

F CSSMTP,FLUSHRETRY,AGE=2
   EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
   EZD1823I CSSMTP MODIFY FLUSHRETRY,AGE=2 COMMAND COMPLETED