Defining utility programs

You can define program names such as SORT in a utilities file to prevent Rational® Asset Analyzer from considering it an error if the program file is not found in the inventory. You can also explicitly define the names of Run units to process, thereby ignoring all the other run units in the inventory during run unit resolution processing.

About this task

A program with an error is not included in the results for an impact analysis. Some errors might be caused by product limitations or unresolved items. For a detailed error message, check the "Run unit details" page to locate information about these types of errors and possible solutions.

One such error, for example, is duplicate or missing entry points. Rational Asset Analyzer cannot determine the run unit if duplicate entry points exist or if the program for an entry point is missing from the inventory.

Note: Primary (main) entry point resolution identifies duplicates as ambiguous. Subroutine entry point resolution considers the Container, Application and Site of the calling program when resolving the location of the called program. Run unit resolution does not cross Site boundaries.

You can resolve a missing entry point by loading the missing program or by editing the utility file to accept the missing entry point without any errors. Duplicate entry points can be resolved by eliminating all duplicate entry points that did not create the run unit or organizing the duplicates so that each one is assigned to a different container or application.

In addition, you can edit the utility file to list only those Run units you want processed. Do this by adding a record to the utility file that contains a plus sign (+) in column one, followed by the name of the Run unit. If no Run unit records are found in the utility file, all Run units, for example, all newly added to the inventory and those whose Analysis status = Error, are processed.

Order and grouping of the records in the utility file is not relevant. However, you may find it helpful for usability and quick reference to group all the filter records together, and all the utility records together, in alphabetical order, but this is not a processing requirement.

You can use the following wildcard characters anywhere in the names that you specify in the utility file:
  • * matches zero or more characters
  • ? matches exactly one character
Parent topic: Refining your inventory

Defining a utility program on System z

Procedure

To define a utility program in Rational Asset Analyzer for System z®:

  1. Edit member UTILS in &hlq.CONFIG.DATA and make your changes.
    Note: During installation of Rational Asset Analyzer for System z, when DMHINSTL option 0 is completed, a data set named &hlq.CONFIG.DATA containing member UTILS is created. If you have migrated from a prior version of Rational Asset Analyzer and had previously made changes to the &hlq.SDMHDATA(DMHUTILS) member, you should copy only your installation-specific updates to &hlq.CONFIG.DATA(UTILS). At runtime, the contents of &hlq.CONFIG.DATA(UTILS) are concatenated in front of &hlq.SDMHDATA(DMHUTILS) to get the full list of utilities.
  2. Create records with the form utility_name description, where
    utility_name
    The name of the utility.
    description
    The description of the utility.
    For example, the record might look like this: 
    SORT Process the SORT program
  3. Create Run unit records with the form +run_unit_name description, where
    run_unit_name
    The name of the run unit.
    description
    The description of the run unit.
    For the example, the records might look like this: 
    +FX* Process all Run units prefixed with FX
+Z22* Process all Run unit prefixed with Z22
+XYZ1234 Process Run unit named XYZ1234
  4. Order and group the records however is most helpful to you. For the example, the records might look like this: 
    +FX* Process all Run units prefixed with FX and skip processing for all other Run units.
SORT Within the processed Run units (in this case FX*), process the SORT program
TST* Within the processed Run units (in this case FX*), process all programs prefixed with TST
  5. Save the file.

Defining a utility program on Windows

Procedure

To define a utility program in Rational Asset Analyzer for Windows:

  1. Edit the file installation/Path/data/dmhUtil.data and make your changes.
  2. Create records with the form utility_name description, where
    utility_name
    The name of the utility.
    description
    The description of the utility.
    For example, the record might look like this: 
    SORT Process the SORT program
  3. Create Run unit records with the form +run_unit_name description, where
    run_unit_name
    The name of the run unit.
    description
    The description of the run unit.
    For the example, the records might look like this: 
    +FX* Process all Run units prefixed with FX
+XYZ1234 Process Run unit named XYZ1234
  4. Order and group the records however is most helpful to you. For the example, the records might look like this: 
    +FX* Process all Run units prefixed with FX and skip processing for all other Run units.
SORT Within the processed Run units (in this case FX*), process the SORT program
TST* Within the processed Run units (in this case FX*), process all programs prefixed with TST
  5. Save the file.