Defining alias names for programs

If you need to define an entry point as an alias to Rational® Asset Analyzer, use the information in this topic.

About this task

If Rational Asset Analyzer does not resolve an entry point with a given name when it is building run units, you have the following options:

Ensure that a program with the named entry point has been scanned into the database. If the program is not there, scan it using the "Collect inventory" wizard. (You must have administrative authority to perform inventory collection.)
Define the entry point as a utility by editing the utility file. See the related topics for more information about defining a program as a utility.
Define the entry point as an alias of some other existing entry point by editing the aliases file.

The following example illustrates a situation in which it is helpful to define an entry point as an alias. Assume you have program PGMA that calls an entry point named SORT. In your production environment, PGMA is link-edited with options that cause it to include the entry point MYSORT and rename it to SORT, enabling the entry point to resolve. In Rational Asset Analyzer, the records in the aliases file provide a similar mechanism. These records tell the run unit builder what alternative names (aliases) to search for when it cannot resolve an entry point with a given name. The aliases file is used during postprocessing.

Defining aliases on System z

Procedure

To define alias names for programs in Rational Asset Analyzer for System z®:

Edit member ALIASES in &hlq.CONFIG.DATA and make your changes. The file comments contain instructions for editing the file.
Note: During installation of Rational Asset Analyzer, when the DMHINSTL ISPF command Option 0 is completed, a data set named &hlq.CONFIG.DATA containing member ALIASES is created. If you have migrated from a prior version of Rational Asset Analyzer and had previously made changes to the &hlq.SDMHDATA(DMHALIAS) member, you should copy only your installation-specific updates to &hlq.CONFIG.DATA(ALIASES). At runtime, the contents of &hlq.CONFIG.DATA(ALIASES) are concatenated in front of &hlq.SDMHDATA(DMHALIAS) to get the full list of aliases.
Create records with the form original_name alias_name. For the example above, the record could look like this:
```
SORT MYSORT
```
Save the file.

Results

Subsequent postprocessing uses the updated file. For the example above, when the run unit builder does not find the SORT entry point that the PGMA run unit needs, it then attempts to find an entry point named MYSORT to use when resolving the call from PGMA.

Defining aliases on Windows

Procedure

To define alias names for programs in Rational Asset Analyzer for Windows:

Edit the file installation_directory/data/dmhAlias.data and make your changes. The file comments contain instructions for editing the file.
Create records with the form original_name alias_name. For the example above, the record could look like this:
```
SORT MYSORT
```
Save the file.