Programs view

The Programs view shows an alphabetic list of all programs known to CICS® IA.

The following programs are listed:

Screen capture of the Programs view

You can filter the programs in the list using the first text field in thePrograms view. You can use an asterisk (*) as a wildcard, as shown in the following screen capture. The value *D* finds all programs with a D in the name, DSW* finds all programs starting with DSW, and D*W finds programs beginning with D and ending with W.

To restrict the list of regions from which programs are retrieved, use the Search Region text field.

The following figure shows a list of programs that are restricted to display only programs that begin with DSW and include 2, and are in regions starting with IY. You create this list by entering DSW*2* in the Programs text field, and IY* in the Search Region text field

Screen capture of the Programs view with a search value of DSW*2

To run the search on the values entered in the text fields so that you can view the list of programs, press Enter.

Right-click the program name that you want to analyze to see the resources it uses and where it is used, either across all regions or for a specific region.

Screen capture of the Programs view with a resource selected so the menu that includes Used By Programs, Used By Transaction, Show Affinities By Type, Uses Resources and Asset Details. Used By Applications is selected so another menu is displayed with All Regions and Specific Region options.

Properties for a program are divided by collection ID, for example a program in a collection. If you do not set a search scope, all entries are displayed in the properties view. When you set a collection ID as a search scope, the properties display only this collection ID. If there is no entry for this collection ID in the properties table, no data is displayed.

When you click one of the Used by ... menu items, you can select more options from a sub menu. Click All regions to start the search for all regions immediately or click Specific Region to open a dialog where you can select a specific CICS region. For example, if you click Used by Applications > All regions, the result of the search is displayed on the Show Resources view:

The Show resources view with the results of the search
If you click Used by Regions the results are also displayed in the Show resources view.

The Used by Applications commands are only available in CICS IA V5.1. If you are connected to an older database, these context menu items are disabled in the CICS IA persepctive. Outside the IA perspective, these commands are enabled, but attempts to fetch application data from an older database results in warning message:

Warning message displayed when attempting to use the Used By Applications or Used By Regions options while connected to a database release earlier than V5.1

To modify program definitions, you can use the CICS Program Definition Editor in the SM perspective, but it is not necessary to switch to the SM perspective. From the IA Programs view, right-click the program name and click Open CICS_SM Editor from the menu.

The context menu for a program
To open the editor, the CICS Management Interface connection must be active. If there is no connection, an error message is displayed:
An error message is displayed when you open the editor without an active CICS Management Interface connection.

If the selected program was captured by CICS IA in different regions, you are asked to select a region:

Region selection dialog is displayed when the program has been captured in more than one region.
If the region was found in more than one CICSPlex, you are asked to select which CICSPlex to use. If the Program definition for that program was not found, an error message is displayed.
An error message is displayed if the program definition cannot be found

For more information, see The Program Definition Editor