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.
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.
This block describes the system creating the output. Its format is shown
in Figure 87.
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.
This section identifies the subsystem to which the journaling data relates.
Its format is shown in Figure 88.
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.
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.
[[ Contents Previous Page | Next Page Index ]]