Programs view

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

The following programs are listed:

To filter the programs in the list, use the first text field in the Programs view. You can use an asterisk (*) as a wildcard.

To restrict the regions or applications from which the programs are retrieved, use the Search Region or Search Application field, using an asterisk (*) as a wildcard. To change this field between Search Region and Search Application, click the icon down arrow icon after the field name and click the required option.

To apply the filters set in these fields, press Enter.

In the following example view, the value in the filter field is LG*, and the value in the Search Region field is GE*. The view shows a list of program names that start with LG and that are in regions that start with GE.

Screen capture of the Programs view with filters applied

To see a visual representation of programs and transactions as groups, right-click the program name then click Visualization. See Resource Visualization view.

Screen capture of the pop-up menu in the Programs view

To see the properties of a program, either double-click the program name, or right-click the program name and click Show Details. See Program details view.

To see the applications, regions, transactions, or programs where a program is used, right-click the program name then click the appropriate menu option.

To see the resources that a program uses, right-click the program name then click Uses Resources.

  • For applications, if you are connected to a CICS IA Version 5.2 database, you can select whether to search across all platforms or a specific platform. To search across all platforms, click All Platforms. To search across a specific platform, click Specific Platform, then select the required platform from the resulting dialog.
  • For other resources, and applications when you are connected to an earlier version database, you can select whether to search across all regions or a specific region. To search across all regions, click All Regions. To search across a specific region, click Specific Region, then select the required CICS region from the resulting dialog.

The results of the Used by Regions and Used by Applications options are shown in the Show Resources view.

The Show resources view showing the applications using a program in all platforms.

The Used by Regions and Used by Applications options are available only in CICS IA V5.1 or later. If you are connected to an earlier version database, these options are unavailable in the CICS IA perspective. Outside the CICS IA perspective, these options are available, but attempts to fetch application data from an earlier version database results in a warning message.

Warning message: CICS IA 5.1 database or later is required to run this query.

The results of the Used by Programs and Used by Transactions options are shown in the Used By view.

The results of the Uses Resources option are shown in the Uses view.

To see the potential affinities of a program, right-click the program name then click Show Affinities By Type. See Viewing affinities.

To create a report of threadsafe issues, right-click the program name then click Threadsafe Report. See Creating a report of threadsafe issues.

You can modify a program definition by using the Program Definition Editor in the CICS SM perspective, without needing to switch to the CICS SM perspective. You must have a suitable CICS management client interface (CMCI) connection to a CICSPlex that contains the region where the program is found. For more information, see Configuring a CICS system connection.

To modify a program definition, right-click the program then click Open CICS SM Editor.

If the selected program was captured by CICS IA in more than one region, you are prompted to select a region.

Screen capture of the Select Region dialog.

The Program Definition editor opens, where you can view and update the program definitions of the selected program. For more information, see The Program Definition Editor.