Collecting SMP/E maintenance information

When SMP/E CSI data sets are accessible to the Inquisitor, it is possible to match scanned programs with certain aspects of their SMP/E maintenance level. The accuracy of this matching is highly dependent on configuration details.

Use one of the following scan request keywords to initiate the SMP/E maintenance data extraction process that best suits your configuration:

  • ALLCSISCAN - use all available SMP/E CSI data sets on the system to look for matching data. For CATALOG requests, these are found by searching the catalog for VSAM clusters with names matching the **.CSI search mask. For VTOC scan requests, CSI data sets are found when scanning volumes, so CSI data sets on excluded volumes will not be examined.
  • VOLCSISCAN - only use SMP/E configurations where the GLOBAL zone resides on the same DASD volume as the program library to look for matching data.
  • IPLCSISCAN - a subset of VOLCSISCAN where volume-level SMP/E data matching is only performed for IPL volumes. IPL volumes are those DASD volumes with a PDS program library named SYS1.NUCLEUS.
VOLCSISCAN and IPLCSISCAN have no effect on CATALOG requests.
The following SMP/E information may be extracted:
FMID
The function SYSMOD that owns the module.
RMID
The SYSMOD which provide the last complete module replacement.
PUT level
The name of the SOURCEID of the RMID which conforms to the format of PUTnnnn or similar if the RMID SYSMOD has such a SOURCEID.
RSU level
the name of the SOURCEID of the RMID which conforms to the format of RSUnnnn or similar if the RMIS SYSMOD has such a SOURCEID.

The Inquisitor calls the SMP/E API module GIMAPI to access and extract SMP/E information. Although the extracted information is from target zones, all API calls are made via the global zone, so the Inquisitor does not have access to target zone details such as its data set name, or the volume on which it resides. This also means that relevant SOURCEIDs assigned after the APPLY of the RMID SYSMOD will not be collected.

For SMP/E data to be accessible, the CSI data sets must be cataloged and target zone index entries in the global zone must contain the correct data set name. You need to have at least READ access to the SMP/E CSI data sets.

SMP/E information for matched programs pertains to the whole program for PROGRAM elements, and to the replaced MOD for LMOD elements.

When ALLCSISCAN processing finds a DDDEF entry for the program library, all members with matching LMOD and PROGRAM elements will have the corresponding SMP/E details assigned to them.

When no DDDEF for the library is found, ALLCSISCAN processing attempts to match program bind dates with APPLY dates to determine the RMID for LMOD elements. Data related to global zones on the same volume as the program library are examined first when looking for a match. PROGRAM elements will not be matched at all when this method is used. For PDS libraries, SCANDIR requests will not collect the bind or link edit dates used in this process, so SCANPGM should be employed for this purpose where relevant.

For VOLCSISCAN and IPLCSISCAN processing, PROGRAM and LMOD SMP/E data is assigned to programs with matching names when the program library and global zone reside on the same volume.