Uses View

From any view where a transaction or program is shown in the CICS® IA plug-in, you can explore resources further to see which resources the transaction is using and in which regions.

Use the menu option Uses Resources to show the regions in which the program or transaction resource is being used. You can specify whether you want to analyze use for a specific region, or for all regions.

Screen capture that shows the Show Resources view with the Asset details menu and highlighting Uses Resources which displays All Regions and Specific region
The information about the selected resource and region populates the Uses view.

Select Uses Resources > Specific Region to display the resources used in that region. For each file resource, the file control commands are listed with their function ship data, REMOTE SYSID and REMOTE NAME.
Resources view showing the REMOTE SYSID and REMOTE NAME displayed with the file control commands.
Note: The REMOTE SYSID and REMOTE NAME are not displayed when you select Uses resource > All regions.

When you select Uses Resources > command, all of the resources are displayed that are used by this program in addition to all of the programs that were loaded from it. The tree of regions shows the resources that were in use by the originating program, and also by the others. When you click the resource the table displays what programs are using it, and the originating program might not be in this list.

A screen capture of the Uses view that shows a program selected and the populated By Resource pane.
In the previous screen capture the Program TST4CVD2 called TST4CVD3 which was using the Temporary Storage resource.

The program or transaction uses are shown in the Resources used pane organized into folders by type.

You can use the Group by Verb button The group by Verb button to sort the information in the Resources Used pane.

You can sort the results by resource (by default), so each resource node contains all the verbs that were executed against it:

Screen capture of the results in the Resources Used pane sorted by resource
You can also sort the results by verb, which have an arrow icon next to them, so each verb node contains all the Resources that were used by it:
Screen capture of the results in the Resources Used pane sorted by Verb
Verbs in this context are the EXEC CICS commands issued from the CICS API.

The run hierarchy for the current program or transaction starts is shown in the pane.

When you select a resource, the By Resource pane is populated with information about the programs and transactions that use the resource.

When a resource is selected, you can select the points in the run hierarchy where the resource is used, using the up Yellow upward arrow and down Yellow downward arrow arrow buttons.

Screen capture showing yellow downward arrow function Get next item in execution tree
Screen capture showing yellow upward arrow function Get previous item in execution tree

When you select a program in the Resources Used pane, the hierarchy shows the first resource in the tree that uses the program.

Screen capture of programs using the resource selected in the Resources Used panel

If you navigate down the tree using the arrow buttons, you reach the next resource that uses the same program.

Screen capture of programs using the resource selected in the Resources Used panel

Creating an Event Processing Capture Specification

You can use the Uses Resources information to create a capture specification to be used with Event Processing:

  1. Right-click on a resource with the asterisk icon in the Uses view.
  2. Select Create Event and select the type of event that you want to create. The Create Event Binding from a CICS resource wizard opens. You can select this only for resources and API calls that match valid EP resources.
Note: You must have a CICS event bundle previously created.

Events associated with EXEC CICS commands

Events associated with EXEC CICS commands are displayed as child nodes of the command in the view. These child nodes are the events that are triggered against a command. The program used by this event is displayed in the Uses view.

Screen capture of events in Uses view