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 CSSMTP information in z/OS Communications Server: IP Configuration Guide.
>>-+-MODIFY-+--procname,--+-Display,--+-CONFig-----------------------------------+-+->< '-F------' | +-IPlist-----------------------------------+ | | +-LOGlevel---------------------------------+ | | | .-,Summary----------------. | | | +-SPoolstatus--+-------------------------+-+ | | | +-,Summary----------------+ | | | | | .-,ALL-------. | | | | | '-,Detail--+------------+-' | | | | +-,ALL-------+ | | | | '-,TKID=tkid-' | | | '-TARgets--+-----------------+-------------' | | '-,ADDR=ipAddress-' | +-FLUSHRetry,-+-AGE=--days--+----------------------------+ | '-TKID=--tkid-' | +-LOGlevel,LEVEL=logLevel--------------------------------+ +-REFRESH------------------------------------------------+ +-REFRESHIPlist------------------------------------------+ +-REFRESHTargets-----------------------------------------+ +-RESume-------------------------------------------------+ | .-,Immediate-. | +-SUSpend-+------------+---------------------------------+ | +-,Delay-----+ | | '-,Immediate-' | '-USERexit,LEVEL=-+-NONE-----+---------------------------' +-VERSION2-+ '-VERSION3-'
Tip: Use this command to obtain the task ID to use on other modify commands that use task ID values as options.
Tip: You can use the MODIFY DISPLAY,SPOOLSTATUS command to obtain a valid TKID value.
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.
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.
A days value of 0 specifies that all messages in the extended retry list are to be processed.
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.
Result: The user exit value does not change until the next JES spool file is opened.
F CSSMTP,DISPLAY,LOGLEVEL
EZD1828I CSSMTP DISPLAY LOGLEVEL = 15
F CSSMTP,DISPLAY,CONFIG
EZD1829I CSSMTP CONFIGURATION:
CONFIGFILENAME : /U/USER1/CSSMTP/CSSMTP.CONF
LOGFILENAME : /U/USER1/CSSMTP/CSSMTP.LOG0707S1
CHKPOINTFILENAME : 'USER1.CSSMTP.CHKPOINT'
PID : 67108874
LOGLEVEL : 255 USEREXIT : NONE
CHKPOINTSIZELIMIT : 64000 CHKPOINT : WARM
CONFIG CODEPAGE : IBM-1047
TRANSLATE : IBM-1047
START OPTION TCPNAME : N/A IPV6 ENABLED : YES
EXTWRTNAME : CSSMTP HOST NAME : VIC142
DOMAIN NAME : RALEIGH.IBM.COM
HEADER :
DATE : YES
USERINFO : YES
JESJOBSIZE : 0 JESMSGSIZE : 0
JESSYNTAXERRLIMIT : 5
BADSPOOLDISP : HOLD REPORT : SYSOUT
UNDELIVERABLE:
RETURNTOMAILFROM : YES DEADLETTERACTION: STORE
DEADLETTERDIRECTORY : /var/cssmtp/myDir/
RETRYLIMIT:
COUNT : 5 INTERVAL : 1
EXTENDEDRETRY : ACTIVE
AGE : 100 INTERVAL : 30
MAILDIRECTORY : /var/cssmtp/CSSMTP/mail/
SMF119:
CONFIG : YES CONNECT : YES
MAIL : YES SPOOL : YES
STATS : YES
TARGETSERVER:
TARGETNAME : D03AV01.BOULDER.IBM.COM
CONNECTPORT : 25 CONNECTLIMIT : 5
MAXMSGSENT : 1000 MESSAGESIZE : 524288
SECURE : NO
TARGETIP : 9.100.1.2
CONNECTPORT : 25 CONNECTLIMIT : 5
MAXMSGSENT : 1000 MESSAGESIZE : 524288
SECURE : NO
TIMEOUT:
ANYCMD : 300 CONNECTRETRY : 120
DATABLOCK : 180 DATAINIT : 120
DATATERM : 600 INITIALMSG : 300
MAILCMD : 300 RPCTCMD : 300
MAILADMINISTRATOR : USER1@US.IBM.COM
USER2@US.IBM.COM
USER3@US.IBM.COM
USER4@US.IBM.COM
For definitions
of statements and parameters that are obtained from configuration
file, see the CSSMTP information
in z/OS Communications Server: IP Configuration
Reference. F CSSMTP,DISPLAY,IPLIST
EZD1830I CSSMTP IPLIST:
TARGETIP : 9.100.1.5
CONNECTPORT : 25 CONNECTLIMIT : 5
MAXMSGSENT : 1000 MESSAGESIZE : 524288
SECURE : NO
TARGETIP : 9.56.231.69
CONFIG TARGETNAME : RALVMS
CONNECTPORT : 25 CONNECTLIMIT : 2
MAXMSGSENT : 2000 MESSAGESIZE : 524288
SECURE : YES
TARGETIP : 9.200.1.6
CONNECTPORT : 25 CONNECTLIMIT : 5
MAXMSGSENT : 1000 MESSAGESIZE : 524288
SECURE : NO
For the definitions of
statements and parameters that are obtained from the configuration
file, see the CSSMTP information
in z/OS Communications Server: IP Configuration
Reference. F CSSMTP,DISPLAY,IPLIST
EZD1830I USER1408 IPLIST:
TARGETIP : 9.56.231.69
CONFIG TARGETMX : mxName
PREFERENCE : 1
CONNECTPORT : 25 CONNECTLIMIT : 2
MAXMSGSENT : 2000 MESSAGESIZE : 524288
SECURE : YES
TARGETIP : 9.56.200.55
CONFIG TARGETMX : mxName
PREFERENCE : 1
CONNECTPORT : 25 CONNECTLIMIT : 2
MAXMSGSENT : 2000 MESSAGESIZE : 524288
SECURE : NO
For the definition of statements
and parameters that are obtained from configuration file, see the CSSMTP information in z/OS Communications Server: IP Configuration
Reference. 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
Tip: You can use the task ID in the MODIFY FLUSHRetry command and the MODIFY DISPLAY,SPOOLSTATUS,DETAIL,TKID=tkid command.
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
08/01 07:10:20 CSSMTP DEBUG :002:mlJESThread:Message(0): ...
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 1.1.1.1
STATE : ACTIVE
ESMTP : YES MESSAGE SIZE : 20000000
STARTTLS : NO MAIL ATTEMPTS: 24
MAIL SENT : 24 CONNECT FAIL : 0
TARGET SERVER ::6
STATE : ACTIVE
ESMTP : YES MESSAGE SIZE : 20000000
STARTTLS : YES MAIL ATTEMPTS: 30
MAIL SENT : 30 CONNECT FAIL : 0
Tip: A single mail message operation can be attempted on multiple target servers.
Tip: A single mail message that contains multiple recipients can be sent successfully on multiple target servers.
F CSSMTP,DIS,TARGETS,ADDR=1.1.1.1
EZD1831I CSSMTP TARGETS:
GLOBAL INFORMATION:
MAIL SENT : 24 LONG RETRY : 0
DEADLETTER: 0 UNDELIVERABLE: 0
TARGET SERVER 1.1.1.1
STATE : ACTIVE
ESMTP : YES MESSAGE SIZE : 20000000
SECURE : NO MAIL ATTEMPTS: 24
MAIL SENT : 24 CONNECT FAIL : 0
F CSSMTP,LOGLEVEL,LEVEL=15
EZD1809I CSSMTP1 MODIFY LOGLEVEL COMMAND COMPLETED : UPDATED
F CSSMTP,REFRESH
EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
EZD1840I CSSMTP UPDATED CONFIGURATION
EZD1846I CSSMTP UPDATED TARGET SERVERS
EZD1848I CSSMTP MODIFY REFRESH COMMAND COMPLETED
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.
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.
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.
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.
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.
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.
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.
F CSSMTP,FLUSHRETRY,AGE=2
EZD1834I CSSMTP MODIFY COMMAND ACCEPTED
EZD1823I CSSMTP MODIFY FLUSHRETRY,AGE=2 COMMAND COMPLETED