Steps for configuring and starting CSSMTP

You can use CSSMTP to process and forward your mail. These steps provide the minimum information that you need to configure and start CSSMTP.

Procedure

Perform the following steps to configure and start CSSMTP:

  1. Create a new data set member in your procedure library for the CSSMTP JCL. A sample job is in SEZAINST(CSSMTP). Because the CSSMTP JCL sample contains a JOB card, you should define the procedure library that you use in the IEFJOBS or IEFPDSI concatenation of the master JCL, or put the new data set member in a subsystem procedure library such as SYS1.PROCLIB.
  2. Define explicit authority for all user IDs that you want to be able to start CSSMTP. See Steps for granting authority to start CSSMTP.
  3. Customize the CSSMTP configuration file and set up at least one valid target server IP address using the TargetServer statement. A sample CSSMTP configuration file is included in member CSSMTPCF in SEZAINST. A target server is defined as the IP address that is resolved from or configured on the TargetServer statement. For information about using the TargetServer statement to configure a target server, see z/OS Communications Server: IP Configuration Reference. For information about other configuration statements used by CSSMTP, see z/OS Communications Server: IP Configuration Reference. For information about handling undeliverable mail, see Customizing the CSSMTP configuration file to handle undeliverable mail.

    CSSMTP configuration statements are processed during the initialization of CSSMTP or when you issue the MODIFY procname,REFRESH command.

  4. Set up the resolver search order. Use the default search order unless there are special circumstances that require you to use unique parameters. For example, if the resolver has parameters that are used only when the resolver is called by CSSMTP, you need to define those unique parameters. Define the unique parameters in a data set that is specified on the SYSTCPD DD statement in the CSSMTP procedure JCL. For more information about resolvers and resolver configuration files, see The resolver.
  5. Optionally, set up additional security for CSSMTP. See Security for CSSMTP.
  6. Optionally, allocate and define a Virtual Storage Access Method (VSAM) linear data set for the checkpoint function. A sample job is in SEZAINST(CSSMTPVL).
  7. Set up the timezone using the TZ environment variable. If you do not set up the timezone, the timezone is not shown in the Received header line, which is used to indicate that CSSMTP has picked up a mail message. The default time value is used if the DATE header is not specified in the mail message.
  8. Start CSSMTP by issuing the following command, where csproc is the CSSMTP procedure member name:
    START csproc

Results

You know you are done when initialization is complete and you have successfully connected to the specified target server for processing mail, as indicated by the following messages:
EZD1802I  csproc INITIALIZATION COMPLETE FOR  extWrtName
EZD1821I  csproc ABLE TO USE TARGET SERVER  ipAddress