Format of journal records written to SMF

This section describes the format of journaling records that are written to an SMF data set. You need this information if you write your own program to analyze the data. The three components of the journaling record are an SMF block header, a CICS® product section, and a CICS data section. The layout of an MVS™ SMF log, showing log blocks and CICS sections, is in Figure 86.

Figure 86. Layout of a CICS log written to MVS SMF
 The picture shows a series of log blocks. Each log block is seen to consist of an SMF block header, a CICS product section, and a CICS data section. Each CICS data section is seen to consist of a record header followed by LG caller data.

Journal records written to SMF can be read offline by user-written programs. Such programs can map journal records by including an INCLUDE DFHLGMSD statement. This generates the assembler version of the DSECT.

The SMF block header

This block describes the system creating the output. Its format is shown in Figure 87.

Figure 87. Format of the SMF block header
This fields in this picture are described in the list that follows.

The format of the SMF block header is:

SMFH_LENGTH
2-byte record length.
SMFH_SEG
2-byte segment descriptor (X'0000').
SMFH_FLG
1-byte operating system indicator.
SMFH_RTY
1-byte record type.
SMFH_TME
4-byte (local) time record moved.
SMFH_DTE
4-byte date record moved.
SMFH_SID
4-byte system ID.
SMFH_SSI
4-byte subsystem ID.
SMFH_STY
2-byte record subtype.
SMFH_TRN
2-byte number of triplets in record.
Reserved
2-byte reserved field.
SMFH_APS
4-byte offset to CICS product section.
SMFH_LPS
2-byte length of CICS product section.
SMFH_NPS
2-byte number of CICS product section.
SMFH_ASS
4-byte offset to CICS data section.
SMFH_ASL
2-byte length of CICS data section.
SMFH_ASN
2-byte number of CICS data sections.
Note:
CICS sets only the subsystem-related bits of the operating system indicator flag byte in the SMF header (SMFH_LG). SMF sets the remainder of the byte according to the operating system level and other factors. For an explanation of the setting of the other bits, refer to the z/OS MVS System Management Facilities (SMF) manual.

The CICS product section

This section identifies the subsystem to which the journaling data relates. Its format is shown in Figure 88.

Figure 88. Format of the CICS product section
This fields in this picture are described in the list that follows.

The format of the CICS product section is:

SMFPS_VRM
2-byte CICS version, release, and modification information, in the format X'0vrm'.
SMFPS_PRN
8-byte product name (generic APPLID).
SMFPS_SPN
8-byte product name (specific APPLID).
SMFPS_MFL
2-byte record maintenance indicator.
Reserved
54-byte reserved field.
SMFPS_JNM
8-byte journal name.
SMFPS_JBN
8-byte job name.
SMFPS_RSD
4-byte job date.
SMFPS_RST
4-byte job time (local).
SMFPS_UIF
8-byte user ID.
SMFPS_PDN
8-byte operating system product-level.

The CICS data section

This section contains a variable number of CICS journal records. Each record comprises a general log record header, the format of which is shown in Figure 62. This is followed by a user header, the format of which is shown in Figure 64. This is then followed by the caller data.

If this is the first record being written to the journal after CICS initialization, the record comprises the general log record header, followed by a start-of-run record, the format of which is shown in Figure 63. Subsequent records then take the form already described.

Related concepts
The CICS log manager
Log stream storage
Related tasks
Enabling, disabling, and reading journals
Related reference
Structure and content of CICS Transaction Server for z/OS format journal records
Structure and content of COMPAT41-format journal records
[[ Contents Previous Page | Next Page Index ]]