Option A – Analysis
Option A is ISPW’s Cross Reference (or Component Reference) Analysis function. This option provides reports that can be invoked online or in batch to help analyze the references between ISPW managed components.
Invocation
Enter A from the Main Menu. The screen as shown in the following figure, is displayed.
Option A
Input Selection Criteria
The following table describes the Input Selection Criteria:
Criteria | Description |
|---|---|
Background | whether the report runs online or in batch. Specify Y for Batch or N for online. |
Report Code | whether to report on Calling or Called components. Specify 1 to report on components that reference the requested components or 2 to report on components that are referenced by the requested components. |
Iteration Limit | specifies the number of times to iterate through the calling hierarchy. For example, to report on the components that reference the referenced components, set a value of 2. |
Component Type | ISPW Type used to identify the components. |
Component Name | ISPW Name used to identify the components. |
Application | ISPW Application used to identify the components. |
Level | ISPW Level used to identify the components. |
Calling Component References
This report lists the components in the calling hierarchy that reference the components requested, together with any components that reference the referenced components, as determined by the requested iteration limit.
Interpreting the Report
The report heading identifies the selection criteria, followed by the information about the requested components, iterated to the requested level.
The example in the following figure shows a COBOL copybook named TCPYA08 that is referenced by COBOL programs TPROG08 and TPROG09.
Interpreting the Report
Calling Report Detail
Five columns identify the ISPW component that references the requested component:
The Category column identifies the type of reference. For example, COBOL copybooks, Assembler macros, and C header files could be assigned the INCL (include) Category, whereas programs and subroutines might be assigned the PGM (Program) category.
Iteration Limit
The iteration limit is used to limit the number of times ISPW looks up references to references. For the example shown in the following figure, an iteration limit of three has been chosen, and ISPW has repeated a search for references to references up to three times.
Iteration Limit
A macro $WTR is referenced by program WZZACCHK, which is referenced by program WZZSMSRM, which is referenced by WZZSMDSP. Indentation is used to help show the iteration.
Incomplete References
If references are found that are not complete, Partial details are reported together with special codes that signal why the reference is considered to be incomplete. An incomplete reference can occur for a number of reasons, especially when reporting references from non-production levels.
The Category column will display an ellipsis (….), and a brief status message will be added to the report line, as follows:
- Not Active—The referenced component is not active.
- Not Current Leg—The referenced component is not in the same development leg.
- Not Parsed—The referenced component has not been parsed.
Called Component References
This report lists those components in the calling hierarchy that are referenced by the components requested.
Interpreting the Report
The report heading identifies the selection criteria, followed by the information about the requested components. The example in the following figure shows that the Assembler program WZZACCHK references two Assembler macros and three Assembler programs.
Interpreting the Report
Called Report Detail
Five columns identify each ISPW component referenced by the requested component:
The Category column identifies the type of reference. For example, COBOL copybooks, Assembler macros, and C header files could be assigned the INCL (include) Category, whereas programs and subroutines might be assigned the PGM (Program) category.