CSSMTP spool file record (SPOOL subtype 51)
This record is written when all the mail messages have been processed. It contains information about the spool file and statistics about the mail messages that are processed.
See Table 1 for the contents of the TCP/IP stack identification section. For the CSSMTP spool file record, the TCP/IP stack identification section indicates the stack name with blanks, CSSMTP as the subcomponent, and X'08' (event record) as the record reason. The name of field SMF119TI_Stack will be blank unless the -p parameter is used to start the CSSMTP application. If the 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.
| Offset | Name | Length | Format | Description |
|---|---|---|---|---|
| 0(X'0') | Standard SMF Header | 24 | Standard SMF header; subtype is 51(X'33') | |
| 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...see table |
| 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...see table |
| 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 spool identification section see table |
| 48(X'30') | SMF119S2Len | 2 | Binary | Length of spool identification section |
| 50(X'32') | SMF119S2Num | 2 | Binary | Number of spool identification sections |
| 52(X'34') | SMF119S3Off | 4 | Binary | Offset to spool job section see table |
| 56(X'38') | SMF119S3Len | 2 | Binary | Length of spool job section |
| 58(X'36') | SMF119S3Num | 2 | Binary | Number of spool job sections |
| 60(X'3C') | SMF119S4Off | 4 | Binary | Offset to spool statistics section see table |
| 64(X'40') | SMF119S4Len | 2 | Binary | Length of spool statistics section |
| 66(X'42') | SMF119S4Num | 2 | Binary | Number of spool statistics section |
| 68(X'44') | SMF119S5Off | 4 | Binary | Offset to spool accounting section see table |
| 72(X'48') | SMF119S5Len | 2 | Binary | Length of spool accounting section |
| 74(X'4A') | SMF119S5Num | 2 | Binary | Number of spool accounting 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.
See Table 2 in CSSMTP mail record (MAIL subtype 50) for the contents of the common Spool Identification section. This section identifies the spool job that created the sysout file. It is found in subtypes 50 and 51.
Table 2 describes the JES SSI information for the spool file job.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_SJ | 140 | STRUCTURE | Spool Job data |
| 0(X'0') | SMF119ML_SJ_BYCT | 8 | Binary | Byte count |
| 8(X'8') | SMF119ML_SJ_LNCT | 4 | Binary | Line count |
| 12(X'C') | SMF119ML_SJ_PRCD | 8 | EBCDIC | Data set procname |
| 20(X'14') | SMF119ML_SJ_STPD | 8 | EBCDIC | Data set stepname |
| 28(X'1C') | SMF119ML_SJ_DDND | 8 | EBCDIC | Data set DD name |
| 36(X'24') | SMF119ML_SJ_PNAM | 20 | EBCDIC | Programmer name from job |
| 56(X'38') | SMF119ML_SJ_NOTN | 8 | EBCDIC | Job notify node |
| 64(X'40') | SMF119ML_SJ_NOTU | 8 | EBCDIC | Job notify user ID |
| 72(X'48') | SMF119ML_SJ_CLAR | 1 | EBCDIC | Sysout class of data set |
| 73(X'49') | SMF119ML_SJ_LSAB | 3 | Binary | Last abend code for the job that created the spool file (JES 2 only) |
| 76(X'4C') | SMF119ML_SJ_DSN | 44 | EBCDIC | Data set name of the spool file |
| 120(X'78') | SMF119ML_SJ_NACT | 8 | EBCDIC | Network accounting number |
| 128(X'80)' | SMF119ML_SJ_UserExit | 4 | Binary | User exit version 0-SMF119ML_SJ_USEREXIT_NONE 2-SMF119ML_SJ_USEREXIT_VERSION2 3-SMF119ML_SJ_USEREXIT_VERSION3 |
| 132(X'84') | SMF119ML_SJ_QTime | 4 | Binary | Time spool file queued to JES - Hundredths of second |
| 136(X'88') | SMF119ML_SJ_QDate | 4 | Packed | Date spool file queued to JES - 0CYYDDDF |
Table 3 describes the spool job statistics.
| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_SS | 100 | STRUCTURE | Spool Job statistics |
| 0(X'0') | SMF119ML_SS_STime | 4 | Binary | Time when CSSMTP started to read the spool data set - Hundredths of seconds since midnight |
| 4(X'4') | SMF119ML_SS_SDate | 4 | Packed | Date when CSSMTP started to read the spool data set - 0CYYDDDF |
| 8(X'8') | SMF119ML_SS_RTime | 4 | Binary | Time when CSSMTP completed reading the spool data set. Hundredths of seconds since midnight |
| 12(X'C') | SMF119ML_SS_RDate | 4 | Packed | Date when CSSMTP completed reading the spool data set - 0CYYDDDF |
| 16(X'10') | SMF119ML_SS_RcdCnt | 4 | Binary | Number of spool file records CSSMTP read |
| 20(X'14') | SMF119ML_SS_ETime | 4 | Binary | Time all mail is processed for this spool data set. Hundredths of seconds since midnight |
| 24(X'18') | SMF119ML_SS_EDate | 4 | Packed | Date all mail is processed for this spool data set 0CYYDDDF |
| 28(X'1C') | SMF119ML_SS_MAIL | 4 | Binary | Total number of mail messages found in the spool data set. |
| 32(X'20') | SMF119ML_SS_Good | 4 | Binary | Number of mail messages successfully sent |
| 36(X'24') | SMF119ML_SS_Udv | 4 | Binary | Number of undeliverable mails resulting from spool data set processing |
| 40(X'28') | SMF119ML_SS_Dead | 4 | Binary | Number of Deadletter mail resulting from spool data set processing |
| 44(X'2C') | SMF119ML_SS_Rcpt | 4 | Binary | Total number of recipients (RCPTs) in the spool data set |
| 48(X'30') | SMF119ML_SS_CRcpt | 4 | Binary | Total number of recipients (RCPTs) sent successfully in the spool data set |
| 52(X'34') | SMF119ML_SS_URcpt | 4 | Binary | Total number of recipients (RCPTs) that are undeliverable |
| 56(X'38') | SMF119ML_SS_Skip | 4 | Binary | Number of mail skipped due to user exit or restart (checkpointing) |
| 60(X'3C') | SMF119ML_SS_Err | 4 | Binary | Number of mails with syntax errors in jes spool data set |
| 64(X'40') | SMF119ML_SS_Bsize | 8 | Binary | Total size in bytes of all mail headers and bodies processed by CSSMTP for the JES spool data set |
| 72(X'48') | SMF119ML_SS_RtnCd | 4 | Binary | Processing return codes: SMF119ML_SS_Alloc 07 JES sysout allocation failed SMF119ML_SS_OPEN 08 Open failed for sysout file SMF119ML_SS_REQERR 10 IEFSSREQ failed SMF119ML_SS_APIERR 11 IEFSSREQ SSS2 API failed SMF119ML_SS_ICONV 13 Conversion table open error SMF119ML_SS_EMPTY 14 Empty data set SMF119ML_SS_JESSIZE 15 size exceeds JesJobSize SMF119ML_SS_SAF 16 Access is not authorized SMF119ML_SS_TRANSLATE 18 Translation error SMF119ML_SS_NOEBCDIC 19 Unknown translation table SMF119ML_SS_USEREXIT 21 The return code from the CSSMTP user exit indicates that the processing of the spool file should stop SMF119ML_SS_NOMAIL 22 The spool file does not contain any mail transactions SMF119ML_SS_JESCLOSE 23 The JES spool file was not properly closed by JES and the file data might be incomplete SMF119ML_SS_IOERROR 24 An I/O error occurred during reading the spool file SMF119ML_SS_MAXERROR 25 Maximum number of syntax errors in spool file was reached |
| 76(X'4C') | SMF119ML_SS_Flags | 4 | BIT(32) | Flags |
| SMF119ML_SS_TLS | 1... .... | JES spool data set contained STARTTLS command | ||
| SMF119ML_SS_Finis | .1.. .... | CSSMTP completed processing the spool data set | ||
| SMF119ML_SS_ErrRpt | ..1. .... | Spool data set was generated by CSSMTP for error report | ||
| SMF119ML_SS_Hold | ...1 .... | Final disposition of data set 1 - HOLD 0 - DELETE | ||
| SMF119ML_SS_Error | .... 1... | One or more syntax errors were found when the spool file was processed | ||
| SMF119ML_SS_Rsv05 | .... .1.. | Reserved | ||
| SMF119ML_SS_Rsv06 | .... ..1. | Reserved | ||
| SMF119ML_SS_Rsv07 | .... ...1 | Reserved | ||
| 77(X'4D') | SMF119ML_SS_Xmit | 1... .... | Spool data set is in NetData format | |
| SMF119ML_SS_RStrt | .1.. .... | Spool data set was restarted due to checkpointing | ||
| SMF119ML_SS_Rsv12 | ..1. .... | Reserved | ||
| SMF119ML_SS_Rsv13 | ...1 .... | Reserved | ||
| SMF119ML_SS_Rsv14 | .... 1... | Reserved | ||
| SMF119ML_SS_Rsv15 | .... .1.. | Reserved | ||
| SMF119ML_SS_Rsv16 | .... ..1. | Reserved | ||
| SMF119ML_SS_Rsv17 | .... ...1 | Reserved | ||
| 78(X'4E') | SMF119ML_SS_RStc | 1... .... | Data set created by started task | |
| SMF119ML_SS_RTsc | .1.. .... | Data set created by time sharing user | ||
| SMF119ML_SS_RJob | ..1. .... | Data set created by batch job | ||
| SMF119ML_SS_Rsv23 | ...1 .... | Reserved | ||
| SMF119ML_SS_Rsv24 | .... 1... | Reserved | ||
| SMF119ML_SS_Rsv25 | .... .1.. | Reserved | ||
| SMF119ML_SS_Rsv26 | .... ..1. | Reserved | ||
| SMF119ML_SS_Rsv27 | .... ...1 | Reserved | ||
| 79(X'4F') | SMF119ML_SS_Flag4 | 1 | BIT(8) | Reserved |
| 80(X'50') | SMF119ML_SS_EMail | 4 | Binary | Number of mail messages saved for extended retry |
| 84(X'54') | SMF119ML_SS_ERcpt | 4 | Binary | Number of recipients to be retried in mail messages saved for extended retry |
Table 4 describes the CSSMTP SMF job accounting information section. It contains information about the source spool file. If there is no accounting information (the number of entries is zero), then this section is not present.
Accounting information is in SMF format as it is in type 5 and type 30 SMF records. For more information about the accounting field, see z/OS MVS System Management Facilities (SMF).
AL1(number-of-pairs-that-follow) followed by 1 or more fields
AL1(length),CLlength'string' A length of 0 indicates
an omitted field DC AL1(4) Nr of fields
DC AL1(5),CL5'X3600' field 1
DC AL1(2),CL2'42' field 2
DC AL1(0) field 3 (null)
DC AL1(4),CL4'ANDY' field 4| Offset | Name(Dim) | Length | Type | Description |
|---|---|---|---|---|
| 0(X'0') | SMF119ML_SA | 144 | STRUCTURE | Spool Job Accounting |
| 0(X'0') | SMF119ML_SA_Cnt | 1 | Binary | Number of accounting sections |
| 1(X'1') | SMF119ML_SA_Txt | 143 | EBCDIC | Encoded accounting information |