Impact Analysis of Subordinate Components

The Impact Analysis of Subordinate Components takes a bottom-up view of component relationships. You ask a question about a subordinate component, and it tells you about superior components.

In other words, it tells you what components contain a component that you want to change.

Accessing the Impact Analysis of Subordinate Components Panel

Use one of these methods to display the Impact Analysis of Subordinate Components panel (CMNIMPSU):

Using the Menu Hierarchy:
1. On the Primary Option Menu, select Q Query.
2. On the Query Options menu (CMNQDMNU), select I Impact.
Using Direct Panel Access:

On a ChangeMan ZMF panel, type =Q.I in the Command or Option line and press Enter.

Specifying Search Criteria And Results Filters

You specify two types of criteria on the Impact Analysis of Subordinate Components panel (CMNIMPSU):

Search criteria
Results filter criteria

CMNIMPSU        Impact Analysis of Subordinate Components
Command ===> ______________________________________________

Specify search criteria:

Subordinate component name . . . ________________________________ +
Library type . . . . . . . . . . _____
Application . . . . . . . . . .  _______

Type of relationship . . . . . ._________________________


Specify results filter criteria:

Superior component name . . . .  ________________________________ +
Library type . . . . . . . . . . _____
Application . . . . . . . . . .  ________

Short or Long form . . . . . . . L

Enter "/" to select:
__Mixed case

You specify component search criteria on the top half of the panel.

Impact analysis returns a list of all superior components in all library types in all applications that include the target or wildcarded Subordinate Component Name in the specified type of relationship.

You specify filter criteria on the lower half of the Impact Analysis of Subordinate Components panel to limit the results that are displayed.

Important

This panel asks the question, "What components contain the component that I specify in the relationship that I specify?" The panel lets you limit the scope of the answer.

This table describes the fields on the Impact Analysis of Subordinate Components

panel:

Field	Required	Description
SPECIFY SEARCH CRITERIA	Specify the subordinate component or components you want to investigate.
Subordinate component name	Required	Enter the name of a subordinate component. Valid values Include:
		Like-copy component name
		Statically linked like-NCAL or like-load subprogram name
		Cataloged procedure name
		Program name or string in JCL PGM= statement
		Data set name or string in JCL DSN= statement
		Valid formats include:
		Full component name or string
		Component name pattern or string ending in \
Library type	Optional	Enter the library type of the subordinate component. Valid formats include:
		Full three-character library type
		Asterisk (*) for all library types
		Blank, which defaults to \
		A library type pattern (partial wild-card) is invalid in this field. Enter asterisk (*) if the subordinate component is one of the following, which are stored in impact analysis as character strings rather than as components with library types:
		Cataloged procedure name
		Program name or string in JCL PGM= statement
		Data set name or string in JCL DSN= statement
Application	Optional	Enter the application of the subordinate component. Valid formats include:
		The full three- or four-character full application mnemonic
		Asterisk (*) for all applications
		Blank, which defaults to \
		A pattern (partial wild-card) is invalid in this field.
Type of relationship	Required	Enter the relationship between the superior and subordinate components that you want to evaluate. Valid values are listed below. Valid formats include either the abbreviation on the left or the full relationship name. Either may be entered in upper or lower case.
		C: COPYBOOK (Source to copybook)
		S: SUBROUTINE (Composite load to linked load)
		J: JCL-PROCEDURE (Execution JCL to cataloged procedure)
		P: PGM NAME/SYMBOL (JCL/Procedure to program name)
		D: DSN NAME/SYMBOL (JCL/Procedure to data set name)
Mixed case	Optional	Select to use the exact text entered in the subordinate component name to search for relationships. If not selected, it will fold the text entered for subordinate component name into upper case before searching for relationships.
SPECIFY RESULTS FILTER CRITERIA	Specify filter criteria if you want to see a subset of the superior components that have a relationship to the component you are investigating.
Superior component name	Optional	Enter the name of a superior component. Valid formats Include:
		Full component name
		Component name pattern
		Asterisk (*) for all names
		Blank, which defaults to \
Library type	Optional	Enter the library type of the superior component. Valid formats include:
		Full three-character library type
		Asterisk (*) for all library types
		Blank, which defaults to \
Application	Optional	Enter the application of the subordinate component. Valid formats include:
		The full three- or four-character full application mnemonic
		Asterisk (*) for all applications
		Blank, which defaults to \
Short or Long form	Required	Enter the option for how many lines may be displayed for each superior component that matches the specified search criteria and results filters.
		S: Display only one line for each superior component name. A plus sign (+) at the end of the line indicates that the list of appl:lib type combinations is truncated.
		L: Display as many lines for each superior component as it takes to list all appl:lib type combinations where the relationship exists.

Displaying Impact Analysis Results

After you have specified the desired search and filter criteria on the Impact Analysis of Subordinate Components (CMNIMPSU) panel, press Enter to display the Impact Analysis Results Selection List (CMNIMPI1).

CMNIMPI1            I/A Results Selection List        Row 1 to 2 of 2
Command ===> ________________________________________Scroll ===> CSR

Components which reference:
  Appl: GENL Type: LOS Rel:  SUBROUTINE    Name: GNLSRS00           +
and satisfy these criteria:
  Appl: *     Type: * Name: *                                       +

   Component Name       Found in Appl:Libtype (common baselines)    +
__ GNLSRC1A             GENL:LOD
__ GNLSRC50             GENL:LOD
******************************* Bottom of data ********************************

The top half of the panel echoes the search criteria and results filter criteria for the subordinate component that you specified on the preceding Impact Analysis of Subordinate Components panel (CMNIMPSU).

The bottom half of the panel shows a list of superior components that satisfy the search and filter criteria that you specified.

Important

This panel shows you what components contain the component you asked about in the relationship you asked for.

The two superior components listed on the bottom half of the sample Impact Analysis Results Selection List panel above all contain component GNLSRS00.

This table describes the fields on the Impact Analysis Results Selection List panel

Field	Description
Command	Enter one of the following commands, or leave the command line blank and type a line command next to a component name.
	CANCEL: Cancel selections and exit this panel. Abbreviation: C.
	LOCATE component: Locate a specified component in the listed results. Abbreviation: L
	REFRESH: Display updated information on this panel. Abbreviation: R
List of components which reference
Appl:Type	Application and Library type that you specified under SEARCH CRITERIA on the Impact Analysis Of Subordinate Components** panel (CMNIMPSU).
Name	Subordinate component name that you specified under SEARCH CRITERIA on the Impact Analysis Of Subordinate Components** panel (CMNIMPSU).
with a relationship of: which satisfy these criteria:	Type of relationship that you specified under SEARCH CRITERIA on the Impact Analysis Of Subordinate Components** panel (CMNIMPSU).
appl:Type	Application and Library type that you specified under RESULTS FILTER CRITERIA on the Impact Analysis Of Subordinate Components** panel (CMNIMPSU).
Name	Superior component name that you specified under RESULTS FILTER CRITERIA on the Impact Analysis Of Subordinate Components panel (CMNIMPSU).
line command	S Show the Subordinate Component List panel (CMNIMPD4) for the selected component.
Component Name	Displays the name of superior components that satisfy the selection and filter criteria that you specified on the Impact Analysis of Subordinate Components panel.
Found in Appl:Libtype (common baselines)	Displays the application and library type of the library where the superior component is baselined. See Short or Long form (in previous table).

If you type line command S on a superior component listed on the Impact Analysis Results Selection List panel (CMNIMPI1), the Subordinate Component List panel (CMNIMPD4) is displayed. This panel lists subordinate components contained in the selected superior component that have the same relationship type as your original query.

CMNIMPD4        Subordinate Component List              Row 1 to 3 of 3
Command ===> _________________________________________ Scroll ===> CSR

Superior Component Name . GNLSRC1A                                  +
Application:Type . . . . .GENL:LOD
Relationship . . . . . . .SUBROUTINE

Subordinate Components              Found in Appl:Libtype           +
GNLSRS00                            GENL:LOS
GNLSRS1B                            GENL:LOS
GNLSRS1C                            GENL:LOS
******************************* Bottom of data ********************************

This example shows that source component GNLSRC1A, which was selected on the preceding Impact Analysis Results Selection List panel, contains the following subordinate components:

GNLSRS00, GNLSRS1B and GNLSRS1C in the LOS baseline library in application GENL.

That is, the panel shows all of the subordinate SUBROUTINE relationships that exist for superior source component GNLSRC1A, which is library type LOD in application GENL.

Note

This is the same result panel that you see when you use the Component Bill of Materials query to see what subordinate components are contained in a superior component.