LGMS - SMF Log Format
Licensed Materials - Property of IBM 5655-Y04 (C) Copyright IBM Corp. 1994, 1998 All Rights Reserved. A CICS user journal (not the System Log) can be defined to reside upon SMF (a special log that MVS SMF manages). This log comprises a sequence of contiguous blocks, some of which are built and written by CICS. Each block built and written by CICS comprises a SMF block header, CICS SMF product section, followed by a CICS data section. The latter comprises of a variable number of CICS records. The format of the block header is defined by the dsect "smf_block_header". The SMF CICS data section, which only shows its start address, has been included for completeness. In reality this section includes a variable number of CICS records. Each CICS record comprise a record header followed by the caller data part. The format of the record header is defined by the dsect "glrh_record_header". The format of the caller data part is unknown at the Log Manager functional level. It usually comprises one or several other CICS component record headers. The record header fields "glrh_rec_type" and "glrh_rec_compid" indicates which CICS component is to be used to define this part of the record. The following diagram shows the physical layout of an SMF log block MVS SMF log __ first log block __ __ smf block header (smf_header) __ __ smf cics product section (smf_product_section) __ __ smf cics data section (smf_data_section) __ __ __ first cics record __ __ __ __ record header (lgrh_record_header) __ __ __ __ caller data __ __ __ next cics record __ __ __ ... __ __ __ last cics record __ __ __ ... __ next general log block __ ... __ last general log block __ ... This copybook defines the SMF block header. It should be used in conjunction with the General Log copybook DFHLGGFD which defines the record header and user header. -------------------------------------------------------------------- Each block starts with a block header as defined here. --------------------------------------------------------------------
| Offset Hex | Type | Len | Name (Dim) | Description |
|---|---|---|---|---|
| (0) | STRUCTURE | 158 | SMF_BLOCK_HEADER | |
| (0) | STRUCTURE IsA( SMFLOGBLOCKHEADER) | 158 | * | |
| (0) | CHARACTER | 44 | SMF_HEADER | |
| (0) | UNSIGNED | 2 | SMFH_LEN | record length |
| (2) | UNSIGNED | 2 | SMFH_SEG | segment descriptor |
| (4) | CHARACTER | 1 | SMFH_FLG | operating system indicator (see constant prefixed smfh_flg below) |
| (5) | CHARACTER | 1 | SMFH_RTY | record type (see constant prefixed smfh_rty below) |
| (6) | CHARACTER | 4 | SMFH_TME | time record moved (HHMMSST+ ) |
| (A) | CHARACTER | 4 | SMFH_DTE | date record moved (0CYYDDD+ ) |
| (E) | CHARACTER | 4 | SMFH_SID | system identification |
| (12) | CHARACTER | 4 | SMFH_SSI | sub-system identification (see constant prefixed smfh_ssi below) |
| (16) | UNSIGNED | 2 | SMFH_STY | record subtype (see constant prefixed smfh_sty below) |
| (18) | UNSIGNED | 2 | SMFH_TRN | number of triplets in record |
| (1A) | UNSIGNED | 2 | SMFH_RSVD1 | reserved |
| (1C) | UNSIGNED | 4 | SMFH_APS | offset to CICS product section |
| (20) | UNSIGNED | 2 | SMFH_LPS | length of CICS product section |
| (22) | UNSIGNED | 2 | SMFH_NPS | number of CICS product sections |
| (24) | UNSIGNED | 4 | SMFH_ASS | offset to CICS data section |
| (28) | UNSIGNED | 2 | SMFH_ASL | length of CICS data section |
| (2A) | UNSIGNED | 2 | SMFH_ASN | number of CICS data sections |
| (2C) | CHARACTER | 0 | * | |
| (2C) | CHARACTER | 114 | SMF_PRODUCT_SECTION | |
| (2C) | CHARACTER | 2 | SMFPS_VRM | record version format x'0vrm' v = version r = release m = modification (set to &SMF in DFHSYS) |
| (2E) | CHARACTER | 8 | SMFPS_PRN | product name (generic APPLID) |
| (36) | CHARACTER | 8 | SMFPS_SPN | specific APPLID |
| (3E) | CHARACTER | 2 | SMFPS_MFL | record maintenance indicator |
| (40) | CHARACTER | 2 | SMFPS_RSVD2 | reserved |
| (42) | CHARACTER | 52 | SMFPS_RSVD3 | reserved |
| (76) | CHARACTER | 8 | SMFPS_JNM | journal name |
| (7E) | CHARACTER | 8 | SMFPS_JBN | jobname |
| (86) | CHARACTER | 4 | SMFPS_RSD | job date |
| (8A) | CHARACTER | 4 | SMFPS_RST | job time |
| (8E) | CHARACTER | 8 | SMFPS_UIF | user identification |
| (96) | CHARACTER | 8 | SMFPS_PDN | operating system product level |
| (9E) | CHARACTER | 0 | * | |
| (9E) | CHARACTER | 0 | SMF_DATA_SECTION | CICS records |
| (9E) | CHARACTER | 0 | SMFDS_DATA | records follow |
Constants
| Len | Type | Value | Name | Description |
|---|---|---|---|---|
| 4 | CHARACTER | CICS | SMFH_SSI_CICS | sub-system identification |
| 1 | CHAR HEX | DE | SMFH_FLG_ESA4 | MVS/ESA V4 |
| 1 | CHAR HEX | 6E | SMFH_RTY_110 | record type 110 for CICS |
| 2 | DECIMAL | 0 | SMFH_STY_LG | for journaling |
| 2 | DECIMAL | 1 | SMFH_STY_MN | for monitoring |
| 2 | DECIMAL | 2 | SMFH_STY_ST | for statistics |
| 4 | DECIMAL | 2 | SMFH_NUMBER_TRIPLETS | |
| 4 | DECIMAL | 0 | SMFH_MFL_ID | |
| 2 | DECIMAL | 0 | SMFPS_MFL_0 | |
| 4 | DECIMAL | 44 | SMFH_PRD_SECT_OFFSET | |
| 4 | DECIMAL | 114 | SMFH_PRD_SECT_LENGTH | |
| 4 | DECIMAL | 1 | SMFH_PRD_SECT_NUMBER | |
| 4 | DECIMAL | 158 | SMFH_DATA_SECT_OFFSET | |
| 4 | DECIMAL | 0 | SMFH_DATA_SECT_LENGTH | |
| 4 | DECIMAL | 1 | SMFH_DATA_SECT_NUMBER | |
| 4 | DECIMAL | 32756 | SMF_MAX_BLOCK_LEN | |
| 4 | DECIMAL | 32598 | SMF_MAX_DATA_SECTION_ LEN | |