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.
  
  --------------------------------------------------------------------
Table 1.
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

Table 2.
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


DFHLGMSK.html | Timestamp icon Last updated: Sunday, 4 June 2017