SMF Record Mapping Information Tables and Usage Notes

This section describes the record type information tables that assist you in using the mapping facility. Each table shows the decimal value, hex value, description, source layout member name and any special XREF to use for viewing each SMF record type as follows:

• MVS Offline SMF Records Mapping —  Offline SMF Record Mapping. MVS SMF Records
• MVS Online SMF Records Mapping —  Online SMF Record Mapping. MVS SMF Records.

The SMF Record Mapping facility automates the presentation of the source layout for each record type. However, some records are very complex and require interaction to complete the formatting of all data bytes. The tables provide a page reference for these manual interaction record types that direct you to the additional description.

Offline SMF Records Mapping

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. In order 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. In order 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 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

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. In order 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 30 (1E) - Common Address Space

Two 01 levels are provided for type 30:

The SMF_TYPE_30 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. The base layout includes all accounting data; however, if you need to break down the accounting section into individual fields, you can use the SMF30_ACCOUNTING_CONTD layout.

One of the possible sections of information that may be present in a type 30 record is a variable number of variable length accounting fields. The field name used to describe all accounting fields in the accounting section is:

If any accounting data is present in the type 30 record, the base field SMF30ALN_LTH_ACCT_SECT is greater than zero (0). When SMF30ALN_LTH_ACCT_SECT is greater than zero (0), you may use the following optional procedure for mapping individual variable length accounting fields:

1. Examine base field SMF30AOF_LOC_ACCT_SECT to determine the location of where to “base” the “ACCOUNTING_CONTD” layout.
2. Examine base field SMF30AON_NO_ACCT_SECTS to determine the number of accounting fields in the accounting data section.
3. Issue the command USE nnn SMF30_ACCOUNTING_CONTD, where:
   • For offline data: nnn = (SMF30AOF_LOC_ACCT_SECT + 1)
   • For online data: nnn = (SMF30AOF_LOC_ACCT_SECT + 5)
4. If the field SMF30AON_NO_ACCT_SECTS was greater than 1, issue the command, USE NEXT *, for each additional accounting field to be mapped.

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

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