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
//* 5650-ZOS
//* Copyright IBM Corp. 2009, 2013
//* Status = CSV2R1
//*
//* 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,
// 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 by
//* STDENV could contain:
//*
//* TZ=EST5EDT
//* CSSMTP_CODEPAGE_CONFIG=IBM-1047
//*
//* 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=#
//*
//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