SMF record type 79

SMF record type 79 must be used to record data gathered by a user data gathering routine. Figure 1 shows the layout of the record sections that are common to all Monitor II data gatherers, whether coded by a user or provided by RMF™. The figure illustrates the layout of these common sections by showing the expansion of the RMF mapping macro ERBSMF79.

The fields in the common sections fall into three categories. Each category is indicated by a letter in the figure that corresponds to the letters in the following text:

A: The fields that the RMF routines fill in before the data gathering routine is invoked.
B: The fields that the data gathering routine must fill in during its processing. (See "Relocate Blocks" later in this section.)
C: The fields that the RMF routines will fill in when the RECORD option is in effect. RMF completes these fields after the data gatherer returns control but before the record is written to the SMF data set. During a display session or a background session when NORECORD is in effect, these fields are not completed because the record is not actually written to the SMF data set.

Before invoking the data gatherer, RMF calculates the length of the storage buffer required for the record, as described later under "Relocate Blocks," obtains a buffer for the record, and fills in some of the common section fields. The address of the SMF record buffer is passed to the data gatherer. The data gatherer fills in some fields in the common section and all of the data section of the record.

Figure 1. ERBSMF79 Mapping Macro Expansion

   ********************  COMMON SMF HEADER  *****************************
       SMF79HDR   DSECT
    C  SMF79LEN   DS      BL2      RECORD LENGTH
       SMF79SEG   DS      BL2      SEGMENT DESCRIPTOR
    C  SMF79FLG   DS      BL1      HEADER FLAG BYTE
       SMF79RRF   EQU     X'80'    NEW SMF RECORD FORMAT IF=1
       SMF79SUT   EQU     X'40'    SUBTYPE UTILIZED IF=1
       SMF79ESA   EQU     X'08'    MVS/ESA IF=1
       SMF79VXA   EQU     X'04'    MVS/XA IF=1
       SMF79OS    EQU     X'02'    OPERATING SYSTEM IS OS/VS2
       SMF79BFY   EQU     X'01'    SYSTEM IS RUNNING IN PR/SM MODE
       SMF79PTN   DS      BL1      PR/SM PARTITION NUMBER
    C  SMF79RTY   DS      BL1      RECORD TYPE
       SMF79TME   DS      BL4      TOD RECORD WRITTEN
       SMF79DTE   DS      PL4      DATE RECORD WRITTEN
    C  SMF79SID   DS      CL4      SYSTEM ID FROM INSTALLATION
    C  SMF79SSI   DS      CL4      SUBSYSTEM ID (RMF)
    B  SMF79STY   DS      BL2      SUBTYPE
    A  SMF79TRN   DS      BL2      NUMBER OF TRIPLETS IN THIS RECORD
                  DS      BL2      RESERVED
    A  SMF79PRS   DS      BL4      OFFSET TO RMF PRODUCT SECTION
    A  SMF79PRL   DS      BL2      LENGTH OF RMF PRODUCT SECTION
    A  SMF79PRN   DS      BL2      NUMBER OF RMF PRODUCT SECTIONS
     **********************  INDIVIDUAL HEADER EXTENSION *******************
    A  SMF79MCS   DS      F -      OFFSET TO MONITOR II CONTROL SECTION
    A  SMF79MCL   DS      H -      LENGTH OF MONITOR II CONTROL SECTION
    A  SMF79MCN   DS      H -      NUMBER OF MONITOR II CONTROL SECTION
    B  SMF79ASS   DS      F -      OFFSET TO DATA SECTION
    B  SMF79ASL   DS      H -      LENGTH OF DATA SECTION
 B  A  SMF79ASN   DS      H -      NUMBER OF DATA SECTION
    A  SMF79DCS   DS      F -      OFFSET TO DATA CONTROL SECTION
    B  SMF79DCL   DS      H -      LENGTH OF DATA CONTROL SECTION
    B  SMF79DCN   DS      H -      NUMBER OF DATA CONTROL SECTION
       SMF79QSS   DS      F -      OFFSET IOQ GLOBAL SECTION
       SMF79QSL   DS      H -      LENGTH IOQ GLOBAL SECTION
       SMF79QSN   DS      H -      NUMBER IOQ GLOBAL SECTION

Figure 2. ERBSMF79 Mapping Macro Expansion (continued)

   **********************  COMMON SMF PRODUCT SECTION ********************
    SMF79PRO   DSECT
 C  SMF79MFV   DS      CL2      RMF VERSION NUMBER, WITH
    *                                    INTRODUCTION OF THE MVS
    *                                    SOFTWARE LEVEL, THE FORMAT
    *                                    CHANGES TO PACKED (VRLF),
 C  SMF79PRD   DS      CL8      PRODUCT NAME
    SMF79IST   DS      PL4      TOD MONITOR 1 INTERVAL START: OHHMMSSF
 C  SMF79DAT   DS      PL4      DATE MONITOR 1 INTERVAL START: 00YYDDDF
    SMF79INT   DS      PL4      DURATION OF MONITOR 1 INTERVAL: MMSSTTTF
    *          DS      BL2      RESERVED
 B  SMF79SAM   DS      BL4      NUMBER OF SAMPLES
    *          DS      BL2      RESERVED
    SMF79FLA   DS      BL2      FLAGS
    SMF79ISS   DS      X'40'    INVALID SAMPLES TO BE SKIPPED
    SMF79M3R   DS      X'20'    RECORD WAS WRITTEN BY RMF MONITOR III
    SMF79ISM   DS      X'10'    INTERVAL WAS UNDER SMF CONTROL
    *          DS      BL4      RESERVED
 B  SMF79CYC   DS      PL4      CYCLE IN PACKED DECIMAL 000TTTTF
 B  SMF79MVS   DS      CL8      MVS SOFTWARE LEVEL
 B  SMF79IML   DS      BL1      TYPE OF PROCESSOR COMPLEX ON WHICH DATA IS MEASURED
 B  SMF79PRF   DS      XL1      PROCESSOR FLAGS
 B  SMF79QES   EQU     X'80'    EQUIPPED WITH EXPANDED STORAGE
 B  SMF79CNE   EQU     X'40'    EQUIPPED WITH ESCON CHANNEL
 B  SMF79DRC   EQU     X'20'    ESCON DIRECTOR IN CONFIG.
 B  SMF79EME   EQU     X'10'    SYSTEM IS RUNNING IN Z/ARCHITECTURE
 B  SMF79PTN   DS      BLI      PR/SM PARTITION NUMBER
    SMF79SLR   DS      BL1      SMF RECORD LEVEL
    SMF79IET   DS      CL8      INTERVAL EXPIRATION TIME TOKEN
   **********************  MONITOR II CONTROL SECTION  *******************
    R79CHL     DSECT            COMMON RECORD 79 HEADER
 B  R79GTOD    DS      XL4 -    DATA GATHERER CALL TOD
 B  R79LF2     DS      XL1 -    FLAG BYTE
    R79PAR     EQU     X'80'    NOT ENOUGH RELOCATE SECTION TO
    *                           COMPLETE DATA GATHERING
    R79SG      EQU     X'40'    REPORT TO BE SORTED BY SG
    R79RV1     DS      XL1 -    RESERVED
 C  R79SES     DS      CL2 -    SESSION NAME
    R79RSV     DS      XL2 -    RESERVED
    R79USER    DS      XL2 -    USER FIELD
 C  R79RID     DS      CL8 -    MEASUREMENT NAME
 C  R79CTXTL   DS      XL2 -    LEN OF COMMAND TEXT
 C  R79CTEXT   DS      CL32 -   COMMAND TEXT
 C  R79DTXTL   DS      XL2 -    LEN OF DEFAULT DR TEXT
 C  R79DTEXT   DS      CL32 -   DEFAULT DR TEXT
 C  R79IST     DS      CL4 -    MON III INTERVAL START TIME :0HH MMSSF
   ********************** DATA  SECTION  *********************************
    R799LCU    DS      BL2      LOGICAL CONTROL UNIT NUMBER 0 TO 255
    R799SGN    DS      CL8      STORAGE GROUP NAME