Generating a Hierarchy Display

The Hierarchy Display (H) option is available on the List of Applications panel (see Figure 1) and the Where Used List panel (see Figure 1). Use the hierarchy display to help you visualize the current display structure of any defined panel application. It can be very helpful when you are managing application definitions.

Type H in the field next to the panel application for which you want the hierarchy display.

Note: If you enter H next to a function or an environment, a message is displayed that indicates hierarchy displays can be derived only from panel applications.

You can then see the Hierarchy Display panel that lists all the panels, functions, and environments (used by the functions) that can be reached from that panel.

Figure 1 is an example of a hierarchy display.

Figure 1. Example of Hierarchy Display

ICQAME19  USERID.ICFHIER.LIST - 01.05 --------------LINE 000000 COL   001  080
Command ===>                                                  SCROLL ===>  HALF

 Name                                     Type           Language      Level
-------------------------------------------------------------------------------
ICQUSER                                   PANEL          ENGLISH       PRIVATE
  ICQDESCRIBE                             FUNCTION       ENGLISH       SYSTEM
  ICQDESCRIBE                             FUNCTION       ENGLISH       SYSTEM
  ICQNAMES                                FUNCTION       ENGLISH       SYSTEM
    ICQENVIRON                            ENVIRONMENT    ENGLISH       SYSTEM
  ICQANALYSIS                             PANEL          ENGLISH       SYSTEM
    ICQDESCRIBE                           FUNCTION       ENGLISH       SYSTEM
  > ICQADRS                               FUNCTION       ENGLISH       SYSTEM
    ICQCHART                              PANEL          ENGLISH       SYSTEM
      ICQDESCRIBE                         FUNCTION       ENGLISH       SYSTEM
      ICQICU                              FUNCTION       ENGLISH       SYSTEM
        ICQENVIRON                        ENVIRONMENT    ENGLISH       SYSTEM
      ICQIMAGE                            FUNCTION       ENGLISH       SYSTEM
        ICQENVIRON                        ENVIRONMENT    ENGLISH       SYSTEM
      ICQTUTOR                            FUNCTION       ENGLISH       SYSTEM
    ICQCOURSES                            FUNCTION       ENGLISH       SYSTEM
      ICQENVIRON                          ENVIRONMENT    ENGLISH       SYSTEM
    ICQPROBLEM                            FUNCTION       ENGLISH       SYSTEM
    ICQTUTOR                              FUNCTION       ENGLISH       SYSTEM
    ICQEXIT                               FUNCTION       ENGLISH       SYSTEM

Note: > next to an application name indicates that the application is unavailable to users.

The hierarchy is presented in list form with the applications appearing as they would be invoked at run-time. All levels of ownership (system, group, private) currently allocated are shown in the list. When the application is defined for more than one level of administration, only the lowest occurrence equal to or above your level of administration is listed.

By default, when an application on the Hierarchy Display panel is unavailable or is not verified, the application is listed, and processing continues to the next application with no further nesting under the unavailable or unverified application.

If your installation has customized the application search process, and an application on the Hierarchy Display panel is unavailable or is not verified, the system conducts a search to locate the next higher-level library that contains an application with the same name and language. If an application is found, processing continues for any nested applications, and those applications are listed.

When the hierarchy display listings exceed the allowed horizontal space, the generated hierarchy is depicted as:

ICQPANEL          PANEL       ENGLISH      SYSTEM
  ICQPANEL2       PANEL       ENGLISH      SYSTEM
  ICQFUNCTION     FUNCTION    ENGLISH      SYSTEM
     *APPLICATION(S)  NOT SHOWN

When a hierarchy display is requested for a panel application that references an application that does not exist, the generated hierarchy is depicted as:

ICQPANEL          PANEL       ENGLISH      SYSTEM
  ICQPANEL2       PANEL       ENGLISH      SYSTEM
  ICQFUNCTION     FUNCTION    ENGLISH     *DELETED
  ICQPANELABCD    PANEL       ENGLISH      SYSTEM