Exploring CICS configurations

The following figure shows the menu options and subsequent line actions that you can use to explore a CICS® configuration hierarchy.

Figure 1. How to explore a CICS configuration hierarchy (or go directly to a list of resource definitions)
 1 
The dashed lines in this figure indicate the panels under option 4.1 Multiple Configs where you can enter the same line action next to multiple items and then view the combined results. For example:
  • To view a list panel of resource definitions from multiple CICS configurations, enter line action S next to two or more CICS configurations
  • To expand multiple lists/ResDescs or groups/ResGroups at the same time, and view a list panels of their combined contents, enter X next to two or more items.

You can also enter line actions next to multiple items under option 2 CICS Resources. However, instead of combining the results on a single panel, this option stacks the results of each line action on separate panels. To move to the next stacked panel of results, press the Exit key (F3).

 2 
The line action UNR ("unrelated") shows group/ResGroups that are not in the selected lists/ResDescs.

You can use this to help identify groups that could be redundant, because they do not belong to any of the lists specified by the CICS system initialization (SIT) parameter GRPLIST:

  1. On the primary menu, select option 4.1 Multiple Configs.
  2. Type X next to the CICS configuration that you are interested in, and then press Enter.
  3. Type UNR next to each of the lists specified by GRPLIST, and then press Enter.

You can only enter UNR next to lists/ResDescs from the same CICS configuration.

 3 
Context-based CICS configurations only: to see all of the ResGroups to which a resource definition belongs, enter REL next to a resource definition.

To expand an item and show the next level of hierarchy, enter X next to the item. Expanding a CICS configuration shows its lists (or ResDescs, for context-based CICS configurations); expanding a list shows its groups (or ResGroups); expanding a group shows its resource definitions. To step back one level, press the Exit key (F3).

To show all groups/ResGroups in a CICS configuration, including "orphans" that do not belong to any list/ResDesc, enter G next to a CICS configuration.

To show all lists/ResDescs to which a group/ResGroup belongs, enter REL next to the group/ResGroup. If you use option 4.1 Multiple Configs, then you can enter REL next to multiple groups/ResGroups (they must all belong to the same CICS configuration) to display a combined list panel of all the lists/ResDescs to which those groups/ResGroups belong.

To show all resource definitions in a list/ResDesc (that is, all of the resource definitions in the groups/ResGroups that belong to the list/ResDesc), enter XR next to a list/ResDesc. For lists (not ResDescs), the resulting list panel of resource definitions includes an Order column, indicating the order in which the resource definition groups are specified in the list.

Why is the list panel empty?

At each level of the hierarchy, a list panel appears with filter fields and column headings, but no list items. Instead, directly under the column headings is a “bottom of data” indicator. This empty list is normal: the panels do not display any list items until you press Enter. This allows you to adjust the filter before displaying the list, avoiding delays caused by listing more items than you need.

To go directly to the resource definitions in a CICS configuration, bypassing the hierarchical views:

  1. On the primary menu, select option 2 CICS Resources.

    The list of CICS configurations appears.

  2. Enter S next to the CICS configuration that you want to work with.
  3. Specify filter values for the resource definition name, type, and group.

    To list all resource definitions, specify an asterisk (*) in each of the filter fields. For details, see Filtering a list panel.

  4. Press Enter.

    The list panel displays the resource definitions that match the filter. For example:

    Figure 2. ISPF panel: list of resource definitions
       File  Settings  Help 
      
     Resources                   CCVPLEXA CICS Resources    Row 661 to 682 of 2,462 
     Command ===>                                                  Scroll ===> PAGE
     
     Filter *        TRANSACTION  +  *                             2005/01/01 00:00
     
     /      Name     Type            ResGroup Prompt               --- Changed ----
            Q064     TRANSACTION     QAAUPD01                      2005/02/15 06:48
            Q065     TRANSACTION     QAACRE01                      2005/04/13 14:06
            Q065     TRANSACTION     QAAINQR1                      2005/03/11 15:01
            Q065     TRANSACTION     QAAINQ01                      2005/01/11 22:46
            Q065     TRANSACTION     QAAUPDR1                      2005/03/11 15:23
            Q065     TRANSACTION     QAAUPD01                      2005/02/15 06:48
            Q066     TRANSACTION     QAACRE01                      2005/04/13 14:06
            Q066     TRANSACTION     QAAINQR1                      2005/03/11 15:01
            Q066     TRANSACTION     QAAINQ01                      2005/01/11 22:46
            Q066     TRANSACTION     QAAUPDR1                      2005/03/11 15:23
            Q066     TRANSACTION     QAAUPD01                      2005/03/31 14:32
            Q067     TRANSACTION     QAACRE01                      2005/04/13 14:06
            Q067     TRANSACTION     QAAINQR1                      2005/03/11 15:01
            Q067     TRANSACTION     QAAINQ01                      2005/01/11 22:46
            Q067     TRANSACTION     QAAUPDR1                      2005/03/11 15:23
            Q067     TRANSACTION     QAAUPD01                      2005/03/31 14:32
            Q068     TRANSACTION     QAAINQR1                      2005/03/11 15:01
            Q068     TRANSACTION     QAAINQ01                      2005/01/11 22:46
            Q068     TRANSACTION     QAAUPDR1                      2005/03/11 15:23
            Q068     TRANSACTION     QAAUPD01                      2005/03/31 14:32
            Q069     TRANSACTION     QAAINQR1                      2005/03/11 15:01
            Q069     TRANSACTION     QAAINQ01                      2005/01/11 22:46
      F1=Help      F3=Exit      F4=Prompt    F5=Rlocate   F6=Zoom      F7=Backward
      F8=Forward  F12=Cancel
     
    Tips:
    1. The list column headings are "point-and-shoot" fields: to sort the list by a column, select the column heading.
    2. Optionally, you can also enter a filter value above the Changed column, to limit the list panel to resource definitions that have been changed on or after a particular date. You can enter the filter value either in the same format as the values in the Changed column (yyyy/mm/dd hh:mm) or you can enter special filter values such as TODAY-1 (to show resource definitions that have been changed yesterday or today). For more details on specifying filter values for the changed date, see the online help: move the cursor to the filter field above the Changed column, and then press the Help key (F1).

    The Type column displays CSD resource types:

    CSD files and CICSPlex® SM data repositories use different names for equivalent resource definition types. For example, a PROGRAM resource definition in a CSD file is known as a PROGDEF in a CICSPlex SM data repository.

    In the ISPF dialog, the Type column on a list panel of resource definitions reflects the names used by CSD files, regardless of whether the resource definitions are stored in a CSD file or a CICSPlex SM data repository.


Information Information

Feedback


Timestamp icon Last updated: Friday, 7 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///ccv-ispf-explore-cconfig.htm