Component Bill of Materials

The Component Bill of Materials function performs a top-down query to find all subordinate components on which the selected, higher-level component has dependencies. For example, a higher-level program might call multiple subroutines, and you might want a list of all the subroutines involved before you change the program.

A bill-of-materials query can be performed for superordinate components that are likesource, like-load, like-copybook, or a member of a JCL procedure library. Subordinate components can be copybooks, subroutines, JCL procedures, or name-to-symbol mappings for data sets and programs referenced by the superordinate component.

The dependency relationship of interest is selectable at the time the bill of materials list is requested. Only one dependency type may be queried at a time.

Invoking and Viewing the Bill of Materials

Invoking the Bill of Materials

The Component Bill of Materials list is invoked from the following menus in the Serena Explorer navigation view of the Serena perspective:

• Baseline component contextual menu — Expand the z/OS Applications node for the relevant ZMF server. Navigate to the desired application node and expand it, then expand the Baseline node and the node for the relevant baseline library, then right-click on the component whose build of materials you wish to view. When the contextual menu displays, select Component Bill of Materials. See ZMF Operations on Baseline Library Components.

• Package component contextual menu — Expand the z/OS Applications node for the relevant ZMF server. Navigate to the desired application node and expand it, then expand the Packages node, then the node for the relevant change package and staging library, then right-click on the component whose build of materials you wish to view. When the contextual menu displays, select Component Bill of Materials. See ZMF Operations on Package Components

• Promotion component contextual menu — Expand the z/OS Applications node for the relevant ZMF server. Navigate to the desired application node and expand it, then expand the Promotion node, then the node for the relevant promotion site, promotion level, and library type, then right-click on the component whose build of materials you wish to view. When the contextual menu displays, select Component Bill of Materials. See ZMF Operations on Promoted Components.

Viewing the Bill of Materials

The requested build of materials list displays in a ZMF table view under the Component Bill of Materials tab in the lower right pane of the perspective.

Bill of Materials Wizard Step-by-Step

To request a component bill of materials list, perform the following steps.

1. Select the Component Bill of Materials option from the superordinate component’s contextual menu.

2. The Select Component Bill of Materials Parameters window displays the selected component for verification and prompts you for a dependency relationship.

   

3. Verify that the Component Name, Library Type, and Application values shown are correct. If desired, edit the values in these text fields.

   !!! Tip Wild cards may be used to request multiple superordinate components, multiple library types, or cross-application queries.

4. In the Relationship field, select from the pull-down list the dependency relationship for which a component bill of materials list is desired.

      |Option|Description|
      |:--------|:----------------|
      |Copybook|Requests all copybooks referenced by the higher-level component. Returns SRC, like-source, CPY, and like-copybook objects only; other library types are ignored.|
      |DSN Name/Symbol|Requests all data set name-to-symbol mappings used by the higher-level component (that is, any subordinate JCL components that include a DSN= or DSNAME= parameter in a DD statement). Returns JCL, like-JCL, PRC, and like-procedure objects only.|
      |JCL Procedure|Requests all JCL procedures invoked by the higher-level component (that is, any subordinate JCL components that include an EXEC statement). Returns JCL, like-JCL, PRC, and like-procedure objects only.|
      |PGM Name/Symbol|Requests all program name-to-symbol mappings used by the higher-level component (that is, any subordinate JCL components that contain a PGM=parameter in an EXEC statement). Returns JCL, like-JCL, PRC, and like-procedure objects only.|
      |Subroutine|Requests all subroutines called by the higher-level component (that is, all subordinate load modules that reference a statically link-edited subprogram). Returns LOD and like-load objects only.|
   

5. Click the Case Sensitive Query checkbox if the search for component dependencies should respect case in component, library, and application names. This option is frequently desirable with z/OS USS zFS components.

6. Click OK to submit the query.

7. A list of subordinate components matching your search criteria are returned under the Component Bill of Materials tab in the bottom right pane of the perspective. The search parameters appear in the information bar below the tab name. For example: