Cross-references

Perspective  ARCAD Observer
Access  Server >  Applications >  Application Name >  Repository

ARCAD Observer allows you to navigate all the cross-references in your application and to find detailed information about them. It is possible to select several item before starting a cross-reference analysis. The result of this analysis can be used as a starting point of a new cross reference analysis.

Shows the called or calling components for a given component. This request is only available for components that allow calling of another component (program, command, etc.).

Step 1   Select one or several program components in the view then right-click and select Analyze > Calls.

A  Cross-references: Calls view is displayed showing the analysis results.

Note

The results list first shows called components, then the calling components. The list of called components is sorted by increasing order of the resulting component’s call sequences in the source of the analyzed component.

Calls cross-references analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Include commands
If this option is checked, program cross-references will include commands.
Include ILE Links
If this option is checked, components associated through an ILE link are added to the result list.
Include Module Links
If you check this option, program cross-references will include calling and called modules. This option is only valid for cross-reference calculations starting from a module.

The Direction column contains the relationship type between the analyzed component and the result component. This type can take the Called or Calling values in the case of a call; or Used By or Using values in the case of an ILE link.

Shows the components that use or are used by a given component.

Step 1   Select one or several components in the view then right-click and select Analyze > Utilization.

A  Cross-references: Utilization view is displayed showing the analysis results.

Utilisation cross-references analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.

The Usage column contains a description of how the resulting component is used by the analyzed component. The possible values are: [Not Specified, Input, Output, Input/Output, Update, Input/Update, Output/Update, and Input/Output/Update].

You can consult the keys (or set of keys) used by a program to access a file.

Step 1   Verify that the Auto-refresh icon is engaged.

Step 2   Select a program from the analyzed component tree.

Step 3   Select a file from the result list.

Result   The keys used by the program to access the file are displayed in the Extended information section of the result view.

Access keys

Shows a given file’s dependent files. If the selected file is a physical file, the dependent files will be the associated logical files or the physical files dependent by format. If the selected file is a logical file, the dependent file will be the master physical file.

Step 1   Select one or several components in the view then right-click and select Analyze > Dependent files.

A  Cross-references: Dependent files view is displayed showing the analysis results.

Dependent files analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Ascending level & Descending level
Enter a value to set the levels of ascending and descending file levels you want to display.
Display related PF & Display related LF
Click to set to True or False the related physical and logical files to display.
Display constraints
Click to set to True or False the constraints to display.

Shows the list of fields that are declared or (directly or indirectly) manipulated by the selected component.

Step 1   Select one or several components in the view then right-click and select Analyze > Fields.

A  Cross-references: Fields view is displayed showing the analysis results.

Fields analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Usage type
*USED Only downloads the explicitly used fields from among the referenced fields.
*UPD Only downloads the updated fields from among the referenced fields.
*IMPL Only downloads the explicitly and implicitly used fields from among the referenced fields.
*ALL Downloads all referenced fields.
Sort
*ALPHA to display Alpha types fields first.
*LINE to display the result in the lines' order.

The Definition column indicates if the field is Internal or External.

The Usage column indicates how the field is used by the component. The possible values are Yes, Implicit, No.

The Extended information section give you information about the source lines for a given component where a given field is used.

From a field analysis result, or from the field repository in the ARCAD Observer DB perspective, you can access further field analysis tools.

Shows the list of directories that contain the field referenced by the fields in the selection.

Step 1   Select one or several fields in the view then right-click and select Analyze > Reference files.

A  Cross-references: Reference files view is displayed showing the analysis results.

Reference files analysis result view

The Reference Field column displays the name of the directory's referenced field.

The Extended information section give you information about the source lines for a given component where a given field is used.

Shows the list of composite fields for fields in the selection.

Step 1   Select one or several fields in the view then right-click and select Analyze Composite fields.

A  Cross-references: Composite fields view is displayed showing the analysis results.

Composite fields analysis result view

The Relation column displays the value that identifies the type of hierarchical relationship between the selected field and the composite field. The possible values are Mother or Daughter.

The Type column displays the value that identifies the type of link between the selected field and the composite field.

Shows the list of components that process the fields in the selection. This search is performed using the selected field/file pair that contains the field.

Step 1   Select one or several fields in the view then right-click and select Analyze > Component > Field and file.

A  Cross-references: Field and file view is displayed showing the analysis results.

Fields and files analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Usage type
*USED Only downloads the explicitly used fields from among the referenced fields.
*UPD Only downloads the updated fields from among the referenced fields.
*IMPL Only downloads the explicitly and implicitly used fields from among the referenced fields.
*ALL Downloads all referenced fields.
Sort
*ALPHA to display Alpha types fields first.
*LINE to display the result in the lines' order.

The Definition column indicates if the field is Internal or External.

The Usage column indicates how the field is used by the component. The possible values are Yes, Implicit, No.

The Extended information section give you information about the source lines for a given component where a given field is used.

Shows the list of components that manipulate the fields in the selection. This search is performed using only the field name and does not include the file the field belongs to.

Step 1   Select one or several fields in the view then right-click and select Analyze > Component > Field only.

A  Cross-references: Field only view is displayed showing the analysis results.

Fields only analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Usage type
*USED Only downloads the explicitly used fields from among the referenced fields.
*UPD Only downloads the updated fields from among the referenced fields.
*IMPL Only downloads the explicitly and implicitly used fields from among the referenced fields.
*ALL Downloads all referenced fields.
Sort
*ALPHA to display Alpha types fields first.
*LINE to display the result in the lines' order.

The Definition column indicates if the field is Internal or External.

The Usage column indicates how the field is used by the component. The possible values are Yes, Implicit, No.

The Extended information section give you information about the source lines for a given component where a given field is used.

Shows the list of literals that are declared or (directly or indirectly) manipulated by the selected component.

Step 1   Select one or several components in the view then right-click and select Analyze > Literals.

A  Cross-references: Literals view is displayed showing the analysis results.

Literals analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Usage type
*USED Only downloads the explicitly used fields from among the referenced fields.
*UPD Only downloads the updated fields from among the referenced fields.
*IMPL Only downloads the explicitly and implicitly used fields from among the referenced fields.
*ALL Downloads all referenced fields.
Sort
*ALPHA to display Alpha types fields first.
*LINE to display the result in the lines' order.

The Definition column indicates if the literals is Internal or External.

The Usage column indicates how the literals is used by the component. The possible values are Yes, Implicit, No.

Shows the list of procedures that are used by the selected component.

Step 1   Select one or several components in the view then right-click and select Analyze > Procedures.

A  Cross-references: Procedures view is displayed showing the analysis results.

Procedures analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Other cross-reference analysis options
Parameter Value
Used only procedures Click to set to True or False to display used procedures only.

The Extended information section give you information about the Defining, Executing or Declaring component of the selected procedure in the result view.

Click the Source icon to display the source code of the defining component. The source code of the procedure is displayed in a new view.

Shows the list of source inclusions for a given component.

Step 1   Select one or several components in the view then right-click and select Analyze > Source inclusion.

A  Cross-references: Source inclusion view is displayed showing the analysis results.

Source inclusion analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.
Link type
*SIMILAR displays links resulting from component copies.
*INCLUDE displays COPY clause type links
*L4GL3G displays the 3rd and 4th generation languages links types.
*ALL Displays all link types for the selected component.

Shows the list of ILE components that use or are used by the selected component. The request also allows you to obtain a graphical representation of the internal calling architecture between modules.

Step 1   Select one or several components in the view then right-click and select Analyze > ILE encapsulation links.

A  Cross-references: ILE links view is displayed showing the analysis results.

ILE links analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.

The Direction column indicates how the component is linked to the selected component. The possible values are Used By, Using.

Shows the list of messages identifiers used by a given component.

Step 1   Select one or several components in the view then right-click and select Analyze > Message Identifiers.

A  Cross-references: Message Identifiers view is displayed showing the analysis results.

Message identifiers analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.

The MSGID column shows the identifier for the message used.

The Sequence Number column indicates at which sequence number the message identifier is used.

Shows the list of component using a given message.

Note

Only available for *MSGF component types.

Step 1   Select one or several components in the view then right-click and select Analyze > Components using the message.

A  Cross-references: Components using the message view is displayed showing the analysis results.

Message use analysis result view

Step 2   Use optional parameters to analyze the results in the call parameter section, then click on the component to refresh the results.

Inter-application links
Specifies whether or not to use inter-application links for cross-reference usage. The list of applications linked to the current application is obtained by examining the links defined in the application's descriptive parameters (found using the command ADSPAPPINT). The possible values are:
  • *NONE: The inter-application links are not used. Only the components present in the interrogating application are known.
  • *USE: The inter-application links are used to simulate the real usage context for components. The link is made towards the applications used or with a reciprocal link. In the case of a component homonym, only the first one found is taken.
  • *ALL: The inter-application links are used to determine all the applications concerned by a component. The link is made in all directions (applications used or using the current application or reciprocal link). In the case of a component homonym, all the applications of this component are displayed, in the order defined in the inter-application links.