Introduction
CICS Interdependency Analyzer Extension for Zowe Explorer adds additional functionality to the popular VS Code extension, Zowe Explorer. This extension allows users to interact and visualize CICS resources like Regions, Programs, Transactions and Webservices.
CICS IA tool helps with runtime data collection for CICS Application. The CICS IA VS Code extension visualizes the collected data in the form meaningful to the user.
Contents
Privacy Notice for feedback
CICS Interdependency Analyzer Extension is provided free of charge, but we ask you to provide us feedback via the various means available, such as submitting an issue in our GitHub repository, submitting review comments in the VS Code Marketplace.
You can also read IBM's General Privacy Statement to learn more about our policies.
Software Requirements
Ensure that you meet the following prerequisites before you use the extension:
CICS IA Features
- Load profiles directly from ZOWE CICS VS code extension.
- Create new or Update existing Zowe CICS IA profiles and connect to them.
- Identify Collection IDs for which dependency or affinity data has been collected under a CICS IA profile.
- For every Collection ID, displays tree hierarchy of CICS resources like Regions, Programs, Transactions and Webservices.
- Filter and display the Programs, Transactions or web services used in a selected region.
- For every Transaction, Program or web service, you can view where it is used, regions associated with it and what resources it uses.
- View the tasks in a transaction.
- View the properties of a Program.
- Analyse the interdependencies between CICS Resources.
- Create and view summary or detail report of Threadsafe issues for a specific Program or Transaction or Region.
- Analyse the Transaction and system Affinities from a Transaction or Programs and also lists the details about Program, transaction and Command causing the affinities.
- View the execution details and timeline of Commands Collected by Command flow collector for a selected task.
To Install CICS Extension for Zowe Explorer see Installation
Installation
Users can install Zowe Explorer CICS IA Extension from a VSIX file.
Execute the following steps to install the extension:
Download cics-ia-extension-for-zowe.vsix file to your PC.
Open VS Code and Click on the Extensions icon in the side bar.
Click on the icon and select the Install from VSIX… option..
Browse the VSIX file location.
Select the vsix file and click the Install button
NOTE: The installation process will take a few seconds to complete.
The "Completed installing Zowe Explorer for IBM CICS Interdependency Analyzer" message appears at the bottom right after successful installation.
The CICS IA node appears in the primary sidebar of the Zowe extension activity bar in VS Code
Getting Started
Follow the steps below to configure Zowe CICS IA Explorer.
- Loading the CICS IA Profiles from CICS Profiles
- Create a New CICS IA Profile
- Update CICS IA Profile
Loading CICS IA profiles from CICS profiles
By Default, CICS profiles from CICS VS Code extension is loaded into CICS IA View.
Below is the Configuration screen for creating a new CICS profile.
After Creating a new CICS Profile refresh CICS IA view, we should be able to see the newly created CICS profile getting loaded automatically under CICS IA view as well.
The CICS IA tree view should show all the CICS profiles created in CICS Extension
*NOTE: If the CICS connection is failing with red indicator icon then that CICS profile should fail in the CICS IA view also.
Create New CICS IA Profile
Click on the ‘+’ icon next to existing CICS IA profile and in editor window a panel opens. Provide the Hostname, Port, and Protocol of server where IA Rest APIs are running.
Click on the Update Profile button.
Once the IA profile is created, CICS IA view will start loading the data from the DB Schema (Schema details are configured on Rest API WebSphere server running on mainframe) and creates the tree hierarchy inside the CICS IA Profile.
Update CICS IA Profile
Click on the yellow highlighted icon and in right side editor window a panel opens with existing profile details. Update the details that you want to alter.
Click on the Update Profile button.
Once the IA profile is updated, again CICS IA view will start loading the data from the DB Schema (Schema details are configured on Rest API WebSphere server running on mainframe) and refreshes the tree hierarchy inside the updated CICS IA Profile.
CICS IA Profile
CICS IA profile upon successful connection displays Green indicator icon over the profile name. If connection not successful, then displays Red indicator icon over the profile name. CICS IA profile on Successful connection extracts the Collected Dependency and Affinity data from the DB2 Schema to which REST API is configured. When CICS IA profile node is expanded, below child items are listed.
Collection IDs: Collected data has been grouped under Collection IDs and is used for analysing the collected data. For more information, See Collection IDs.
User Command Flow: Displays the Command flow runs sorted by User ID. For more information, See User Command Flow.
Reports: Displays the Threadsafe reports which have been generated for a Region, Program or transaction. For more information, See Reports.
Collection IDs
The Collection IDs are the collection identifiers for which dependency or affinity data has been collected by CICS IA tool and loaded into DB2.
Hover over the Side bar and expand the CICS IA profile node. List of Collection ID tree items would be displayed under the CICS IA profile tree node. Select the Collection ID that you want to explore.
On expanding a desired collection ID tree node, four child items – Regions, Web Services, Transactions, Programs will be displayed for the selected collection ID.
- Regions View: Lists the CICS regions for which data has been collected under the selected Collection ID. For more information, see REGIONS.
- Web services view: Lists the web services known to the selected Collection ID.** For more information, see WEB SERVICES
- Transactions view: Lists the Transactions known to the selected Collection ID.** For more information, see TRANSACTIONS.
- Programs View: Lists the Programs known to the selected Collection ID.** For more information, see PROGRAMS.
Regions
CICS® region information that is collected by CICS IA is displayed when you expand Regions node under a Collection ID. Next to Regions text within brackets, a count of the regions used in the selected collection ID is displayed.
Expand Regions node**.** Right-click the region that you want to explore and choose an option from the menu. Use the menu to display more information about the selected region.
The following menu options are available:
Show Resources. Displays all the resources for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Show Maps. Displays the MAP resource types for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Show Files. Displays the FILE resource types for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Show Temporary Storage. Displays the TSQUEUE resource types for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Show Transient Data. Displays the TDQUEUE resource types for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Program for API enablement. Displays programs that don't have presentation logic and are suitable candidates for being exposed as an API for the selected region in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Report > Threadsafe Report. Create a report of threadsafe issues for the programs in the selected region and display report in the Reports "To create affinity reports, and build files of CICSPlex SM Workload Manager (WLM) transaction groups for input to CICSPlex SM expand Reports in the IA Navigation view. You can also manage saved affinity reports, threadsafe reports, and transaction group files ". You can select whether to generate report across all regions or a specific region. To generate report across all regions, click All Regions in the submenu. To generate report across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
Transactions Used. Filters and Displays the transactions that are used in the selected region in the Transactions node. And region for which Transactions are filtered is appended to the Transaction Node. To remove this filter, Click on the Resource filter icon displayed at the end of Transaction node.
Programs Used. Filters and Displays the programs that are used in the selected region in the Programs "The Programs view shows an alphabetical list of all programs known to CICS IA." Node. And region for which Programs are filtered is appended to the Program Node. To remove this filter, Click on the Resource filter icon displayed at the end of Program node.
Web Services Used. Filters and Displays the web services that are used in the selected region in the Web Services "The Web Services view displays an alphabetic list of all web services known to CICS IA, both inbound and outbound." node. And region for which Web Services are filtered is appended to the Web Service Node. To remove this filter, Click on the Resource filter icon displayed at the end of Web Services node.
Webservices
The Web Services node displays an alphabetic list of all web services known to CICS® IA Collection ID, both inbound and outbound. Next to Web Services text within brackets, a count of the web services used in the selected collection ID is displayed.
Right-click the web service that you want to analyze to see the resources that it uses and where it is used, either across all regions or for a specific region.
For an inbound web service, you can see the resources that it uses. For an outbound web service, you can see where it was invoked by transaction or program.
Expand Web Services node**.** Right-click the web service that you want to explore and choose an option from the menu. Use the menu to display more information about the selected webservice.
The following menu options are available:
- Used by applications. Displays the applications where selected web service is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all platforms or a specific platform. To search across all platforms, click All Platforms from Sub Menu. To search across a specific platform, click Specific Platform from Sub Menu, then select the required platform displayed below the search bar.
- Used by Programs. Displays the programs where selected web service is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Used by Transactions. Displays the transactions where selected web service is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Used by Region. Displays the regions where selected web service is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
- Uses Resources. Display all the resources used by the selected web Service in the Uses view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
Transactions
The Transactions Node shows an alphabetical list of all transactions known to CICS® IA Collection ID. Next to Transactions text within brackets, a count of the transactions used in the selected collection ID is displayed.
The list of transactions includes the transactions in which programs are running and transactions that are the results of interactions; that is, they are CICS resources of type TRANSID.
Expand Transactions node**.** Right-click the Transaction that you want to explore and choose an option from the menu. Use the menu to display more information about the selected Transaction.
The following menu options are available:
Used by applications. Displays the applications where selected Transaction is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all platforms or a specific platform. To search across all platforms, click All Platforms from Sub Menu. To search across a specific platform, click Specific Platform from Sub Menu, then select the required platform from the list displayed below the search bar.
Used by Programs. Displays the programs where selected Transaction is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
Used by Transactions. Displays the transactions where selected Transaction is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
Used by Region. Displays the regions where selected Transaction is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Uses Resources. Displays all the resources used by the selected Transaction in the Uses view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
Show Tasks. Displays all the tasks in the selected Transaction. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
Show Affinities By Type. Select an affinity group type from the submenu to display the resources for the selected Transaction that have potential affinities in the Affinities view.
Threadsafe Report. Used to create a report of threadsafe issues for the selected Transaction. Threadsafe report will be saved under the REPORTS section of CICS IA profile. You can select whether to generate report across all regions or a specific region. To generate report across all regions, click All Regions in the submenu. To generate across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar. See Creating a report of threadsafe issues for more information.
Programs
The Programs node shows an alphabetical list of all programs known to CICS® IA Collection ID. Next to Programs text within brackets, a count of the Programs used in selected collection ID is displayed.
The list of Programs include:
- Programs that are the sources of interactions
- Programs that make calls into CICS
- Programs that are the results of interactions
- Programs that are CICS resources of type PROGRAM
Expand Programs node**.** Right-click the Program that you want to explore and choose an option from the menu. Use the menu to display more information about the selected Program.
The following menu options are available:
- Used by applications. Displays the applications where selected Program is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Used by Programs. Displays the programs where selected Program is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Used by Transactions. Displays the transactions where selected Program is being used. The results are shown in the Used By View. "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Used by Region. Displays the regions where selected Program is being used. The results are shown in the Show Resources view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.".
- Uses Resources. Displays all the resources used by the selected Program in the Uses view "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view.". You can select whether to search across all regions or a specific region. You can select whether to search across all regions or a specific region. To search across all regions, click All Regions in the submenu. To search across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar.
- Show Details. Displays the properties of the selected Program. The results are shown in the Program "The Show Resources view displays resources from a number of sources, including searches run from the toolbar, from the Queries view, and from the Regions view." Details View.
- Show Affinities By Type. Select an affinity group type from the submenu to display the resources for the selected region that have potential affinities in the Affinities view.
- Threadsafe Report. Used to create a report of threadsafe issues for the selected Program. Threadsafe report will be saved under the REPORTS section of CICS IA profile. You can select whether to generate report across all regions or a specific region. To generate report across all regions, click All Regions in the submenu. To generate across a specific region, click Specific Region from the submenu, then select the required CICS region from the list displayed below the search bar. See Creating a report of threadsafe issues for more information.
User Command Flow
When you expand User Command Flow Node under CICS IA profile tree Hierarchy, it displays a list of command flow runs which are sorted by user ID.
Hover over the Side bar and expand the CICS IA profile node. Expand the USER COMMAND FLOW node to view the USER IDs for which CICS IA collected command flow data.
To view a command flow that was run by a user, expand the required user ID. You can then expand the command flow to display further information. The time of the first command that is issued, and the transaction task ID are displayed. Before any transaction or program resource can be visualized from the User Command Flow Execution, interdependency data must first be collected for the transaction and loaded into the DB2 table.
User Command Flow Menu
Right-click on a transaction task ID and use the following menu options to show more information about a task in a command flow run:
- Show Execution. Display the execution details of the selected task in the Command Flow view "The Command Flow view shows the execution details of a selected task. It shows the Task Control Block (TCB) modes that were used, any TCB mode switches, and a command flow table.".
- Visualization. Then, select from below options to display the command flow diagram for the selected transaction in the Command Flow Diagram view "The Command Flow Diagram view shows a timeline of the commands that the Command Flow Collector has collected. Commands are grouped by program, then displayed in rows or columns that represent the different platforms and applications, regions, or Task Control B".
- Application Switches. Display the programs in rows or columns that represent the program and applications, with arrows to show the switches.
- Region Switches. Display the programs in rows or columns that represent the regions, with arrows to show the switches.
Reports
You can expand Reports node under CICS IA profile tree Hierarchy for the following functions:
- Open, a saved report or file.
Hover over the Side bar and expand the CICS IA profile. Expand the REPORTS node to view saved Threadsafe reports.
Use the menus in Reports to manage the folders and reports. Right-click the report, or file that you require and choose one of the following options from the menu:
- Open report. Open the currently selected report or file in the appropriate view:
- For a threadsafe report, open the Threadsafe Report view. See Threadsafe Report view. "Use the Threadsafe Report view to view or create summary or detailed reports of threadsafe issues in HTML format."
- Open in Browser. Open the currently selected threadsafe report in the Report Browser view. See Report Browser view "Use the Report Browser view to view the contents of saved affinity or threadsafe reports.".
Program details view
The Program Details view shows the properties of a program in CICS® IA.
To see the properties of a program, Select a program displayed under the Programs node. Right-click the program name and click Show Details.
Editor Window shows the Program details view with the program name as the title.
This view lists the program attributes, with a column for each region where the program is used. Attributes are organized into groups, and you can expand or collapse those groups.
Show Resources view
The Show Resources view displays resources for a selected Region or Transaction or Program or Web Service.
Resources are organized into a tree structure. The following screen shows the results for MAP resources for selected region.
Header of this view displays the region for which resources are displayed. Also displays a count of the selected resource type.
Below the header, a toolbar is displayed with tools for
Expand all the resources in the view.
Collapse all resources in the view.
You can recall the results of previous searches, and move between searches, by using the Previous search and Next search icons in the toolbar of the view.
Used By view
From Region, transaction or program or web service node where a resource is available, you can view the programs or the transactions or the web service that are using the resource and the associated regions.
Use the Used By menu options to show the regions in which the program or transaction is being used. You can analyze the use of each program or transaction or web service across all regions or specific regions.
If you select one of the options in the Used By menu, information is displayed in the Used By view:
The use tree of the resource is shown in the Used By view. The previous screen capture shows the uses of the program HCLMENU1.
Header of this view displays the resource currently being analyzed and whether analysis is for all regions or for a specific region. Header also provides a count of resources (Program/Transaction) using selected Program/Transaction/Webservice.
Below the header, a toolbar is displayed with tools for
Expand all the resources in the view.
Collapse all resources in the view.
You can recall the results of previous searches, and move between searches, by using the Previous search and Next search icons in the toolbar of the view.
Uses view
From transaction or program or web service node, you can explore resources further to see which resources the transaction or program or webservice is using and in which regions.
To show the regions in which the program or transaction or webservice resource is being used, right-click the resource, then click Uses Resources. You can specify whether to analyze use for a specific region, or for all regions.
The information about the selected resource and region populates the Uses view in the Editor window.
Select Uses Resources > Specific Region to display the resources used in that region.
The Uses view has three sections:
- The Left Pane displays the list of resources used by selected Program/Transaction/Webservice organized into folders by Resource Type. If you expand a resource Type folder by clicking , you can view the resources using the specific resource type. If we expand resource further by clicking ,, you can view the verb nodes that were executed against the resource.
- In the above example on expanding Program Resource Type folder, we get to see 2 Programs TESTPGM and TESTPGM2. On expanding TESTPGM2 resource, we could see that the program TESTPGM2 resource was executed using 2 commands LINK and LOAD.
- The Middle Pane displays Program/Transaction in which the selected resource is invoked.
- The right Pane displays tree hierarchy for the resource usage grouped by Regions.
Affinities view
The Affinities view displays an alphabetical list of resources with potential affinities related to the target object.
CICS® transactions and programs use some techniques to exchange data that require those transactions or programs to run in the same CICS region, or in a specific CICS region. The result of such requirements is restrictions on the regions to which transactions and distributed program link (DPL) requests can be dynamically routed. If transactions or programs exchange data in ways that impose such restrictions, these are known as affinities between them.
The affinity-related functions of CICS IA have the following uses:
- Users of CICS dynamic routing can determine whether any transactions in their CICS applications have an inter-transaction affinity (some transactions must run in the same region) or a transaction-system affinity (some transactions must run in a specific region).
- Application programmers can detect whether a program being developed might cause transaction affinities.
Right-click the item that you want to view the affinities for and click Show Affinities By Type. The Show Affinities By Type menu is linked to the type of object that is currently selected, rather than the view the object is in. You can also right-click an item in the Programs or Transactions node to display the affinities menu items.
The Affinities view includes 2 sections.
- The upper section displays either,
- Affinity Group or
- Resource, the affinity relation type, Lifetime of affinity or
- Affinity relation type, Lifetime of affinity
- Upon selection of an item in the upper section, the lower section displays the Transaction, Program and Command resulting in the selected affinity type.
Threadsafe Report view
Use the Threadsafe Report view to view summary or detailed reports of threadsafe issues in HTML format.
For information about creating threadsafe reports, see Creating a report of threadsafe issues.
The Threadsafe Report view includes the following sections:
- Program summary section.
- Program details section.
Program Summary
The upper section of the Threadsafe Report view displays the program summary information. The programs are grouped by the collection IDs and regions. You can expand the tree structure to display the programs and statistics for threadsafe, non threadsafe, indeterminate threadsafe, threadsafe inhibitor, and other calls issued by each program. To show program details, click the program name.
In the Reentrant column, Y indicates that the program is reentrant, a blank indicates that the program is not reentrant, and ? indicates that the reentrant status is not known.
Program Details
The lower section of the Threadsafe Report view displays detailed information about each command for the currently selected program in the report summary. This view displays the Command Type, Function, Resource Type, Object, Offset at which the command is located, Use count for the command, Threadsafe status, threadsafe inhibitor status for each command in the selected program.
Command Flow view
The Command Flow view shows the execution details of a selected task. It shows the Task Control Block (TCB) modes that were used, any TCB mode switches, and a command flow table.")
The Command Flow view shows the execution details of a selected task. It shows the Task Control Block (TCB) modes that were used, any TCB mode switches, and a command flow table.
The Command Flow view has three sections: TCB Modes Used, TCB Mode Switches, and the command flow table.
TCB Modes Used
The TCB Modes Used section displays a summary of the TCB modes that were used during the execution of the task, including the total number of commands issued in each TCB mode.
To see the individual commands and resources, expand the tree structure.
If you select a command in this section, the command is highlighted in the command flow table.
TCB Mode Switches
The TCB Mode Switches section displays a summary of any TCB mode switches that occurred during the execution of the task. Commands and resources are grouped by the mode that they switched from, then the mode that they switched to.
To see the mode that is switched to, and individual commands and resources, expand the tree structure.
If you select a command in this section, the command is highlighted in the command flow table.
Command flow table
The command flow table displays the command flows, ordered by time, under the program that ran the command. By default, the current and previous TCB Mode, and the time when the command ran, are shown for each command.
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 icon for a resource can have the following icons attached:
- Event processing icon. You can create an event binding, to use with event processing, from this resource. This option is available only for resources and API calls that match valid event processing resources.
- TCB mode switch icon. The command caused a TCB mode switch to occur.
- Warning icon. The command has a nonzero RESP or RESP2 code.
Command Flow Diagram view
The Command Flow Diagram view shows a timeline of the commands that the Command Flow Collector has collected. Commands are grouped by program, then displayed in rows or columns that represent the different platforms and applications, regions, or Task Control Block (TCB) modes that were used.
The Command Flow Diagram view shows all the commands that the Command Flow Collector has collected. Commands are grouped by program, then displayed both chronologically and in rows or columns that represent the different platforms and applications, regions, or Task Control Block (TCB) modes that were used. Application, Region, or TCB mode switches are shown by arrows.
By default, the different platforms and applications, regions, or Task Control Block (TCB) modes that were used are shown in rows. To show this use in columns, use the Vertical Orientation icon in the toolbar of the view. When in Vertical orientation to show this use in rows, use the Horizontal Orientation icon in the toolbar of the view.
The following example is a command flow diagram in horizontal orientation that shows Application/ Platform switches.
The following example is a command flow diagram in vertical orientation that shows platform and application switches.
Report Browser view
Use the Report Browser view to view the contents of saved threadsafe reports.
To view a saved report in the Report Browser view, start from the Report node under CICS IA Profile.
Hover Over the side bar and expand the CICS IA profile.
Expand the REPORTS Node.
Navigate to the folder where the saved Threadsafe report exists.
Right click a threadsafe report and select Open Report in Browser.
For information about creating reports, see Creating a report of threadsafe issues.
The following figure shows part of an example threadsafe report in the Report Browser view.
Creating a report of threadsafe issues
You can create summary or detailed reports of threadsafe issues in HTML format. To create a threadsafe report, you can use a region, program, or transaction for which you require a report.
To generate a report of threadsafe issues for a region, program, or transaction, you can select the required region, program, or transaction, then request a report for the selected region, program, or transaction. The report can then be opened from the Reports node.
Procedure
- To create a report for a specified region from the Regions Node, Expand the Collection ID and then Regions Node, right-click the region for which you want a threadsafe report, then click Report > Threadsafe Report.
- To create a report for a specified program or transaction, use the following procedure:
- Expand the Collection ID and then the program or transaction node, right-click the program or transaction for which you want a threadsafe report and click Threadsafe report.
- To generate a report for all regions, click All Regions. To generate report for a specific region, click Specific Region, select the required region from the list displayed under search bar
The wizard for creating the Threadsafe Report appears. Follow the wizard to create and save the threadsafe report.
In the first page of the wizard, provide values to the following fields to define the scope of the report.
CICS TS level to report on only the commands that are available in the specified CICS® TS release.
Collection ID to report on programs that were collected with the specified collection ID. You can use a single asterisk character (*) as a wildcard.
Region to report on programs that were collected in the specified CICS region. You can use a single asterisk character (*) as a wildcard. If you set the CICS TS level in this field, the report displays the threadsafe information for programs in regions that are at that CICS release.
Program or Transaction to report on commands collected for the named program or transaction. You can use a single asterisk character (*) as a wildcard.
Show detailed data checkbox used to include details information in the threadsafe report. If not checked then summary threadsafe report will be generated.
In the next page, select a folder to store the report, enter a name for the report in the Text box and click on Finish button to generate the report.
The generated report appears under the REPORTS node of the CICS IA profile. Refer Reports section to know how to view the threadsafe report.