SMF Type 230 Record
This table shows the record layout for type 230 SMF records
(CA-Endevor SMF Record).
List of other SMF record layouts available.
List of sample SMF reports.
Purpose: When SMF logging is enabled, CA-Endevor records each action and each security violation that occurs during CA Endevor SCM processing. SMF recording is done on an Environment-by-Environment basis. Therefore, you can selectively enable SMF recording for each of your Environments. The SMF option can write out the following SMF records:
- Security records For each security violation, or each error that is returned from the security exit (exit 1).
- Activity records For each action executed, except for the following actions: Print, Display, Copy, and List. Activity records are written out at the end of action processing.
It's easy to report on SMF 230 data! | |
|
Spectrum SMF Writer handles the difficult SMF record parsing for you automatically. You just specify which fields you want to see. Spectrum SMF Writer also converts the arcane date and time fields and reformats them into an attractive report. Plus, Spectrum SMF Writer can export SMF data as comma delimited files to use on your PC.
|
The Spectrum Writer definitions for the SMF type 230 record below are based on the description provided by IBM in its "MVS Systems Management Facilities (SMF)" manual and/or DSECTs mapped by its Assembler macros.
|
File Definition for Type 230 SMF Records CA-Endevor SMF Record
***********************************************************************
* SPECTRUM SMF WRITER -- FILE DEFINITION STATEMENTS *
* SMF TYPE 230 RECORD - "CA-ENDEVOR SMF RECORD" *
***********************************************************************
OPTION: MISSOFFSET /* TREAT OFFSET ERRORS (99999) LIKE MISSING DATA */
OPTION: STCKADJ(0) /* NO GMT TO LOCAL CONVERSION - DURATIONS*/
*********************************************************************
* *
* - HEADER FOR THE SMF RECORDS FOR ENDEVOR-C1 *
* *
*********************************************************************
FLD: SMHLEN TYPE(HALF) DISP(0) /*LENGTH OF THE OVERALL RECORD*/
FLD: SMHSEGID TYPE(HALF) DISP(2) /*** RESERVED ***/
FLD: SMHSID LEN(1) DISP(4) /*SYSTEM TYPE ID*/
COMP: SMH#VS2 = X'02' /*VS2 INDICATOR*/
COMP: SMH#VS1 = X'01' /*VS1 INDICATOR*/
FLD: SMHRECTY LEN(1) TYPE(BU) DISP(5)
/*SMF RECORD TYPE ( DEFAULT 230)*/
FLD: SMHTIME LEN(4) TYPE(B-SECS) DISP(6) DEC(2)
/*TIME IN HUNDREDTHS OF A SECOND*/
FLD: SMHDATE TYPE(P-CYYDDD) DISP(10) /*DATE*/
FLD: SMHCPUID LEN(4) DISP(14) /*CPU FROM SYSTEM WRITING RECORD*/
FLD: SMHHDLEN TYPE(HALF) DISP(18) /*LENGTH OF THIS HEADER*/
FLD: SMHC1VER LEN(1) DISP(20) /*ENDEVOR C1 RECORD FORMAT VERSION*/
COMP: SMH#RF00 = X'00' /*RELEASE 2.2 AND PRIOR RELEASES*/
COMP: SMH#RF01 = X'01' /*RELEASE 2.5 THRU CURRENT*/
FLD: SMHCTLTY LEN(1) DISP(21) /*ENDEVOR C1 RECORD SUBTYPE*/
COMP: SMH#SEC = X'01' /*SECURITY RECORD TYPE*/
COMP: SMH#ACT = X'02' /*ACTION RECORD TYPE*/
COMP: SMH#ESI = X'03' /*ESI EXCEPTION WARNING RECORD*/
COMP: SMH#ENV = X'04' /*ENVIRONMENT MCF CHANGES*/
FLD: SMHCONT TYPE(HALF) DISP(22) /*CONTINUATION FLAG FOR RECORD*/
FLD: SMHSEQ TYPE(HALF) DISP(24) /*SEQUENCE NUMBER OF RECORD*/
FLD: SMHC1ENV LEN(8) DISP(26) /*ENDEVOR C1 ENVIRONMENT NAME*/
FLD: SMHUSER LEN(8) DISP(34) /*USER ISSUING REQUEST*/
***********************************************************************
**** SMFREC2 DSECT
***********************************************************************
COMP: SMFREC2_OFFSET =
WHEN(SMHCTLTY = X'02') ASSIGN(SMHHDLEN)
ELSE ASSIGN(99999)
FLD: SMFREC2 DISP(0) LEN(1) OFFSET(SMFREC2_OFFSET)
***********************************************************************
* *
* SMFREC2 - DESCRIPTION FOR THE ACTIVITY RECORD *
* *
***********************************************************************
*SM2REC1 EQU * START OF THE SMF 2 RECORD
FLD: SM2RECLN TYPE(HALF) DISP(0) /*LENGTH OF THE ACTIVITY RECORD*/
FLD: SM2RECVN TYPE(HALF) DISP(2) /*VERSION OF THE RECORD*/
COMP: SM2#V1 = X'01' /*VERSION 1*/
FLD: SM2FUNC LEN(4) TYPE(BIN) DISP(4) /*ACTION CODE*/
* SEE ECBFUNC OF ECBDS FOR LIST OF
* ACTIONS.
FLD: SM2FUNNM LEN(8) DISP(8) /*FUNCTION NAME*/
FLD: SM2BLKS LEN(4) TYPE(BIN) DISP(16) /*NUMBER OF BLOCKS IN RECORD*/
COMP: SM2#ENV = 1 /*ENVIRONMENT BLOCK*/
COMP: SM2#LCHG = 2 /*LAST CHANGE BLOCK*/
COMP: SM2#PROC = 3 /*PROCESSOR INFO BLOCK*/
COMP: SM2#REQP = 4 /*REQUEST PARMS BLOCK*/
FLD: SM2RECHD TYPE(HALF) DISP(20) /*SIZE OF THE SM2 HEADER*/
FLD: SM2IFUNC TYPE(HALF) DISP(22) /*INTERNAL SECURITY FUNCTION*/
* SEE ECBFUNC OF ECBDS FOR LIST OF
* ACTIONS.
*SM2DATA DS 0D
COMP: BLK1O = SMHHDLEN + SM2RECHD
FLD: BLK1L TYPE(HALF) OFFSET(BLK1O)
FLD: BLK1T TYPE(HALF)
COMP: BLK2O = BLK1O + BLK1L
FLD: BLK2L TYPE(HALF) OFFSET(BLK2O)
FLD: BLK2T TYPE(HALF)
COMP: BLK3O = BLK2O + BLK2L
FLD: BLK3L TYPE(HALF) OFFSET(BLK3O)
FLD: BLK3T TYPE(HALF)
COMP: BLK4O = BLK3O + BLK3L
FLD: BLK4L TYPE(HALF) OFFSET(BLK4O)
FLD: BLK4T TYPE(HALF)
COMP: BLK5O = BLK4O + BLK4L
FLD: BLK5L TYPE(HALF) OFFSET(BLK5O)
FLD: BLK5T TYPE(HALF)
***********************************************************************
* *
* ENVIRONMENT BLOCK TYPE 1 *
* *
***********************************************************************
***********************************************************************
**** SM2ENVDS DSECT
***********************************************************************
COMP: SM2ENVDS_OFFSET =
WHEN(SMHCTLTY <> X'02') ASSIGN(99999) /* IS NOT PRESENT */
WHEN(SM2BLKS >= 1 AND BLK1T = 1) ASSIGN(BLK1O)
WHEN(SM2BLKS >= 2 AND BLK2T = 1) ASSIGN(BLK2O)
WHEN(SM2BLKS >= 3 AND BLK3T = 1) ASSIGN(BLK3O)
WHEN(SM2BLKS >= 4 AND BLK4T = 1) ASSIGN(BLK4O)
WHEN(SM2BLKS >= 5 AND BLK5T = 1) ASSIGN(BLK5O)
ELSE ASSIGN(99999)
FLD: SM2ENVDS DISP(0) LEN(1) OFFSET(SM2ENVDS_OFFSET)
FLD: SM2ELEN TYPE(HALF) DISP(0) /*LENGTH OF THE BLOCK*/
FLD: SM2ETYP TYPE(HALF) DISP(2) /*TYPE OF BLOCK*/
FLD: SM2EVER TYPE(HALF) DISP(4) /*VERSION OF BLOCK (SM2BV1/V2)*/
FLD: SM2EFLG1 LEN(1) DISP(6) /*FLAG 1 FOR BLOCK*/
FLD: SM2EFLG2 LEN(1) DISP(7) /*FLAG 2 FOR BLOCK*/
FLD: SM2SITE LEN(1) DISP(8) /*SITE CODE*/
FLD: SM2STGCD LEN(1) DISP(9) /*STAGE SELECTION CODE FROM C1DEFLTS*/
FLD: SM2STGID LEN(1) DISP(10) /*STAGE ID 1 OR 2*/
FLD: SM2SRCHR LEN(1) DISP(11) /*SRCHREPL UTILITY FLAG*/
COMP: SM2#ELEM = 'E' /*SRCHREPL PROCESSING AN ELEMENT*/
COMP: SM2#COMP = 'O' /*SRCHREPL PROCESSING OUTPT COMPONENT*/
FLD: SM2VER TYPE(HALF) DISP(12) /*VERSION OF THE ELEMENT*/
FLD: SM2LVL TYPE(HALF) DISP(14) /*LEVEL OF THE ELEMENT*/
FLD: SM2ENVM LEN(8) DISP(16) /*ENVIRONMENT NAME*/
FLD: SM2STAGE LEN(8) DISP(24) /*STAGE NAME*/
FLD: SM2SYSTM LEN(8) DISP(32) /*SYSTEM NAME*/
FLD: SM2SUBSY LEN(8) DISP(40) /*SUBSYSTEM NAME*/
FLD: SM2STYPE LEN(8) DISP(48) /*TYPE*/
FLD: SM2ELEMT LEN(10) DISP(56) /*ELEMENT NAME (VERSION 1)*/
FLD: SM2EAOFF LEN(2) TYPE(BIN) DISP(56)
/*V2: ELE AREA OFFSET FROM SM2ENVDS*/
FLD: SM2PRGRP LEN(8) DISP(58) /*V3: PROCESSOR GROUP*/
***********************************************************************
* *
* ASSOCIATED FILE INFORMATION IF ANY *
* *
***********************************************************************
FLD: SM2DSNAM LEN(44) DISP(66) /*ASSOC DATA SET NAME (VERSION 1)*/
FLD: SM2FAOFF LEN(2) TYPE(BIN) DISP(66)
/*V2: FILE AREA OFFSET FROM SM2ENVDS*/
FLD: SM2DSMEM LEN(10) DISP(110) /*ASSOC DATA SET MEMBER (VERSION 1)*/
FLD: SM2NAOFF LEN(2) TYPE(BIN) DISP(110)
/*V2: NAME AREA OFFSET FROM SM2ENVDS*/
***********************************************************************
* *
* LAST CHANGE BLOCK TYPE 2 *
* *
***********************************************************************
***********************************************************************
**** SM2LCGDS DSECT
***********************************************************************
COMP: SM2LCGDS_OFFSET =
WHEN(SMHCTLTY <> X'02') ASSIGN(99999) /* IS NOT PRESENT */
WHEN(SM2BLKS >= 1 AND BLK1T = 2) ASSIGN(BLK1O)
WHEN(SM2BLKS >= 2 AND BLK2T = 2) ASSIGN(BLK2O)
WHEN(SM2BLKS >= 3 AND BLK3T = 2) ASSIGN(BLK3O)
WHEN(SM2BLKS >= 4 AND BLK4T = 2) ASSIGN(BLK4O)
WHEN(SM2BLKS >= 5 AND BLK5T = 2) ASSIGN(BLK5O)
ELSE ASSIGN(99999)
FLD: SM2LCGDS DISP(0) LEN(1) OFFSET(SM2LCGDS_OFFSET)
FLD: SM2LLEN TYPE(HALF) DISP(0) /*LENGTH OF THE BLOCK*/
FLD: SM2LTYP TYPE(HALF) DISP(2) /*TYPE OF BLOCK*/
FLD: SM2LVER TYPE(HALF) DISP(4) /*VERSION OF BLOCK (SM2BV1)*/
FLD: SM2LFLG1 LEN(1) DISP(6) /*FLAG 1 FOR BLOCK*/
FLD: SM2LFLG2 LEN(1) DISP(7) /*FLAG 2 FOR BLOCK*/
FLD: SM2CCOM LEN(40) DISP(8) /*LAST CHANGE COMMENT*/
FLD: SM2MLDTE LEN(6) TYPE(YYMMDD) /*LAST CHANGE LVL DATE(YYMMDD)*/
FLD: SM2MLTME LEN(4) TYPE(HHMM) /*LAST CHANGE LVL TIME(HHHH)*/
FLD: SM2LUSID LEN(8) DISP(48) /*LAST LEVEL USERID*/
FLD: SM2MLACT LEN(8) DISP(56) /*LAST ACTION*/
FLD: SM2MLTOT LEN(4) TYPE(BIN) DISP(66) /*LAST LEVEL TOTAL*/
*SM2LDATA DS 0D
***********************************************************************
* *
* PROCESSOR INFO BLOCK TYPE 3 *
* *
***********************************************************************
***********************************************************************
**** SM2LPRDS DSECT
***********************************************************************
COMP: SM2LPRDS_OFFSET =
WHEN(SMHCTLTY <> X'02') ASSIGN(99999) /* IS NOT PRESENT */
WHEN(SM2BLKS >= 1 AND BLK1T = 3) ASSIGN(BLK1O)
WHEN(SM2BLKS >= 2 AND BLK2T = 3) ASSIGN(BLK2O)
WHEN(SM2BLKS >= 3 AND BLK3T = 3) ASSIGN(BLK3O)
WHEN(SM2BLKS >= 4 AND BLK4T = 3) ASSIGN(BLK4O)
WHEN(SM2BLKS >= 5 AND BLK5T = 3) ASSIGN(BLK5O)
ELSE ASSIGN(99999)
FLD: SM2LPRDS DISP(0) LEN(1) OFFSET(SM2LPRDS_OFFSET)
FLD: SM2PLEN TYPE(HALF) DISP(0) /*LENGTH OF THE BLOCK*/
FLD: SM2PTYP TYPE(HALF) DISP(2) /*TYPE OF BLOCK*/
FLD: SM2PVER TYPE(HALF) DISP(4) /*VERSION OF BLOCK (SM2BV1)*/
FLD: SM2PFLG1 LEN(1) DISP(6) /*FLAG 1 FOR BLOCK*/
FLD: SM2PFLG2 LEN(1) DISP(7) /*FLAG 2 FOR BLOCK*/
FLD: SM2LPRON LEN(10) DISP(8) /*PROCESSOR NAME*/
FLD: SM2LPROD LEN(6) DISP(18) /*GENERATE LAST DATE*/
FLD: SM2LPRC1 TYPE(HALF) DISP(24) /*GENERATE C1 RETURN CODE*/
FLD: SM2PDATA LEN(8) DISP(26)
***********************************************************************
* *
* REQUEST PARAMETER INFORMATION TYPE 4 *
* *
***********************************************************************
***********************************************************************
**** SM2REQDS DSECT
***********************************************************************
COMP: SM2REQDS_OFFSET =
WHEN(SMHCTLTY <> X'02') ASSIGN(99999) /* IS NOT PRESENT */
WHEN(SM2BLKS >= 1 AND BLK1T = 4) ASSIGN(BLK1O)
WHEN(SM2BLKS >= 2 AND BLK2T = 4) ASSIGN(BLK2O)
WHEN(SM2BLKS >= 3 AND BLK3T = 4) ASSIGN(BLK3O)
WHEN(SM2BLKS >= 4 AND BLK4T = 4) ASSIGN(BLK4O)
WHEN(SM2BLKS >= 5 AND BLK5T = 4) ASSIGN(BLK5O)
ELSE ASSIGN(99999)
FLD: SM2REQDS DISP(0) LEN(1) OFFSET(SM2REQDS_OFFSET)
FLD: SM2RLEN TYPE(HALF) DISP(0) /*LENGTH OF THE BLOCK*/
FLD: SM2RTYP TYPE(HALF) DISP(2) /*TYPE OF BLOCK*/
FLD: SM2RVER TYPE(HALF) DISP(4) /*VERSION OF BLOCK*/
FLD: SM2RFLG1 LEN(1) DISP(6) /*FLAG 1 FOR BLOCK*/
FLD: SM2RFLG2 LEN(1) DISP(7) /*FLAG 2 FOR BLOCK*/
FLD: SM2RCCID LEN(1) DISP(8) /*' CCID ASSOC W/ ACTION*/
FLD: SM2RCOMM LEN(4) DISP(9) /*' COMMENT ASSOC W/ ACTION*/
FLD: SM2RFLAG LEN(4) TYPE(BIN) DISP(13) /*ANY SPECIAL FLAGS*/
FLD: SM2RSISO LEN(1) DISP(17) /*' SIGNIN/SIGNOUT FORCE ( Y OR N)*/
FLD: SM2RSICO LEN(1) DISP(18) /*' SIGNIN/SIGNOUT COPY ONLY ( Y OR N)*/
FLD: SM2REXPN LEN(1) DISP(19) /*' EXPAND INCLUDES ( Y OR N)*/
FLD: SM2ROVER LEN(1) DISP(20) /*' WRITE OVER EXISTING RETR MBR*/
FLD: SM2RRTCD LEN(4) TYPE(BIN) DISP(21) /*ACTION RETURN CODE*/
FLD: SM2RDEL LEN(1) DISP(25) /*' DELETE REQUEST FLAG*/
* BLANK IF N/A
* Y - YES, DELETE WAS REQUESTED
* N - NO, DELETE WAS NOT REQUESTED
FLD: SM2RIGNF LEN(1) DISP(26) /*' IGNORE GENERATE FAILED (Y / N)*/
FLD: SM2RBGNP LEN(1) DISP(27) /*' BYPASS GENERATE PROCESSOR (Y / N)*/
FLD: SM2RBDLP LEN(1) DISP(28) /*' BYPASS DELETE PROCESSOR (Y / N)*/
FLD: SM2RSYNC LEN(1) DISP(29) /*' SYNC OPTION SPECIFIED (Y / N)*/
FLD: SM2RONCP LEN(1) DISP(30) /*' DELETE ONLY COMPONENTS (Y / N)*/
FLD: SM2RMVWH LEN(1) DISP(31) /*' MOVE/TRANSFER W/ HISTORY (Y / N)*/
FLD: SM2RAWUP LEN(1) DISP(32) /*' ADD W/ UPDATE OPTION (Y / N)*/
FLD: SM2RPGRP LEN(8) DISP(33) /*' PROCESSOUR GROUP OVERRIDE*/
FLD: SM2RSIUS LEN(8) DISP(41) /*' SIGNOUT TO USERID*/
FLD: SM2REMCH LEN(1) DISP(49) /*' VALIDATE ACT ELEMENT MASTER CHK*/
FLD: SM2RSYCH LEN(1) DISP(50) /*' VALIDATE ACT SYNCHRONIZATION CHK*/
FLD: SM2RCMCH LEN(1) DISP(51) /*' VALIDATE ACT COMP VALIDATION CHK*/
FLD: SM2RTMSG LEN(1) DISP(52) /*' VALIDATE ACT TERSE MESSAGES*/
FLD: SM2RAUTG LEN(1) DISP(53) /*' AUTOGEN OPT FOR ADD, UPD, AND GEN*/
FLD: SM2RAUTX LEN(1) DISP(54) /*' AUTOGEN ON BEHALF OF A COMPONENT*/
FLD: SM2RNSRC LEN(1) DISP(55) /*' ELEMENT SOURCE LESS FLAG*/
FLD: SM2RSPAN LEN(1) DISP(56) /*' AUTOGEN SPAN OPTION (N/A/S/B)*/
***********************************************************************
* *
* ENVIRONMENT BLOCK TYPE 1 -- TARGET *
* *
***********************************************************************
***********************************************************************
**** SM2ENVDS_T DSECT
***********************************************************************
COMP: SM2ENVDS_T_OFFSET =
WHEN(SMHCTLTY <> X'02') ASSIGN(99999) /* IS NOT PRESENT */
WHEN(SM2BLKS >= 5 AND BLK5T = 1 AND
BLK5O <> SM2ENVDS_OFFSET) ASSIGN(BLK5O)
WHEN(SM2BLKS >= 4 AND BLK4T = 1 AND
BLK4O <> SM2ENVDS_OFFSET) ASSIGN(BLK4O)
WHEN(SM2BLKS >= 3 AND BLK3T = 1 AND
BLK3O <> SM2ENVDS_OFFSET) ASSIGN(BLK3O)
WHEN(SM2BLKS >= 2 AND BLK2T = 1 AND
BLK2O <> SM2ENVDS_OFFSET) ASSIGN(BLK2O)
ELSE ASSIGN(99999)
FLD: SM2ENVDS_T DISP(0) LEN(1) OFFSET(SM2ENVDS_T_OFFSET)
FLD: SM2ELEN_T TYPE(HALF) DISP(0) /*LENGTH OF THE BLOCK*/
FLD: SM2ETYP_T TYPE(HALF) DISP(2) /*TYPE OF BLOCK*/
FLD: SM2EVER_T TYPE(HALF) DISP(4) /*VERSION OF BLOCK (SM2BV1/V2)*/
FLD: SM2EFLG1_T LEN(1) DISP(6) /*FLAG 1 FOR BLOCK*/
FLD: SM2EFLG2_T LEN(1) DISP(7) /*FLAG 2 FOR BLOCK*/
FLD: SM2SITE_T LEN(1) DISP(8) /*SITE CODE*/
FLD: SM2STGCD_T LEN(1) DISP(9) /*STAGE SELECTION CODE FROM C1DEFLTS*/
FLD: SM2STGID_T LEN(1) DISP(10) /*STAGE ID 1 OR 2*/
FLD: SM2SRCHR_T LEN(1) DISP(11) /*SRCHREPL UTILITY FLAG*/
FLD: SM2VER_T TYPE(HALF) DISP(12) /*VERSION OF THE ELEMENT*/
FLD: SM2LVL_T TYPE(HALF) DISP(14) /*LEVEL OF THE ELEMENT*/
FLD: SM2ENVM_T LEN(8) DISP(16) /*ENVIRONMENT NAME*/
FLD: SM2STAGE_T LEN(8) DISP(24) /*STAGE NAME*/
FLD: SM2SYSTM_T LEN(8) DISP(32) /*SYSTEM NAME*/
FLD: SM2SUBSY_T LEN(8) DISP(40) /*SUBSYSTEM NAME*/
FLD: SM2STYPE_T LEN(8) DISP(48) /*TYPE*/
FLD: SM2ELEMT_T LEN(10) DISP(56) /*ELEMENT NAME (VERSION 1)*/
FLD: SM2EAOFF_T LEN(2) TYPE(BIN) DISP(56)
/*V2: ELE AREA OFFSET FROM SM2ENVDS*/
FLD: SM2PRGRP_T LEN(8) DISP(58) /*V3: PROCESSOR GROUP*/
***********************************************************************
* *
* ASSOCIATED FILE INFORMATION IF ANY - TARGET *
* *
***********************************************************************
FLD: SM2DSNAM_T LEN(44) DISP(66) /*ASSOC DATA SET NAME (VERSION 1)*/
FLD: SM2FAOFF_T LEN(2) TYPE(BIN) DISP(66)
/*V2: FILE AREA OFFSET FROM SM2ENVDS*/
FLD: SM2DSMEM_T LEN(10) DISP(110) /*ASSOC DATA SET MEMBER (VERSION 1)*/
FLD: SM2NAOFF_T LEN(2) TYPE(BIN) DISP(110)
/*V2: NAME AREA OFFSET FROM SM2ENVDS*/
FLD: SMF230_END LEN(1) OFFSET(0) |
