CSSMTP statistical record (STATS subtype 52)
This record is written at the end of each MVS™ SMF interval and at the termination of CSSMTP
application. See z/OS MVS System Management Facilities (SMF) for information about setting the SMF interval.
It contains global statistics about spool and mail processing, information
about the health of the CSSMTP program, and the activity of each of
the target server connections during the interval.
Note: Any change
in the SMF recording interval is not acted upon until the previous
interval expires.
See Table 1 for the contents of the TCP/IP stack identification section. For the CSSMTP statistical record, the TCP/IP stack identification section indicates CSSMTP as the subcomponent and X'08' (event record) as the record reason. The field SMF119TI_Stack name is blank unless the -p parameter is used to start the CSSMTP application. If this record is written to NMI, the field SMF119TI_Stack in the NMI record contains the stack name that the record was written to. This is a non-connection oriented SMF record.
Table 1 shows the
CSSMTP statistical record self-defining section.
| Offset | Name | Length | Format | Description |
|---|---|---|---|---|
| 0(X'0') | Standard SMF Header | 24 | Standard SMF header; subtype is 48(X'30') | |
| Self-defining section | ||||
| 24(X'18') | SMF119SD_TRN | 2 | Binary | Number of triplets in this record (6) |
| 26(X'1A') | 2 | Binary | Reserved | |
| 28(X'1C') | SMF119IDOff | 4 | Binary | Offset to TCP/IP identification section |
| 32(X'20') | SMF119IDLen | 2 | Binary | Length of TCP/IP identification section |
| 34(X'22') | SMF119IDNum | 2 | Binary | Number of TCP/IP identification sections |
| 36(X'24') | SMF119S1Off | 4 | Binary | Offset to CSSMTP common information section |
| 40(X'28') | SMF119S1Len | 2 | Binary | Length of CSSMTP common information section |
| 42(X'2A') | SMF119S1Num | 2 | Binary | Number of CSSMTP common information sections |
| 44(X'2C') | SMF119S2Off | 4 | Binary | Offset to CSSMTP statistical data section see table |
| 48(X'30') | SMF119S2Len | 2 | Binary | Length of CSSMTP statistical data section |
| 50(X'32') | SMF119S2Num | 2 | Binary | Number of CSSMTP statistical data sections |
| 52(X'34') | SMF119S3Off | 4 | Binary | Offset to CSSMTP JES statistical section see table |
| 56(X'38') | SMF119S3Len | 2 | Binary | Length of CSSMTP JES statistical section |
| 58(X'36') | SMF119S3Num | 2 | Binary | Number of CSSMTP JES statistical sections |
| 60(X'3C') | SMF119S4Off | 4 | Binary | Offset to CSSMTP health checker statistical section see table |
| 64(X'40') | SMF119S4Len | 2 | Binary | Length of CSSMTP health checker statistical section |
| 66(X'42') | SMF119S4Num | 2 | Binary | Number of CSSMPT health checker statistical sections |
| 68(X'44') | SMF119S5Off | 4 | Binary | Offset to CSSMTP target server statistical section see table |
| 72(X'48') | SMF119S5Len | 2 | Binary | Length of CSSMTP target server statistical section |
| 74(X'4A') | SMF119S5Num | 2 | Binary | Number of CSSMTP target server statistical sections |
Table 2 in CSSMTP configuration record (CONFIG subtype 48) shows the CSSMTP common information section. This section identifies the CSSMTP JOB that created this SMF record. It is found in subtypes 48, 49, 50, 51 and 52.
Table 2 shows the CSSMTP statistical data section. These values reflect the mail processing that is accumulated over the interval. SMF119ML_ST_LRTQCount is the number of messages on the retry queue at the end of the interval.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_ST | 64 | STRUCTURE | CSSMTP Statistics |
| 0(X'0') | SMF119ML_ST_STime | 4 | Binary | Time interval started, in hundredths of seconds |
| 4(X'4') | SMF119ML_ST_SDate | 4 | Packed | Date interval started, in 0CYYDDDF format |
| 8(X'8') | SMF119ML_ST_ETime | 4 | Binary | Time interval ended, in hundredths of seconds |
| 12(X'C') | SMF119ML_ST_EDate | 4 | Packed | Date interval ended, in 0CYYDDDF format |
| 16(X'10') | SMF119ML_ST_Dur | 4 | Binary | Duration of the interval, in hundredths of seconds |
| 20(X'14') | SMF119ML_ST_Flags | 4 | BIT (32) | Application state flags at the end of the interval |
| SMF119ML_ST_NoStck | 1... .... | No stack available | ||
| SMF119ML_ST_STargt | .1.. .... | Suspend - no targets available | ||
| SMF119ML_ST_SImmed | ..1. .... | Suspend immediate | ||
| SMF119ML_ST_SDelay | ...1 .... | Suspend delay | ||
| SMF119ML_ST_Rsv04 | .... 1... | Reserved | ||
| SMF119ML_ST_StgUse | .... .1.. | Storage usage high at 95% | ||
| SMF119ML_ST_Rsv06 | .... ..1. | Reserved | ||
| SMF119ML_ST_Rsv07 | .... ...1 | Reserved | ||
| 21(X'15') | SMF119ML_ST_Rsv1x | 1 | Binary | Reserved |
| 22(X'16') | SMF119ML_ST_Rsv2x | 1 | Binary | Reserved |
| 23(X'17') | SMF119ML_ST_Rsv3x | 1 | Binary | Reserved |
| 24(X'18') | SMF119ML_ST_MailCount | 8 | Binary | Number of new mail messages processed |
| 32(X'20') | SMF119ML_ST_LRTCount | 8 | Binary | Number of mail messages entered long retry |
| 40(X'28') | SMF119ML_ST_LRTDeadLtrCount | 8 | Binary | Number of mail messages that have become dead letters |
| 48(X'30') | SMF119ML_ST_LRTQCount | 8 | Binary | Current number of mail messages on long retry queue |
| 56(X'38') | SMF119ML_ST_UDVCount | 8 | Binary | Number of mail messages that are undeliverable |
| 64(X'40') | SMF119ML_ST_ErtCount | 4 | Binary | Current number of mail messages for extended retry |
| 68(X'44') | SMF119ML_ST_ErtQCount | 4 | Binary | Cumulative total number of mail messages for extended retry |
| 72(X'48') | SMF119ML_ST_ErtUndvl | 4 | Binary | Number of mail messages made undeliverable by extended retry |
| 76(X'4C') | SMF119ML_ST_ErtError | 4 | Binary | Number of mail messages dropped by extended retry due to file system errors |
Table 3 describes the CSSMTP JES statistical data. This data reflects the values from the JES spool files that completed during the interval.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_JS | 64 | STRUCTURE | CSSMTP JES statistics |
| 0(X'0') | SMF119ML_JS_JesFiles | 4 | Binary | Number of JES spool files completed |
| 4(X'4') | SMF119ML_JS_JesRcdCnt | 4 | Binary | Number of JES records read from the JES spool files |
| 8(X'8') | SMF119ML_JS_JesTime | 4 | Binary | Sum of completed JES spool files processing times (hundreds of seconds) |
| 12(X'C') | SMF119ML_JS_JesScan | 4 | Binary | Sum of JES scanning time |
| 16(X'10') | SMF119ML_JS_MAIL | 4 | Binary | Number of mail message found in the spool data sets |
| 20(X'14') | SMF119ML_JS_Good | 4 | Binary | Number of mail messages in the spool dataset that were successfully sent |
| 24(X'18') | SMF119ML_JS_Udv | 4 | Binary | Number of mail messages in the spool dataset that were not sent |
| 28(X'1C') | SMF119ML_JS_Dead | 4 | Binary | Number of dead letter mail resulting from spool dataset processing |
| 32(X'20') | SMF119ML_JS_Rcpt | 4 | Binary | Number of recipients in the spool datasets |
| 36(X'24') | SMF119ML_JS_CRcpt | 4 | Binary | Total recipients sent successfully |
| 40(X'28') | SMF119ML_JS_URcpt | 4 | Binary | Total recipients that are undeliverable |
| 44(X'2C') | SMF119ML_JS_Skip | 4 | Binary | Number of mail skipped due to user exit or restart |
| 48(X'30') | SMF119ML_JS_Bsize | 8 | Binary | Total size in bytes of all mail headers and body sections processed by CSSMTP for the JES spool data set |
| 56(X'38') | SMF119ML_JS_SError | 4 | Binary | Number of mail with syntax error found in the JES spool data sets |
| 60(X'3C') | SMF119ML_JS_RtnCd | 4 | Binary | Number of JES spool jobs fail with nonzero processing return code |
| 64(X'40') | SMF119ML_JS_EMail | 4 | Binary | Number of mail messages saved for extended retry |
| 68(X'44') | SMF119ML_JS_ERcpt | 4 | Binary | Number of recipients to be retried in mail messages saved for extended retry |
Table 4 describes the CSSMTP health checker statistics These are the values at the end of the interval.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_HC | 60 | STRUCTURE | Health Check statistics |
| 0(X'0') | SMF119ML_HC_Time | 4 | Binary | Time of last health check - hundredths of seconds since midnight |
| 4(X'4') | SMF119ML_HC_Date | 4 | Packed | Date of last health check, in 0CYYDDDF format |
| 8(X'8') | SMF119ML_HC_StgTotal | 4 | Binary | Total storage region size for CSSMTP |
| 12(X'C') | SMF119ML_HC_StgIFree | 4 | Binary | Storage available after CSSMTP initialization is completed |
| 16(X'10') | SMF119ML_HC_StgFree | 4 | Binary | Storage currently not in use |
| 20(X'14') | SMF119ML_HC_StgAlloc | 4 | Binary | Storage currently in use |
| 24(X'18') | SMF119ML_HC_StgPUsed | 4 | Binary | Storage percent in use |
| 28(X'1C') | SMF119ML_HC_StgFail | 4 | Binary | Number of storage failures |
| 32(X'20') | SMF119ML_HC_Rsvd1 | 4 | Binary | Reserved |
| 36(X'24') | SMF119ML_HC_DLRPFree | 4 | Binary | Percentage of file system space that is free system-wide and that can be used to store dead letters |
| 40(X'28') | SMF119ML_HC_DLRPUsed | 4 | Binary | Percentage of file system space that is used system-wide |
| 44(X'2C') | SMF119ML_HC_JESDUsed | 4 | Binary | Number of JES DEST tasks busy |
| 48(X'30') | SMF119ML_HC_JESDPerC | 4 | Binary | Percent of JES DEST Tasks busy |
| 52(X'34') | SMF119ML_HC_JESWUsed | 4 | Binary | Number of JES writer tasks busy |
| 56(X'38') | SMF119ML_HC_JESWPerC | 4 | Binary | Percent of JES writer tasks busy |
| 60(X'3C') | SMF119ML_HC_MDirPFree | 4 | Binary | Percentage of file system space that is free system-wide and that can be used to store extended retry mail messages |
| 64(X'40') | SMF119ML_HC_MDirPUsed | 4 | Binary | Percentage of file system space that is used system-wide |
Table 5 describes the target server statistical data. There is one entry for each defined target server IP address. This is the list that is defined at the interval.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_IP | 68 | STRUCTURE | Target Server statistics |
| 0(X'0') | SMF119ML_IP_IP | 16 | Binary | Target server IP address |
| 0(X'0') | SMF119ML_IP_IPPfx | 12 | Binary | 000000000000000000000FFFF |
| 12(X'C') | SMF119ML_IP_IP4 | 4 | Binary | IPv4 Address |
| 16(X'10') | SMF119ML_IP_Port | 2 | Binary | Target server port number |
| 18(X'12') | SMF119ML_IP_Rsvd1 | 2 | Binary | Reserved |
| 20(X'14') | SMF119ML_IP_ConnState | 4 | Binary | Connection state:
|
| 24(X'18') | SMF119ML_IP_MsgSize | 4 | Binary | Maximum message size |
| 28(X'1C') | SMF119ML_IP_RecvdCount | 4 | Binary | Total mail messages received |
| 32(X'20') | SMF119ML_IP_SentCount | 4 | Binary | Total mail messages sent |
| 36(X'24') | SMF119ML_IP_ConCount | 4 | Binary | Connection count |
| 40(X'28') | SMF119ML_IP_ConFailCount | 4 | Binary | Connection failure count |
| 44(X'2C') | SMF119ML_IP_Rsvd2 | 4 | Binary | Reserved |
| 48(X'30') | SMF119ML_IP_RcvdBytes | 8 | Binary | Total number of received bytes |
| 56(X'38') | SMF119ML_IP_SentBytes | 8 | Binary | Total number of sent bytes |
| 64(X'40') | SMF119ML_IP_Flags | 4 | BIT(32) | Flags |
| SMF119ML_IP_ESMTP | 1... .... | ESMTP supported | ||
| SMF119ML_IP_Rsv0x | .111 1111 | Reserved | ||
| 65(X'41') | SMF119ML_IP_Rsv1x | 1 | BIT(8) | Reserved |
| 66(X'42') | SMF119ML_IP_Rsv2x | 1 | BIT(8) | Reserved |
| 67(X'43') | SMF119ML_IP_Rsv3x | 1 | BIT(8) | Reserved |