Getting a Component Bill of Materials
The Component Bill of Materials takes a top-down view of component relationships. You ask a question about a superior component, and it tells you about subordinate components.
In other words, it tells you what components are contained in a component that you want to change.
Accessing the Component Bill of Materials Panel
Use one of these methods to display the Component Bill of Materials panel (CMNIMPBM):
-
Using the Menu Hierarchy:
-
On the Primary Option Menu, select Q Query.
-
On the Query Options menu (CMNQDMNU), select B BofM.
-
-
Using Direct Panel Access:
On a ChangeMan ZMF panel, type =Q.B in the Command or Option line and press Enter.
Specifying Search Criteria
You specify component search criteria on the Component Bill of Materials panel (CMNIMPBM).
CMNIMPBM Component Bill of Materials
Command ===>
Specify search criteria:
Component name . . . . . . +
Library type . . . . . . .
Application . . . . . . .
Type of relationship . . .
Short or Long form . . . . L
Enter "/" to select option:
Mixed case
The query bill of materials function returns a list of all subordinate components in all library types in all applications that are included in the target or wildcarded superior Component Name.
Important
This panel asks the question, "What components are contained in the component that I specify in the relationship that I specify?"
This table describes the fields on the Component Bill of Materials panel:
| Field | Required | Description |
|---|---|---|
| Component name | Required | Enter the name of a superior component. Valid values Include: |
| Like-source component name | ||
| Statically linked like-load component name | ||
| JCL component name | ||
| Cataloged procedure name | ||
| Valid formats include: | ||
| Full component name or string | ||
| Component name pattern or string ending in \ | ||
| 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 \ | ||
| A library type pattern (partial wild-card) is invalid in this field. | ||
| Application | Optional | Enter the application of the superior 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 (Copybook to source) | ||
| S: SUBROUTINE (Linked load to composite load) | ||
| J: JCL-PROCEDURE (Cataloged procedure to execution JCL) | ||
| P: PGM NAME/SYMBOL (Program name to JCL/Procedure) | ||
| D: DSN NAME/SYMBOL (Data set name to JCL/Procedure) | ||
| Short or Long form | Required | Enter the option for how many lines may be displayed for each subordinate component that matches the specified search criteria and results filters. |
| S: Display only one line for each subordinate component name. A plus sign (+) at the end of the line indicates that the list of appl:lib type combinations are truncated. | ||
| L: Display as many lines for each subordinate component as it takes to list all appl:lib type combinations where the relationship exists. | ||
| Mixed case | Required | Select this option to use the exact text entered in the superior component name to search for relationships. If not selected fold the superior component name text into upper case before searching for relationships. |
Displaying Bill of Materials Results
After you have filled in the Component Bill of Materials panel (CMNIMPBM), press Enter to display the Bill of Materials Results Selection List panel (CMNIMPB1).
CMNIMPB1 Bill of Materials Results Selection List Row 1 to 1 of 1
Command ===> ________________________________________ Scroll ===> CSR
List of components with
Name . . . . . GNLSRC1A +
Appl:Type . . .GENL : SRC
Relation . . ..COPYBOOK
Component Name Found in Appl:Libtype (common baselines) +
__GNLSRC1A GENL:SRC
******************************* Bottom of data ********************************
The top half of the panel echoes the search criteria for the superior component that you specified on the preceding Component Bill of Materials panel (CMNIMPBM).
The bottom half of the panel shows a list of superior components that match the search criteria you specified. If you specified * in the Library type and/or Application fields on the Component Bill of Materials panel, this panel may list more than one component.
The superior components listed on the bottom half of the sample Bill of Materials Results Selection List panel above conform to the search criteria for component name GNLSRC1A in a COPYBOOK relationship in any library type in any application.
This table describes the fields on the Bill of Materials 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 with | |
| Name | Component name that you specified under SEARCH CRITERIA on the Bill of Materials Results Selection List** panel (CMNIMPB1) |
| Appl:Type | Application and Library type that you specified under SEARCH CRITERIA on the Bill of Materials Results Selection List** panel (CMNIMPB1) |
| Relation | Type of relationship that you specified under SEARCH CRITERIA on the Bill of Materials Results Selection List** panel (CMNIMPB1) |
| line command | S: Show the Subordinate Component List panel (CMNIMPD4) for the selected component. |
| Component Name | Displays the names of superior components that satisfy the selection criteria that you specified on the Bill of Materials Results Selection List panel (CMNIMPB1) |
| 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 a previous table). |
If you type line command S on a superior component listed on the Bill of Materials Results Selection List panel (CMNIMPB1), the Subordinate Component List panel (CMNIMPD4) is displayed.
CMNIMPD4 Subordinate Component List Row 1 to 4 of 4
Command ===> _____________________________________ Scroll ===> CSR
Superior Component Name . GNLSRC1A +
Application:Type . . . . .GENL:SRC
Relationship . . . . . . .COPYBOOK
Subordinate Components Found in Appl:Libtype +
GNLCPY00 GENL:CPY
GNLCPY1A GENL:CPY
GNLCPY1B GENL:CPY
GNLCPY1X GENL:CPY
******************************* Bottom of data ********************************
This panel lists subordinate components contained in the selected superior component that have the relationship that you specified on the Bill of Materials Results Selection List panel (CMNIMPB1).
Important
This panel shows you what components are contained in the component you asked about.
This table describes the fields on the Subordinate Component 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. component Abbreviation: L | |
| Superior Component Name | Component name that you selected on the Bill of Materials Results Selection List** panel |
| Application:Type | Application and Library type that you specified under SEARCH CRITERIA on the Bill of Materials Results Selection List** panel (CMNIMPB1) |
| Relationship | Type of relationship that you specified under SEARCH CRITERIA on the Bill of Materials Results Selection List** panel (CMNIMPB1) |
| Subordinate Components | Displays the names of subordinate components that are contained in the selected superior component and that have the Type of relationship that you specified on the Bill of Materials Results Selection List panel (CMNIMPB1) |
| Found in Appl:Libtype | Displays the application and library type of the library where the subordinate component is baselined. See Short or Long form (in a previous table). |