SMF record mapping information tables and usage notes

Offline SMF Records Mapping

Offline SMF record mapping—MVS SMF records

Online SMF Records Mapping

Online SMF record mapping—MVS SMF records

Record Type 4 (04) - Step Termination

Five 01 levels (see List of Available Layouts - USE Command - SMF004 Member) are provided for type 04:

The SMF_TYPE_4 layout defines the base portion of the record and is automatically selected by the SLxALL master XREF. To view any additional data sections for a type 04 SMF record, manual interaction is required. The procedure for viewing additional data sections is:

1. Scroll <DOWN> to see the last fields of the base layout, see USE Command for Mapping Type 04 RELOCATE_SECTION. Examine base field number 32 (SMF4LENN_DVC_ENTRY_LENGTH) to determine the number of “NON_SPOOL” sections present.
2. If SMF4LENN_DVC_ENTRY_LENGTH is 0, skip to step 4 to map accounting sections or step 5 to map the relocate section.
3. If SMF4LENN_DVC_ENTRY_LENGTH is greater than 0 do the following:
   1. Calculate the number of “NON_SPOOL” entries (E) using the formula:
      E = (SMF4LENN_DVC_ENTRY_LENGTH - 2) / 8.

   2. Issue the command “USE NEXT SMF4_NON_SPOOL_DEVICE_ENTRY” “E” times, until all non-spool device entries have been mapped.

      Important

      An information line is displayed indicating that additional record data remains to be mapped similar to the following:

      **** BOTTOM OF LAYOUT - DATA EXCEEDS LAYOUT BY 107 BYTES ********

      Important

      If the number of entries (E) is greater than 1, the following command can be used for additional non-spool entries:

      USE NEXT *
4. After mapping all NON_SPOOL sections (if any), the ACCOUNTING_SECTION(s) may be mapped by using the following procedure:
   1. Issue the command “USE NEXT SMF4_ACCOUNTING_SECTION”. This maps the accounting information fields and the first “ACCOUNTING_FIELD” section.
   2. Examine the field SMF4NAF_NO_ACCT_FIELDS to determine if any additional “ACCOUNTING_FIELD” sections are present.
   3. If SMF4NAF_NO_ACCT_FIELDS is 0 or 1, no more accounting sections are present and you may skip to step 5 to map the relocate section.
   4. If SMF4NAF_NO_ACCT_FIELDS is greater than 1 do the following:1. 
      1. Issue the command “USE NEXT SMF4_ACCOUNTING_SECTION_CONTD” as many times as needed (SMF4NAF_NO_ACCT_FIELDS minus 1 times) until all accounting fields have been mapped.

5. To map the “RELOCATE_SECTION”, examine the base section field number 31 (SMF4RLCT_OFFSET_TO_RELOC) to determine the location of where to “base” the “RELOCATE_SECTION” layout. (see USE Command for Mapping Type 04 RELOCATE_SECTION)

   Note

   The command “USE 1 SMF_TYPE_4” may be issued to re-map the base portion of the type 04 record containing the SMF4RLCT_OFFSET_TO_RELOC field.

6. Issue the command USE nnn SMF4_RELOCATE_SECTION, where:
   • For offline data:
     nnn = (SMF4RLCT_OFFSET_TO_RELOC + 1)

   • For online data:
     nnn = (SMF4RLCT_OFFSET_TO_RELOC + 5)

     See USE Command for Mapping Type 04 RELOCATE_SECTION. The result of mapping the RELOCATE SECTION is shown in Type 04 - Formatted Display of RELOCATE_SECTION.

USE Command for Mapping Type 04 RELOCATE_SECTION

Type 04 - Formatted Display of RELOCATE_SECTION

Record Type 5 (05) - Job Termination

Three 01 levels are provided for type 05:

The SMF_TYPE_5 layout defines the base portion of the record and is automatically selected by the SLxALL master XREF. The base includes the first accounting section. In order to view any additional accounting sections or the relocate section for a type 05 SMF record, manual interaction is required. The procedure for viewing additional data sections is:

1. Scroll <DOWN> to see the last fields of the base layout. See Formatted Display of Selected Type 05 Record Base Section. Examine base field number 35 (SMF5ACTF_NO_ACCT_FIELDS) to determine if any “accounting” sections are present. Type 05 records have a base section followed by 0 or more accounting sections followed by a relocate section. There is no field in the record that contains the offset of the relocate section, so in order to map the relocate section, you must first map all accounting sections and then the relocate section. Since the base layout (SMF_TYPE_5) maps the first accounting field, there are three variations of type 5 records possible: 0, 1, or greater than 1 accounting fields.
2. If SMF5ACTF_NO_ACCT_FIELDS is equal to 0, no accounting sections are present. The remaining data is the relocate section. To map the relocate section when SMF5ACTF_NO_ACCT_FIELDS is equal to 0, do the following:
   1. Issue the command “USE nnn SMF5_RELOCATE_SECTION”, where:
      • For offline data: nnn = 118
      • For online data: nnn = 122
3. If SMF5ACTF_NO_ACCT_FIELDS is equal to 1, the accounting data is already shown; to see the relocate section do the following:
   1. Issue the command USE NEXT SMF5_RELOCATE_SECTION.
4. If SMF5ACTF_NO_ACCT_FIELDS is greater than 1 do the following:
   1. Issue the command USE NEXT SMF5_ACCOUNTING_SECTION_CONTD as many times as needed (SMF5ACTF_NO_ACCT_FIELDS minus 1 times) until all accounting fields have been mapped.
   2. Issue the command USE NEXT SMF5_RELOCATE_SECTION to map the relocate section.

Formatted Display of Selected Type 05 Record Base Section

Record Type 6 (06) - JES2, PSF, EW, JES3

There are many possible variations and sub-segment combinations that may be written to SMF for the type 06 record. You may use a special XREF to automatically present the correct layout as follows:

• Offline type 06 records: SLF006
• Online type 06 records: SLN006

The XREF contains all the logic required to select the proper layout for any type 6 record being examined.

Be sure to use the appropriate existing supplied selection criteria member to select only type 6 records when using the SLF006 or SLN006 XREFs as illustrated in Browse Screen for Selecting and Mapping SMF Type 6 (Online Data).

Set your Selection criteria usage to E (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline type 06 records: SCF006
• Select online type 06 records: SCN006

Browse Screen for Selecting and Mapping SMF Type 6 (Online Data)

Record Type 14 (0E) - Input, Rdback Dataset

There are several possible variations and sub-segment combinations that may be written to SMF for the type 14 record. You may use a special XREF to automatically present the correct layout as follows:

• Offline type 14 and 15 records: SLF014
• Online type 14 and 15 records: SLN014

The XREF contains all the logic required to select the proper layout for any type 14 or 15 record being examined.

Be sure to use the appropriate existing supplied selection criteria member to select only type 14 and/or type 15 records when using the SLF014 or SLN014 XREFs.

Set your Selection criteria usage to E (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline type 14 or 15 records: SCF01415
• Select online type 14 or 15 records: SCN01415

Type 14 records contain a JFCB (Job File Control Block) section. The 176 byte JFCB is fully defined with field names.

Record Type 15 (0F) - Output Dataset

There are several possible variations and sub-segment combinations that you can write to SMF for the type 15 record. You may use a special XREF to automatically present the correct layout as follows:

• Offline type 14 or 15 records: SLF015
• Online type 14 or 15 records: SLN015

The XREF contains all the logic required to select the proper layout for any type 14 or 15 record being examined.

Be sure to use the appropriate existing supplied selection criteria member to select only type 14 or type 15 records when using the SLF014 or SLN014 XREFs.

Set your “Selection criteria usage” to “E” (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline type 14 or 15 records: SCF01415
• Select online type 14 or 15 records: SCN01415

Record Type 20 (14) - Job Initiation

Three 01 levels are provided for type 20:

The SMF_TYPE_20 layout defines the base portion of the record and is automatically selected by the SLxALL master XREF. The base includes the first accounting section. In order to view any additional accounting sections or the relocate section for a type 20 SMF record, manual interaction is required. The procedure for viewing additional data sections is:

1. Scroll <DOWN> to see the last fields of the base layout. Examine base field SMF20NAF_NO_ACCT_FIELDS to determine if any “accounting” sections are present. Type 20 records have a base section following by 0 or more accounting sections followed by a relocate section. Field number 10 (SMF20RLO_OFFSET_TO_RELOC) describes the location of the relocate section so mapping additional accounting sections is always an option. Since the base layout (SMF_TYPE_20) maps the first accounting field, additional accounting fields may be present only when SMF20NAF_NO_ACCT_FIELDS is greater than 1. In this case, to see the additional accounting fields,
2. Issue the command USE NEXT SMF20_ACCOUNTING_CONTD as many times as needed (SMF20NAF_NO_ACCT_FIELDS minus 1 times) until all accounting fields have been mapped.

3. To map the RELOCATE_SECTION, examine the base section field SMF20RLO_OFFSET_TO_RELOC to determine the location of where to “base” the “RELOCATE_SECTION” layout.

   Important

   The command USE 1 SMF_TYPE_20 may be issued to re-map the base portion of the type 20 record containing the SMF20RLO_OFFSET_TO_RELOC field.

4. Issue the command USE nnn SMF20_RELOCATE_SECTION, where:
   • For offline data: 
     nnn = (SMF20RLO_OFFSET_TO_RELOC + 1)

• • For online data: 
    nnn = (SMF20RLO_OFFSET_TO_RELOC + 5)

Record Type 22 (16) - Configuration

Record type 22 consists of a base section followed by several possible occurrences of different configuration data sections. When viewing a type 22 record with the master XREF (SLFALL or SLNALL), and not all data sections are correctly mapped, you may use a special XREF for mapping the type 22 record as follows:

• Offline type 22 records: SLF022
• Online type 22 records: SLN022

The XREF contains all the logic required to select the proper layout for each “trailer” data segment possible for a type 22 record. The formatter primary command NEXT is used to move from segment to segment and to invoke the XREF’s layout selection process.

Be sure to use the appropriate existing supplied selection criteria member to select only type 22 records when using the SLF022 or SLN022 XREFs.

Set your Selection criteria usage to E (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline type 22 records: SCF022
• Select online type 22 records: SCN022

When using the XREF SLx022, the base section of the type 22 record is presented first. To see any additional data segments, issue the NEXT primary command. The NEXT command invokes the XREF logic which determines which layout to select based on the value of the segment identification fields. Each segment has an identification byte in the second byte of the segment. The logic in the SLx022 XREF is designed to examine this byte and to select the appropriate layout for the type of segment found in the data.

To view additional segments, keep issuing the NEXT command until all segments have been mapped. The command “USE 1 SMF_TYPE_22” can be issued to return to the base segment of the record.

The command &NEXT can be used instead of NEXT when mapping type 22 records. Per ISPF conventions, when File-AID finds an ampersand (&) preceding any command, it leaves the command on the COMMAND line instead of clearing the COMMAND field. Using the &NEXT command means you only have to press Enter to map the next segment.

The “01 level” layouts provided in the SMF022 and SMN022 members are as follows:

SMF022 Map - Segments Displayed with NEXT Command

Record Type 23 (17) – SMF Status

To view multiple occurrences of the Logstream statistics section, use the USE command with the NEXT command. You can use these commands to navigate through additional segments. Follow these steps to view all Logstream statistics segments:

1. Locate the field SMF23LOF_LOC_LOGS_SECT in the header section of the layout. Use the LOCATE command:
   L SMF23LOF_LOC_LOGS_SECT
   Subtract 3 from the offset number of this section and enter the following command:
   USE xxxhere, xxx is the value obtained by subtracting 3 from SMF23LOF_LOC_LOGS_SECT.
2. A layout list appears. Select SMF23_LOG_STREAM_STATISTICS.
3. The first occurrence of the Logstream statistics section is displayed.
4. To view additional data segments, enter the following command:
   USE NEXT *
   This invokes the XREF logic to determine the next segment. To keep the command on the command line, add an ampersand (&) before the command. For example:
   &USE NEXT *
   This allows you to press Enter to view the next segment without re-entering the command. To go back to previous segments, enter the following command:
   &USE PREV *
   This navigates to previous segments after passing the first segment.

Record Type 30 (1E) - Common Address Space

SMF record type 30 provides comprehensive accounting information, consolidating data from record types 4, 5, 20, 34, 35, and 40. This consolidation simplifies accounting through installation-written post processing routines and includes additional information. Use record type 30 because the types it replaces are no longer updated with new measurement data.

Starting with IBM z/OS 2.5, the layout of SMF record type 30 varies across four sections based on their version number. Use layout SMF030 or SMN030 with XREF (SLF030, SLN030, SLFALL, or SLNALL) to select the correct layout.

In the Header or self-defining section, based on the SMF30SOF field, the number of fields varies between SMF30USN and SMF30CNN. The SMF30SOF field determines the version of this section based on its following value:

• Value 192 (X’C0’): Version 1
• Value 219 (X’DB’): Version 2
• Value 228 (X’E4’): Version 3.

In the Identification section, based on the SMF30ILN field, the number of fields varies between SMF30COR and SMF30DEADLINE. The SMF30ILN field determines the version of this section based on its following value:

• Value 250 (X'FA'): Version 1
• Value 278 (X'116'): Version 2.

In the Processor accounting section, based on the SMF30CLN field, the number of fields varies between SMF30CAS_OA54589 and SMF30_DEPENC_Time_Java_On_CP. The SMF30CLN field determines the version of this section based on its following value:

• Value 192 (X’C0’): Version 1
• Value 216 (X’D8’): Version 2.

In the Storage and Paging section, based on the SMF30RLN field, the number of fields varies between SMF30HSH and SMF30_HWMHVReal1M. The SMF30RLN field determines the version of this section based on its following value:

• Value 232 (X’E8’): Version 1
• Value 244 (X’F4’): Version 2
• Value 256 (X’100’): Version 3
• Value 472 (X’1D8’): Version 4.

The layout is automatically selected by the SLxALL master XREF. The SMF type 30 layout defines the entire type 30 record and all occurrences of all sub-sections.

Record Type 33 (21) - APPC/MVS TP Accounting

Record type 33 has two different formats. Each format is identified by a “subtype” value.

The master XREF (SLFALL or SLNALL) provides the logic to fully map the base section (SMF_TYPE_33_SUB_x) of each known subtype. Type 33, subtype 1, records contain a variable number of relocatable self-defining information sections. To view any additional data sections for a type 33 subtype 1 record, you must intervene manually.

A separate copybook is provided for each relocatable data section in subtype 1. To map any occurrence or format of a relocatable segment of a type 33 subtype 1’s record, issue the USE command, see Type 33 Copybooks for Subtype 1 Data Sections for a list of valid Copybook Names.:

USE nnn SMF33_1_xxx (nnn = section offset +1 (offline)
                     xxx = section name)
or

USE nnn             (no Copybook name to see Layouts Table)

Relocatable section offsets are usually contained in the subtype base header fields.

Type 33 Copybooks for Subtype 1 Data Sections

Record Type 34 (22) - TS-Step Termination

The type 34 record is very similar to the type 4 (step termination) SMF record. (See Record Type 4 (04) - Step Termination .)

Five 01 levels are provided for type 34:

The SMF_TYPE_34 layout defines the base portion of the record and is automatically selected by the SLxALL master XREF. In order to view any additional data sections for a type 34 SMF record, manual interaction is required. The procedure for viewing additional data sections is:

1. Scroll <DOWN> to see the last fields of the base layout. Examine base field number 32 (TIVVAR_LTH_EXCP_FLDS) to determine if any “NON_SPOOL” sections are present.
2. If TIVVAR_LTH_EXCP_FLDS is 0, skip to step 4 to map accounting sections or step 5 to map the relocate section.
3. If TIVVAR_LTH_EXCP_FLDS is greater than 0 do the following:
   1. Calculate the number of “NON_SPOOL” entries (E) using the formula:
      E = (TIVVAR_LTH_EXCP_FLDS - 2) / 8.

   2. Issue the command “USE NEXT SMF34_NON_SPOOL_DVC_SECTION” “E” times, until all non-spool device entries have been mapped.

      Important

      An information line is displayed indicating that additional record data remains to be mapped similar to the following:

      ******** BOTTOM OF LAYOUT - DATA EXCEEDS LAYOUT BY 107 BYTES ********

      Important

      If the number of entries (E) is greater than 1, the following command can be used for additional non-spool entries:

      USE NEXT *
4. After mapping all NON_SPOOL sections (if any), the ACCOUNTING_SECTION(s) may be mapped by using the following procedure:
   1. Issue the command USE NEXT SMF34_ACCNTING_SECTION. This maps the accounting information fields and the first “ACCOUNTING_FIELD” section.
   2. Examine the field TIVNBRAC_NO_ACCT_FIELDS to determine if any additional “ACCOUNTING_FIELD” sections are present.
   3. If TIVNBRAC_NO_ACCT_FIELDS is 0 or 1, no more accounting sections are present and you may skip to step 5 to map the relocate section.
   4. If TIVNBRAC_NO_ACCT_FIELDS is greater than 1 do the following:
      1. Issue the command USE NEXT SMF34_ACCNTING_CONTD as many times as needed (TIVNBRAC_NO_ACCT_FIELDS minus 1 times) until all accounting fields have been mapped.

5. To map the “RELOCATE_SECTION”, examine the base section field number 31 (TIVRLCT_OFSET_RELOCT_SECT) to determine the location of where to “base” the “RELOCATE_SECTION” layout.

   Important

   The command USE 1 SMF_TYPE_34 may be issued to re-map the base portion of the type 34 record containing the TIVRLCT_OFSET_RELOCT_SECT field.

6. Issue the command USE nnn SMF34_RELOCATE_SECTION, where:
   • For offline data: nnn = (TIVRLCT_OFSET_RELOCT_SECT + 1)
   • For online data: nnn = (TIVRLCT_OFSET_RELOCT_SECT + 5)

Record Type 35 (23) - Logoff

The type 35 record is very similar to the type 5 (job termination) SMF record. (See Record Type 5 (05) - Job Termination .)

Three 01 levels are provided for type 35:

The SMF_TYPE_35 layout defines the base portion of the record and is automatically selected by the SLxALL master XREF. In order to view any additional data sections for a type 35 SMF record, you must use manual interaction. The procedure for viewing additional data sections is:

1. Scroll <DOWN> to see the last fields of the base layout. Examine base field number 32 (TLGNBRAC_NO_ACCT_FLDS) to determine if any “accounting” sections are present. Type 35 records have a base section followed by 0 or more accounting sections followed by a relocate section. There is no field in the record that contains the offset of the relocate section, so in order to map the relocate section, all accounting sections must be mapped first, then the relocate section is next. Since the base layout (SMF_TYPE_35) maps the first accounting field, there are three variations of type 35 records possible: 0, 1, or greater than 1 accounting fields.
2. If TLGNBRAC_NO_ACCT_FLDS is equal to 0, no accounting sections are present. The remaining data is the relocate section. To map the relocate section when TLGNBRAC_NO_ACCT_FLDS is equal to 0, do the following:
   1. Issue the command USE nnn SMF35_RELOCATE_SECTION, where:
      • For offline data: nnn = 118
      • For online data: nnn = 122
3. If TLGNBRAC_NO_ACCT_FLDS is equal to 1 the accounting data is already shown, to see the relocate section do the following:
   1. Issue the command USE NEXT SMF35_RELOCATE_SECTION.
4. If TLGNBRAC_NO_ACCT_FLDS is greater than 1 do the following:
   1. Issue the command USE NEXT SMF35_ACCNTING_CONTD as many times as needed (TLGNBRAC_NO_ACCT_FLDS minus 1 times) until all accounting fields have been mapped.
   2. Issue the command USE NEXT SMF35_RELOCATE_SECTION to map the relocate section.

Record Type 60 (3C) - VVDS Updated

Record type 60 consists of a base section followed by several possible occurrences of different VVDS record data sections. When viewing a type 60 record with the master XREF (SLFALL or SLNALL), only the base portion of the record is mapped. The formatter primary command NEXT may be issued to reveal the first section of the VVDS record. Any subsequent VVDS record segments must be manually mapped via the USE NEXT command.

To automate the mapping of VVDS record segments, you may use a special XREF for mapping the type 60 record as follows:

• Offline VSAM related record types 36, and 60 through 69: SLFVSAM
• Online VSAM related record types 36, and 60 through 69: SLNVSAM

The XREF contains all the logic required to select the proper layout for each “trailer” data segment possible for a type 60 record. The formatter primary command NEXT is used to move from segment to segment and to invoke the XREF’s layout selection process.

Be sure to use the appropriate existing supplied selection criteria member to select only type 36, and 60 thru 69 records when using the SLFVSAM or SLNVSAM XREFs.

Set your “Selection criteria usage” to “E” (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline VSAM type records: SCFVSAM
• Select online VSAM type records: SCNVSAM

When using the XREF SLxVSAM, the base section of the type 60 record is presented first. To see any additional data segments, issue the primary command NEXT. The NEXT command invokes the XREF logic which determines which layout to select based on the value of the segment identification fields. Each segment has an identification byte in the second or fourth byte of the segment. The logic in the SLxVSAM XREF is designed to examine this byte and to select the appropriate layout for the type of segment found in the data.

To view additional segments, keep issuing the NEXT command until all segments have been mapped. To return to the base segment of the record, issue the USE 1 SMF_TYPE_60 command.

Use the command &NEXT instead of NEXT when mapping type 60 records. Per ISPF conventions, when File-AID finds an ampersand (&) preceding any command, it leaves the command on the COMMAND line instead of clearing the COMMAND field. If you use the &NEXT command, you only have to press Enter to map the next segment.

The source for the type 60 record base is kept in member SMF060 and SMN060. The source for the VVDS record information cells is maintained in member SMFVVDS.

The 01 level Copybook layouts accessible in the SLFVSAM and SLNVSAM XREFs are as follows:

SLFVSAM - Available Layouts for Catalog Record Mapping

The procedure is:

1. Add the value of VOLREC_LTH field to location of VOLREC_LTH field. (See Manual NEXT Segment Mapping for XX_GENERIC Catalog Cell).
2. Issue the command: USE nnn *.
   Where nnn is the result of step 1 calculation.
3. Examine the first byte of VOLREC_DATA to see segment type code. (See USE Command to Access Available Layouts for Catalog Cells).
4. Issue the USE command to view AVAILABLE LAYOUTS. Then select the Copybook that matches the hex value of the segment type code. (See Selecting a Copybook from the Layouts List).
5. The correct segment layout should now be displayed. Continue issuing the NEXT command for automatic layout selection. See Segment Type X’01’ Mapped (VSAM_VOLREC_01_OWNERSHIP_CELL).

Manual NEXT Segment Mapping for XX_GENERIC Catalog Cell

USE Command to Access Available Layouts for Catalog Cells

Selecting a Copybook from the Layouts List

Segment Type X’01’ Mapped (VSAM_VOLREC_01_OWNERSHIP_CELL)

Record Type 61 (3D) - ICF Define Activity

Record type 61 is constructed just like a type 60 record. It consists of a base section followed by several possible occurrences of different VVDS record data sections. When viewing a type 61 record with the master XREF (SLFALL or SLNALL), only the base portion of the record is mapped. You can issue the formatter primary command NEXT to reveal the first section of the VVDS record. You must use the USE NEXT command to manually map any subsequent VVDS record segments.

To automate the mapping of VVDS record segments, you may use a special XREF for mapping the type 61 record as follows:

• 
  
  • Offline VSAM related record types 36, and 60 through 69: SLFVSAM
  • Online VSAM related record types 36, and 60 through 69: SLNVSAM

See Record Type 60 (3C) - VVDS Updated  for detailed mapping instructions.

Record Type 63 (3F) - VSAM Catalog Define

Record type 63 is constructed just like a type 60 record. It consists of a base section followed by several possible occurrences of different VVDS record data sections. When viewing a type 63 record with the master XREF (SLFALL or SLNALL), only the base portion of the record is mapped. The formatter primary command NEXT may be issued to reveal the first section of the VVDS record. Any subsequent VVDS record segments must be manually mapped via the USE NEXT command.

To automate the mapping of VVDS record segments, you may use a special XREF for mapping the type 63 record as follows:

• 
  
  • Offline VSAM related record types 36, and 60 through 69: SLFVSAM
  • Online VSAM related record types 36, and 60 through 69: SLNVSAM

Record Type 64 (40) - VSAM Component Status

Two 01 levels are provided for type 64:

The SMF_TYPE_64 layout defines the entire type 64 record and all occurrences of all sub-sections. It is automatically selected by the SLxALL master XREF. You may also use the SLxVSAM XREF for type 64 mapping.

One of the possible sections of information that may be present in a type 64 record is a variable number of fixed length extent information fields. In the SMF_TYPE_64 layout, all extent information is treated as one large variable length character string in a field named:

If any extent data is present in the type 64 record, the base field SMF64ESL_LTH is greater than zero (0). The optional procedure for mapping individual extent data section fields is:

1. Examine the offset of field SMF64_ALL_EXT_ENTRS_DATA to determine the location of where to “base” the first “EXTENT_ENTRY_DATA” layout. (To view field offset, use SHOW OFFSET and OFFSET COLUMN commands to tailor the formatted display.)
2. Calculate the number of “EXTENT” entries (E) using the formula:
   E = (SMF64ESL_LTH) / 26.
3. Issue the command USE nnn SMF64_EACH_EXTENT_ENTRY_DATA, where
   nnn = Offset of field SMF64_ALL_EXT_ENTRS_DATA (see step 1)
4. If the number of entries (E) is greater than 1 issue the following command for each additional extent entry to be mapped:
   USE NEXT *

Record Type 65 (41) - ICF Delete Activity

Record type 65 is constructed just like a type 60 record. It consists of a base section followed by several possible occurrences of different VVDS record data sections. When viewing a type 65 record with the master XREF (SLFALL or SLNALL), only the base portion of the record is mapped. You may issue the format primary command NEXT to reveal the first section of the VVDS record. You must use the USE NEXT command to manually map any subsequent VVDS record segments.

To automate the mapping of VVDS record segments, use a special XREF for mapping the type 65 record as follows:

• 
  
  • Offline VSAM related record types 36, and 60 through 69: SLFVSAM
  • Online VSAM related record types 36, and 60 through 69: SLNVSAM

Record Type 66 (42) - ICF Alter Activity

Record type 66 is constructed just like a type 60 record. It consists of a base section followed by several possible occurrences of different VVDS record data sections. When viewing a type 66 record with the master XREF (SLFALL or SLNALL), only the base portion of the record is mapped. You may issue the formatter primary command NEXT to reveal the first section of the VVDS record. Use the USE NEXT command to manually map any subsequent VVDS record segments.

To automate the mapping of VVDS record segments, you may use a special XREF for mapping the type 66 record as follows:

• 
  
  • Offline VSAM related record types 36, and 60 through 69: SLFVSAM
  • Online VSAM related record types 36, and 60 through 69: SLNVSAM

Record Type 82 (52) - Cryptographic

Record type 82 for CUSP (Cryptographic Unit Support Program) formats consists of a base section followed by several possible occurrences of different relocatable information sections.

A second format of type 82 record, the ICSF/MVS (Integrated Cryptographic Service Facility), is available with IBM z/OS SMF.

The master XREF (SLFALL or SLNALL) does not provide the logic to fully map all relocatable sections of the CUSP format of type 82 records. It also does not contain the logic required to select the proper ICSF/MVS subtype layout (there are seven possible variations or “subtypes” of ICSF/MVS format of type 82 records). To handle these needs you may use a special XREF for mapping the type 82 record as follows:

• 
  
  • Offline type 82 records: SLF082
  • Online type 82 records: SLN082

Be sure to use the appropriate existing supplied selection criteria member to select only type 82 records when using the SLF082 or SLN082 XREFs.

Set your “Selection criteria usage” to “E” (Existing) and specify one of the following member names in the selection criteria dataset member field:

• 
  
  • Select offline type 82 records: SCF082
  • Select online type 82 records: SCN082

The XREFs contain all the logic required to select the proper layout for the base of each CUSP or ICSF/MVS record.

For ICSF/MVS formatted subtypes, no other mapping is required. However, for CUSP formats, issue the primary command NEXT to see any additional relocatable data sections.

To view additional segments, keep issuing the NEXT command until all segments have been mapped. The command “USE 1 SMF_TYPE_82” can be issued to return to the base segment of the record.

The &NEXT command can be used instead of NEXT when mapping type 82 records. Per ISPF conventions, when File-AID finds an ampersand (&) preceding any command, it leaves the command on the COMMAND line instead of clearing the COMMAND field. Using the &NEXT command means you only have to press Enter to map the next segment.

Record Type 84 (54) - JES3 Monitoring

Record type 84 has nine different formats. Each format is identified by a “subtype” value.

The master XREF (SLFALL or SLNALL) does not provide the logic to fully map all relocatable sections of type 84 records. It also does not contain the logic required to select the proper type 84 subtype layout (there are nine possible variations or “subtypes” of type 84 records). To handle these needs, use a special XREF for mapping the type 84 record as follows:

• 
  
  • Offline type 84 records: SLF084
  • Online type 84 records: SLN084

Be sure to use the appropriate existing supplied selection criteria member to select only type 84 records when using the SLF084 or SLN084 XREFs.

Set your “Selection criteria usage” to “E” (Existing) and specify one of the following member names in the selection criteria dataset member field:

• 
  
  • Select offline type 84 records: SCF084
  • Select online type 84 records: SCN084

The XREFs contain all the logic required to select the proper layout for the base section (SMF_TYPE_84_SUBTYPE_x) of each known subtype. Some subtypes also contain a variable number of relocatable information sections. In order to view any additional data sections for a type 84 SMF record subtype, you must use manual interaction.

A separate copybook is provided for each relocatable data section in each subtype. To map any occurrence or format of a relocatable segment of a type 84 subtype’s record, issue the USE command: (See Type 84 Copybooks for Subtype Trailer Segments for a list of valid Copybook Names.)

USE nnn SMF84_SUBt_xxx (nnn = section offset
                          t = subtype
                        xxx = section name)
or

USE nnn                 (no Copybook name to see Layouts List)

Relocatable section offsets are usually contained in the subtype base header fields.

Type 84 Copybooks for Subtype Trailer Segments

Record Type 90 (5A) - System Status

Record type 90 has twenty-two (22) different formats. Each format is identified by a “subtype” value.

The master XREF (SLFALL or SLNALL) does not contain the logic required to select the proper type 90 subtype layout (there are 22 possible variations or “subtypes” of type 90 records). To handle this you may use a special XREF for mapping the type 90 record as follows:

• 
  
  • Offline type 90 records: SLF090
  • Online type 90 records: SLN090

Be sure to use the appropriate existing supplied selection criteria member to select only type 90 records when using the SLF090 or SLN090 XREFs.

Set your “Selection criteria usage” to “E” (Existing) and specify one of the following member names in the selection criteria dataset member field:

• 
  
  • Select offline type 90 records: SCF090
  • Select online type 90 records: SCN090

Be sure to use selection criteria to select only type 90 (X’5A’) records when using the SLF090 or SLN090 XREFs.

The XREFs contain all the logic required to select the proper layout for the base section (SMF_TYPE_90_SUBTYPE_x) of each known subtype.

Type 90 Copybooks for Subtype Variations

Record type 113 (71) - Hardware capacity, reporting and statistics

Record type 113 only consists of a header section, a self-defining section followed by a SUBTYPE 1 section.  

Set your Selection criteria usage to E (Existing) and specify one of the following member names in the selection criteria dataset member field:

• Select offline type 113 records and subtype 1: SCF113
• Select online type 113 records and subtype 1: SCN113

There are two offline layouts: SMF113S and SMF113L. Layout SMF113S is used when the user has a SHORT COUNTER DATA SECTION in their layout. Layout SMF113L is used when you have a LONG COUNTER DATA SECTION in your layout. There is also the online version of those two layouts (SMN113L and SMN113S). There are two layouts for offline and two for online, because it’s the only way to map the last field of the SUBTYPE 1 data, and that’s why there are instructions below to manually derive that data.

The following steps are required to determine which type of layout is needed:

1. Go to File-AID Browse and use a FORMATTED Browse Mode.
2. Enter your SMF offline or online file.
3. Enter your SMF113L layout if you are using offline data, otherwise use SMN113L.
4. Enter you SCF113 selection criteria if you are using offline data, otherwise use SCN113.
5. Scroll down until you find field SMF113_1_CDLN. If the number for this field is 4, you should use the short layout SMF113S (offline data) or SMN113S (online data). If the number for this field is 8, you should use the long layout SMF113L (offline data) or SMN113L (online data). Here is an example of a Counter set section. In this example the SMF113_1_CDLN number is 8, so use the long layout SMF113L (offline data) or SMN113L (online data) if this matches at your site. The following example is using offloaded records:
   SMF113_1_CSTYPE(1) UNALIGNED   195      6                  
   SMF113_1_FLAGS(1) UNALIGNED     197:0  1000000000000000   
   SMF113_1_CDOF(1) UNALIGNED      199     258                
   SMF113_1_CDLN(1) UNALIGNED      203     8          <------------
   SMF113_1_CDON(1)UNALIGNED      205    9
6. Once you have determined the layout you need, there will be some manual work to figure out the last field of the SUBTYPE 1 data, which is the Short counter SMF113_1_SCR or the Long counter SMF113_1_LCR field depending on the layout used.
7. Go to the SUBTYPE 1 field SMF113_1_CSON. This field tells you the how many Counter set sections you have. Each one of these Counter set sections have a field called SMF113_1_CDON. The number given for SMF113_1_CDON field tells how many of Short or Long counters are there. THESE SHORT OR LONG COUNTERS BELONG TO THE COUNTER SET SECTION BUT THE COUNTERS DO NOT IMMEDIATELY FOLLOW. For example, as noted above (this 12 byte counter section starting with SMF113_1_CSTYPE and ending with SMF113_1_CDON) has the number 9 displayed for SMF113_1_CDON. This means there are 9 Long Counter Data Sections (that belong to this Counter Set Sections), below that looks similar to this:
   SMF113_1_LCR(1)                            255 406404527875    
   SMF113_1_LCR(2) UNALIGNED       263 0                
   SMF113_1_LCR(3) UNALIGNED       271 0                
   SMF113_1_LCR(4) UNALIGNED       279 0                
   SMF113_1_LCR(5) UNALIGNED       287 180950855253     
   SMF113_1_LCR(6) UNALIGNED       295 0                
   SMF113_1_LCR(7) UNALIGNED       303 0                
   SMF113_1_LCR(8) UNALIGNED       311 0                
   SMF113_1_LCR(9) UNALIGNED       319 0
8. This is an example of the second set of Counter set sections that look similar to that of noted above:
   SMF113_1_CSTYPE(2) UNALIGNED   207     3                   
   SMF113_1_FLAGS(2) UNALIGNED     209:0  1000000000000000
   SMF113_1_CDOF(2) UNALIGNED      211     330               

Record type 119 (77) - Event and interval records for TCP/IP

Record type 119 consists of many subtypes. This section describes only the subtypes that have TCP/IP information.

• Subtype 2 – TCP connection termination record
  • Subtype-2 records are collected whenever a TCP connection is closed or stopped. These records are created only for connections that reached the established state. This record contains all applicable information about the connection such as elapsed time and bytes transferred.
  • The subtype-2 layout maps out a header and following sections:
    • TCP connection termination self-defining.
    • TCP connection termination.
    • TCP connection termination Telnet.
    • TCP connection termination AT-TLS. 
    • TCP connection termination ApplData. 
    • TCP connection termination IP filter.
• Subtype 4 – TCP/IP profile event record
  • This record provides profile information for the TCP/IP stack.
  • The subtype-4 layout maps out a header and the following sections:
    • TCP/IP profile record self-defining section
    • Profile information common section. SMF data has PICO eyecatcher.
    • Profile information data set name section. SMF data has PIDS eyecatcher.
    • Autolog procedure section. SMF data has ALPR eyecatcher.
    • IPv4 configuration section. SMF data has V4CF eyecatcher.
    • TCP/IP profile record IPv6 configuration section. SMF data has V6CF eyecatcher.
    • TCP/IP profile record TCP configuration section. SMF data has TCCF eyecatcher.
    • TCP/IP profile record UDP configuration section. SMF data has UDCF eyecatcher.
    • TCP/IP profile record Global configuration section. SMF data has GBCF eyecatcher.
    • TCP/IP profile record port section. SMF data has PORT eyecatcher.
    • TCP/IP profile record interface section. SMF data has INTF eyecatcher.
    • TCP/IP profile record IPv6 address section. SMF data has IPA6 eyecatcher.
    • TCP/IP profile record routing section. SMF data has ROUT eyecatcher.
    • TCP/IP profile record source IP section. SMF data has SRCI eyecatcher.
    • TCP/IP profile record management section. SMF data has MGMT eyecatcher.
    • TCP/IP profile record IPSec Common section. SMF data has IPSC eyecatcher.
    • TCP/IP profile record IPSec Rule section. SMF data has IPSR eyecatcher.
    • TCP/IP profile record network access section. SMF data has NETA eyecatcher.
    • TCP/IP profile record dynamic VIPA (DVIPA) address section. SMF data has DVCF eyecatcher.
    • TCP/IP profile record dynamic VIPA (DVIPA) routing section. SMF data has DVRT eyecatcher.
    • TCP/IP profile record Distributed dynamic VIPA (DVIPA) section. SMF data has DDVS eyecatcher.
    • TCP/IP profile record policy table for IPv6 default address selection section.
    • TCP/IP profile record SMC Permit Filter section. SMF data has FLTP eyecatcher.
    • TCP/IP profile record SMC Exclude Filter section. SMF data has FLTE eyecatcher.
• Subtype 5 – TCP/IP statistics record
  • Subtype-5 records are collected at user-specified intervals. These records provide data about IP, TCP, UDP, and ICMP activity in the reporting TCP stack during the previous interval, including TCP activity for Shared Memory Communications over Remote Direct Memory Access (SMC-R) and Shared Memory Communications - Direct Memory Access (SMC-D) processing. For interval values, you can obtain the cumulative value for each statistic report by adding the values from individual TCP/IP statistics interval records. Other fields provide the current value of a statistic and are not interval-based. If TCP/IP statistics recording is turned off dynamically or the TCP stack terminates, a final record is generated to report close-out statistics.
  • The subtype-5 layout maps out a header and the following sections:
    • TCP/IP statistics record self-defining section.
    • IP statistics.
    • TCP statistics.
    • UDP statistics. 
    • ICMP statistics.
    • IPv6 IP statistics.
    • IPv6 ICMP statistics.
    • Storage statistics 
• Subtype 8 – TCP/IP stack/stop record
  • Subtype-8 records are collected when a TCP/IP stack starts or stops processing. These records serve as bookmarks to describe all other SMF recording activities for the given TCP/IP stack.
  • The subtype-8 layout maps out a header and the following sections:
    • TCP/IP stack start/stop record self-defining section.
    • TCP/IP stack start/stop record section.

You can write many possible variations and sub segment combinations to SMF for record type 119. You can use a special XREF to automatically present the correct layout as follows:

• Offline type 119 records: SLF119
• Online type 119 records: SLN119

The XREF contains all the logic required to select the proper layout for any type-119 record being examined.

Be sure to use the appropriate existing supplied selection criteria member to select only type-119 records when using the SLF119 or SLN119 XREFs as illustrated in Browse Screen for Selecting and Mapping SMF Type 119 (Offline Data).

Set Selection criteria usage to E (Existing) and specify one of the following member names in the selection criteria dataset member field: —

• Select offline type 119 records: SCF119  or
  • SCF119S2—To select offline subtype-2 records.
  • SCF119S4—To select offline subtype-4 records.
  • SCF119S5—To select offline subtype-5 records.
  • SCF119S8—To select offline subtype-8 records.
• Select online type 119 records: SCN119  or
  • SCN119S2—To select online subtype-2 records.
  • SCFN19S4—To select online subtype-4 records.
  • SCFN19S5—To select online subtype-5 records.
  • SCFN19S8—To select online subtype-8 records.

Browse screen for selecting and mapping SMF type 119 subtype 2 (offline data)

 Record Type 170 (AA) - File-AID Audit

An optional facility within File-AID is the activation of SMF Auditing. The File-AID/MVS installer can activate the writing of SMF records for each File-AID access to a data set.

The File-AID installer can customize the level and quantity of information logged to SMF, and can even assign the SMF record type number to use. The default record type value 170 is distributed with File-AID. If the SMF audit facility is implemented and the SMF record mapping facility is used to view the File-AID SMF records, some tailoring may be necessary.

Record type 170 has several different formats. Each format is identified by a subtype value as follows:

Type 170 Copybooks for File-AID SMF Record Types

The master XREF (SLFALL or SLNALL) provides the logic to select the correct layout whenever a type 170 record is encountered.

If the SMF record type value chosen for File-AID SMF Audit records is NOT 170, the SLFALL and SLNALL XREFs must be updated to test for a value other than X’AA’. (See  Maintaining XREFs.)

FIELD_UPD_30 and COMP_UPD_40 records contain additional sections of data. This data is the before and/or after image of the accessed dataset’s fields or entire record. It may be possible to map the data record by referencing the record layout that describes the accessed dataset’s record(s) in the master XREF(s).

For complex multi-file audit record mapping, a separate XREF should be built that references the SMx170 layouts for the base and the data record layouts as segments.