Managing Model Objects › Impact Analysis › Example

Example

This example demonstrates the Display Model Usage utility and the use of the Scope specification. The concepts shown also apply to references.

1. From the Edit Model List panel press F20 to display usages. The Display Model Usages command is prompted from which you can specify whether the output is to be displayed (*), printed (*PRINT), or copied to a model object list (*MDLLST).

   Note: Although this is not the recommended method to work with usages interactively, it is included in this example to explain the converted list displayed on the first panel. Starting at step 2, this example shows both methods of working with usages.

   If you choose to display usages, begins by displaying the contents of the list you specified, updated to reflect the current state of each model object from *ALLOBJ. This is indicated by *ENTRY in the Reason column for each model object. The name of the originating model object list is shown in the Converted List field in the upper-left of the screen. Note that the original list is not changed by this process.

   

   The converted list of model objects displayed differs from the contents of the original model object list in the following ways:

   • By default, only model objects that are currently active in the model are displayed. Non-current versions are not displayed. See the Working with Versions of Functions and Messages section in this chapter for more information on the current version.
   • Details from the All Objects list are displayed for each model object; for example, if the name of the actual model object differs from that of the model object list entry, the model object name is displayed. In other words, the display reflects the current state of the model.
   • Model objects that appear on the model object list, but have been deleted from the model, are not displayed. Any list entries that see the deleted objects are ignored.

   Note: Your model object list is not changed by this operation.

   You can now use the selection options on any of the model objects displayed. To see additional options, press F23.

2. To display all usages for the internal function, Retrieve Customer, type selection option 91 against Employee and press Enter. The following panel displays:

   

   Note the values displayed in the Lvl and Reason columns for each object and how they relate to the diagram that follows. Lvl 000 indicates the object whose usages are shown. This object is used by the Lvl 001 objects, which in turn are used by the Lvl 002 objects. The Lvl 000 object is included so you can edit the originating object as well as the using objects.

3. When a model object is used by many other model objects, it is not always easy to determine the usage structure when Scope is set to *NOMAX, which displays all levels of usages. Instead, you can set Scope to *NEXT to step through the usage expansion one level and one model object at a time.

   Press F15 to return to the Level 001 panel. Change the Scope option to *NEXT and press Enter. Next, enter 91 for Employee and press Enter.

   The following panel displays.

   Note: From here on the process shown in this example is the same for both methods of working interactively with usages; namely, whether you pressed F20 or typed selection option 91 against a model object.

   

   This panel shows only the Lvl 001 model objects that use the Employee file.

4. Enter 91 for the Order file to expand usages to the next level for just that model object. The following panel displays:

   

5. To expand usages for ‘RSQ by Employee name’ access path instead, press F12 to return to panel Level 002 and enter 91 against that object. The following panel displays, indicating that the ‘RSQ by Employee name’ access path is used only by the ‘Display Employees by Name’ function.