CSSMTP sample started procedure

This topic contains a copy of the sample procedure.

//CSSMTP   JOB   JESLOG=(SPIN,'00:00'),MSGCLASS=A
//*
//*  JESLOG=(SPIN,'00:00')
//*     Spin the jeslog files once a day at midnight.
//*     This closes out the current JES joblog and creates a new one.
//*
//*  Use 'opt' to pass in parameters.  Example:   s cssmtp,opt='-f'
//CSSMTP   PROC  OPT=''
//*
//*   IBM Communications Server for z/OS
//*   SMP/E distribution name: EZAMLSAM
//*
//*   Licensed Materials - Property of IBM
Start of change//*   5650-ZOS
//*   Copyright IBM Corp. 2009, 2013
//*   Status = CSV2R1End of change
//*
//*   Function: Sample procedure for running the
//*             CSSMTP application
//*
//*   This example shows no input parameter, but -p, -f or both
//*   can be used here
//*
//CSSMTP   EXEC PGM=CSSMTP,REGION=0K,TIME=NOLIMIT,
Start of change//      PARM=('ENVAR("_CEE_ENVFILE_S=DD:STDENV")/&OPT')
//*
//* Environment variables:
//* - Provide environment variables to run with the desired
//*   configuration.  As an example, the data set or file specified byEnd of change
//*   STDENV could contain:
//*
//*   TZ=EST5EDT
//*   CSSMTP_CODEPAGE_CONFIG=IBM-1047
Start of change//*
//*   If you want to include comments in the data set or
//*   z/OS UNIX file, specify the _CEE_ENVFILE_COMMENT
//*   environment variable as the first environment variable
//*   in the data set or file.  The value specified for
//*   the _CEE_ENVFILE_COMMENT variable is the comment character.
//*   For example, if you want to use the pound sign, #, as
//*   the comment character, specify this as the first
//*   statement:
//*     _CEE_ENVFILE_COMMENT=#End of change
//*
//STDENV   DD PATH='/etc/cssmtp.env',PATHOPTS=(ORDONLY)
//*STDENV DD DSN=TCPIP.TCPPARMS(CSSMTPEV),DISP=SHR
//*
//*
//* - The CSSMTP requires a configuration file.  If
//*   DD statement not configured, then the default is
//*   <jobname>.CSSMTP.CONF.   The configuration file can be a
//*   member of an MVS PDS(E), an MVS sequential file,
//*   or a z/OS UNIX file.
//*   See tcpip.SEZAINST(EZAMLCNF) for a sample configuration
//*
//CONFIG DD DSN=TCPIP.TCPPARMS(CSSMTP),DISP=SHR
//*CONFIG DD DSN=TCPIP.CONFIG.CSSMTP,DISP=SHR
//*CONFIG DD PATH='/etc/cssmtp.conf',PATHOPTS=(ORDONLY)
//*
//* - Output written to stdout and stderr goes to the data set or
//*   file specified with or SYSOUT, respectively.
//*   Normally, CSSMTP doesn't write output to stdout or stderr, but
//*   instead, output is written to the log file, which is specified
//*   by LOGFILE DD statement, and defaults to syslog
//*   daemon.  Severe startup errors, such as incorrect options
//*   specified, or being unable to open the log file, log output
//*   is instead written to stdout.
//*
//* - The logfile file can be a MVS sequential file, a z/OS UNIX file,
//*   SYSOUT or syslog daemon.  The default is syslog daemon.
//*
//* - If multiple CSSMTP are logging to the same log file, the user
//*   should use different log files or SYSLOGD.   Using the same
//*   log file from different applications can produce unpredictable
//*   results.
//*
//LOGFILE   DD PATH='/tmp/cssmtp.log',
//             PATHOPTS=(OWRONLY,OCREAT,OAPPEND),
//             PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//*LOGFILE  DD SYSOUT=*,
//*            DCB=(RECFM=VB,LRECL=1028,BLKSIZE=3120)
//*LOGFILE  DD DSN=USER140.CSSMTP.LOG2,DISP=(MOD,CATLG),
//*            SPACE=(TRK,(10)),DCB=(RECFM=VB,LRECL=1028,BLKSIZE=3120)
//*
//* - Input/Output VSAM linear file that contains JES
//*   checkpoint information.   This is used if CSSMTP is not started
//*   with -f.
//*
//*   The Chkpoint file is a VSAM linear file.   If not configured
//*   then no checkpointing is done for JES spool files.
//*   See the sample JCL in CSSMTPVL to allocate the checkpoint
//*   data set.
//*
//*CHKPOINT DD DSN=TCPIP.CSSMTP.CHKPOINT,DISP=SHR
//*
//* - Output written to stdout and stderr goes to the data set or
//*   file specified with SYSOUT, respectively.
//SYSOUT DD SYSOUT=*
//*
//* - SYSTCPD explicitly identifies which data set is to be
//*   used to obtain the parameters defined by TCPIP.DATA
//*   when no GLOBALTCPIPDATA statement is configured.
//*   See the IP Configuration Guide for information on
//*   the TCPIP.DATA search order.
//*   The data set can be any sequential data set or a member of
//*   a partitioned data set (PDS).
//*
//*SYSTCPD  DD DSN=TCPIP.SEZAINST(TCPDATA),DISP=SHR
//* - SYSTCPT is used to receive a detailed trace on how Resolver
//*   is resolving target servers.
//*SYSTCPT  DD SYSOUT=*
//          PEND
//CSSMTP    EXEC CSSMTP
Figure 1. CSSMTP application sample start procedure