Program details

A program is that portion of a run unit that is complete enough to be compiled separately. Typically, a program is one source file.

The "Program details" page shows the details for a particular program. You access the details page by clicking a program name on any page on which programs appear, such as the "Program summary" page.

Use the "Program details" page to:

See the attributes of a specific program.
Perform actions on the asset.
See other assets that are related to the current asset.

This page contains sections that help you with the following tasks.

Context

This section is in the upper-left corner of the page. It opens the "Bookmark this page" wizard in a separate window.

Details

This section is the shaded area at the top left of the page. It shows the attributes of the asset. If an attribute name is a link, you can access a details page for it by clicking the link. If an icon is present, mouse over the icon for the tooltip to appear, such as View source, Control flow diagram, or Structure diagram. You can click the icon to open the corresponding object in a separate window. For more information on the attributes shown, see the following topics:

Common attributes: Describes attributes that are common to multiple assets.
DMH_COMPILE_UNIT database table: Describes attributes specific to programs.

Check the analysis status to determine if you need to take some action. The analysis status can be one of the following:

Completed - Rational® Asset Analyzer has completed asset attribute collection and assignment tasks. You might receive informational and warning messages about issues encountered during these tasks.
Error - Rational Asset Analyzer has completed the asset attribute collection and assignment tasks that it could, but has encountered an issue it cannot resolve. If any error or warning messages are associated with this asset, you can click Analysis Messages in the header of the Details section link to them. Click Details to close them. You can click Database -> Errors to view assets with errors.
Incomplete - Rational Asset Analyzer has started to collect and assign asset attributes, but has not finished the required tasks.

Programs with an incomplete or error status are not included in the results from an impact analysis. An incomplete status usually indicates that the file has not completed the inventory process. An error status can indicate the program code contains a syntax error. However, some errors might also be caused by product limitations or by unresolved items. Check this page for exact descriptions of errors.

Actions

This section is a drop-down list on the right side of the page. From this list you can select actions to perform on the current asset. For more information on the actions available on this page, see the following topics:

Add to application, project, or working set (dialog opens in a new window)
Analyze impact for a range of statements (wizard opens in a new window)
(Available when the language of the program is COBOL, PL/I, or ASM.)
Assign concatenation set (wizard opens in a new window)
Tip: This action is hidden unless you are logged on with an ID that has product administrative authority.
Assign a new language or type (wizard opens in a new window)
Tip: This action is hidden unless you are logged on with an ID that has product administrative authority.
Configure scanning options (wizard opens in a new window)
Tip: This action is hidden unless you are logged on with an ID that has product administrative authority.
Dead code (COBOL programs only. Opens the "Source code" window)
e-business program information
Manage annotations (dialogue opens in a new window)
Program data elements
Queue for analysis (wizard opens in a new window)
Tip: This action is hidden unless you are logged on with an ID that has product administrative authority.
Relate to rule (dialog opens in a new window)
Show Program diagram (opens a new window)
View related source (opens a new window)
View source (opens a new window)
Custom query (run a custom query that has been assigned to this page)

Related assets

This section is a series of tabbed tables that show attributes of assets related to the current asset. From these tables, you can click a name to open a details page for a specific related asset or click an action to perform it on the asset in the corresponding row.

Included files: Shows source files used by the program. You can delete or annotate the entries in this table.
BMS maps: Shows BMS map definitions used by this program. This tab is displayed only if the BMS map set is used in the program. To go to BMS map definition details or BMS map set definition details pages, click the corresponding link in the result rows. When a map or map set is referenced in a CICS command that uses a data element, and the map or map set name cannot be resolved to a literal value, clicking the link goes to a placeholder map or map set whose name is UNKNOWN. Values for map or map set names can be resolved from the initial value that is declared for the data element definition, and can be transferred to the data element via move and assignment statements.
Batch jobs: Shows batch jobs that execute run units that use the program. You can delete or annotate the entries in this table.
Control transfers: Shows entry points, DB2® stored procedures, CICS® transactions, or CICS Web services to which this program transfers control. Control transfers also show other programs that transfer control to this program. Click Called programs to show entry points, DB2 stored procedures, CICS transactions, or CICS Web services to which the program transfers control. Click Calling programs to show other programs that transfer control to this program.
DB2: Shows DB2 assets related to the program. Click DB2 tables, DB2 columns, DB2 stored procedures, or DB2 cursors to choose the related DB2 asset type to display. Use the search fields to refine the list of DB2 assets shown.
Tip: The Advanced search has a checkbox to include unreferenced tables.
Data sets: Shows data sets used by the program.
Data stores: Shows data stores used by the program.
Entry points: Shows entry points defined in the program. You can annotate the entries in this table.
Link decks: Shows link decks that include this program.
Run units: Shows run units that use the program. You can annotate or delete entries in this table.
Transactions: Shows CICS or IMS transactions that use the program, or that are used by this program..
Working sets: Shows working sets that this program is assigned for.
Code review: Shows code review issues found in this program. This tab displays only for COBOL and PL/I programs.
Rule mining: Shows rule mining assets related to this program.
User-related assets: Lists the name and type of asset related to the current file through user-defined relationships. Also lists the name of the user-defined relationship and the asset's role in the relationship (source or target). Click the name of the asset to open the details page for that asset. Click the name of the user-defined relationship to open the details page for that relationship.
Annotations: Shows annotation text defined for the program.

For more information on the actions you can perform on related assets, see the following helps:

Annotating assets (dialogue opens in a separate window)
Deleting assets from the inventory

For more information on the asset types you can link to from this section, click the links under "Related Help."