Steps for configuring SMF records for CSSMTP (optional)

You can use SMF to record CSSMTP events.

Before you begin

CSSMTP can write System Management Facilities (SMF) records for the following cases:

Procedure

Perform the following steps to write SMF records to both the MVS™ SMF data sets and the real-time SMF NMI. Writing SMF records to the MVS SMF data sets and writing SMF records to the real-time SMF NMI are two independent functions and are controlled by different configuration parameters.

  1. Add a SMF119 statement to the CSSMTP configuration file. This configuration parameter controls which SMF record types are written to the MVS SMF data sets. For example:
    SMF119 
    	{
    	CONFIG YES
    	SPOOL YES
    	MAIL NO
    	CONNECT YES
    	STATS YES
    	}
    In this example, the CONFIG, SPOOL, CONNECT and STATS records will be written to MVS SMF data sets and not the MAIL record.
  2. Restart the CSSMTP task or issue a MODIFY REFRESH command to dynamically update CSSMTP with the new SMF119 statement values.
  3. Update the TCP/IP profile NETMONITOR statement to forward all of the CSSMTP SMF records that are associated with the CONFIG, SPOOL, CONNECT, and STATS types to an application using the real-time SMF NMI, SYSTCPSM. These record types are both connection oriented and non-connection oriented (see 5). For more information about SYSTCPSM, see z/OS Communications Server: IP Programmer's Guide and Reference.
    NETMONITOR SMFSERVICE CSSMTP
    For the descriptions of the SMF records see z/OS Communications Server: IP Programmer's Guide and Reference.
  4. Update the TCPIP profile NETMONITOR statement to forward all the CSSMTP SMF records associated with the MAIL type to an application using the real-time SMF NMI, SYSTCPSM.
    NETMONITOR SMFSERVICE CSMail
    For more information about SYSTCPSM, see z/OS Communications Server: IP Programmer's Guide and Reference.
  5. Special considerations for CSSMTP application and NETMONITOR in a CINET environment:
    • The CSSMTP application can be started with the -p parameter to set stack affinity. This enables that all of the SMF records will be written to the real-time SMF NMI associated with the stack whose name was specified on the -p parameter. This forces connection oriented SMF records (CONNECT) and non-connection oriented SMF records (CONFIG, SPOOL, MAIL and STATS) to go to the same stack. The CSSMTP and CSMAIL NETMONITOR parameters should be specified in the profile data sets of the stack name to match the name specified on the -p parameter.
    • If the CSSMTP application is started without the -p parameter and multiple stacks are active, then a network management application can not determine the stack that records will be written to. The CSSMTP and CSMAIL NETMONITOR parameters should be specified in the profile data sets of all stacks, so that network management applications can obtain all the records. The network management application will not get redundant records. In this case CSSMTP writes the records to the first stack with an active SMFService application and with the appropriate SMFSERVICE CSMAIL or CSSMTP parameter set.