What's new in the CICS IA Version 5.2 plug-in

Enhancements to the CICS® IA Version 5.2 plug-in.

New Function Description
CICS TS platform support

In CICS TS Version 5.1 and later, you can package applications for deployment into a platform. CICS IA now captures platform information and associates it with dependency data.

A new Cloud Explorer view is provided to show applications grouped by platform. This view shows applications defined in CICS TS Version 5.1 and later. If you are connected to a CICS IA Version 5.2 database, applications are grouped by platform and you can use the menu options to analyze the platform further.

The Applications view is changed to show only a list of IA applications used before CICS TS Version 5.1 and collected by using CICS IA Version 3.2 or earlier.

In the Program and Transaction views, if you are connected to a CICS IA Version 5.2 database, the Used by Applications option now provides the option to search across all platforms or a specified platform.

In the CICS IA Query editor, for CICS, DB2®, IMS™, MQ, and Natural queries, you can now group and filter query results by platform.

In the Resource Visualization view, if you are connected to a CICS IA Version 5.2 database, by default, the resources are grouped by platforms, and then by applications.

In the Resource Connections view, if you are connected to a CICS IA Version 5.2 database, you can group resources by platform by using the Show Filters icon.

Logging SQL queries

You can now log all the SQL queries that are issued by the plug-in, and view details of those queries for debug purposes.

A new Database Retrieval Debug pane is provided in the Preferences window to start or stop logging the SQL queries that are issued by the plug-in, and to open the DB Retrieval Debug view.

A new DB Retrieval Debug view is provided to show details of the SQL queries that are issued by the plug-in. You can view the query text, the time when the query was issued, and the ID of the process thread that executed the query. You can use this view to start or stop logging the SQL queries, and to clear the table of entries in the view.

Program details view

A new Program details view is provided to show the properties of a program. Depending on the information that is available for the program, the view shows the general properties, Load Module Scanner properties, and CSECT Scanner properties. The Load Module Scanner information includes whether the program is reenterable.

Creating affinity reports

You can create an affinity report for one or more regions, for one or more affinity types. A new Create Affinity Report wizard is provided.

A new menu option, Report > Affinity Report is provided in the Regions view.

A new icon, New Affinity report, is provided in the Report Explorer view.

The Report Explorer view now shows the generated affinity report files.

A new Affinity Report view is provided to show the contents of a generated affinity report on tabbed pages.

The Report Browser view now shows the contents of a generated affinity report on a single page.

Building CICSPlex® SM Workload Manager transaction group files

You can build a CICSPlex SM Workload Manager (WLM) transaction group file. The file is built from one or more affinity reports and contains affinity-transaction-group definitions that are suitable for input to CICSPlex SM. A new Build CPSM WLM Transaction Groups wizard is provided.

A new icon and menu option, Build CPSM WLM Transaction Groups, is provided in the Report Explorer view.

A new Affinity Build view is provided, where you can view and edit the contents of a generated CICSPlex SM WLM transaction group file.

The Report Explorer view now shows the saved CICSPlex SM WLM transaction group files.

Deploying transaction group definitions to CICSPlex SM

You can deploy the transaction group definitions in a CICSPlex SM WLM transaction group file to a CICSplex. You can save the transaction group definitions in the CICSPlex SM WLM transaction group file to a data set member, and submit a job for CICSPlex SM deployment.

A new CPSM Deployment pane is provided in the Preferences window, where you can set the default values to use to generate JCL for deployment to CICSPlex SM.

You can use the new Affinity Build view to specify parameters for the CICSPlex SM deployment job, modify the input to CICSPlex SM, review and edit the generated JCL, and deploy the transaction group definitions.

Command flow diagram view

A Command Flow Diagram view is provided to show 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 following new menu options are provided for tasks in a command flow run in the Show Resources view and the User Command Flow view:
  • Visualization > Application Switches
  • Visualization > Region Switches
  • Visualization > TCB Switches
Printing diagrams

In views that display a diagram, when the view is active, you can print that diagram by using the Print icon in the CICS IA perspective toolbar. This function applies to the Command Flow Diagram, Resource Connections, and Resource Visualization views.

Enhancements to existing functionality Description
No connection option on Dependencies menu

Integration with CICS Explorer® is provided through a Dependencies menu that is available in CICS Explorer views for operational resources and definitions that are supported by CICS IA.

This Dependencies menu now shows a dimmed No connection option if the CICS IA plug-in is not connected to the DB2 database.

Query editor

When you create or edit a CICS query in the Query editor, you can now filter that query by one or more CPSM commands, and by the following new resource types: ACTION, CONTEXT, NOTIFICATION, OBJECT, RESULT, THREAD, and VERSION.

When you create or edit a Command Flow query in the Query editor, the following new attributes are available to show or filter by:
  • APPLID taken from the origin descriptor associated with this task
  • Originating adapter data 1
  • Originating adapter data 2
  • Originating adapter data 3
  • Originating adapter ID
  • Originating client IP address
  • Originating client IP address format
  • Originating facility name
  • Originating facility type
  • Originating network ID 1
  • Originating network ID 2
  • Originating task
  • Originating task start time
  • Originating TCP/IP stack port number
  • Originating transaction ID
  • Originating user ID
  • Originating VTAM LU name
  • Previous Hop APPLID
  • Previous Hop count
  • Previous Hop NETWORKID
  • Previous Hop task ID
  • Previous Hop task start time
  • Previous Hop transaction ID
  • The time the task on the previous hop started
Command Flow view
When you specify which information is shown in the command flow table in this view by using the Customize Columns window, you can now specify the following new columns:
  • APPLID taken from the origin descriptor associated with this task
  • Originating adapter data 1
  • Originating adapter data 2
  • Originating adapter data 3
  • Originating adapter ID
  • Originating client IP address
  • Originating client IP address format
  • Originating facility name
  • Originating facility type
  • Originating network ID 1
  • Originating network ID 2
  • Originating task
  • Originating task start time
  • Originating TCP/IP stack port number
  • Originating transaction ID
  • Originating user ID
  • Originating VTAM LU name
  • Previous Hop APPLID
  • Previous Hop count
  • Previous Hop NETWORKID
  • Previous Hop task ID
  • Previous Hop task start time
  • Previous Hop transaction ID
  • The time the task on the previous hop started
Command flow editor

When you edit the command flow collector options for your currently connected user ID, the Command Flow Editor now shows the value of the Authority option.

Properties view for a collector

When you select a region or a user in the IA Operations view to display the properties of the selected collector in the Properties view, this view now shows the value of the Authority option.

Enhanced threadsafe analysis
When you create a report of threadsafe issues in the Report view, the threadsafe report now shows whether a program is linked as reentrant. The report also shows the following additional information about CICSPlex System Manager (CPSM) commands:
  • Total CPSM Calls
  • Threadsafe CPSM Calls
  • Non-threadsafe CPSM Calls

When you save a threadsafe report, this information is also saved and you can view it in the Report Browser view.

Report Explorer view

You can now use the Report Explorer view to create affinity reports, build CICSPlex SM WLM transaction group files for input to CICSPlex SM, and manage the saved affinity reports and files.

The Open report menu option in the Report Explorer view now opens the currently selected report or file in the appropriate view:
  • For an affinity report, open the Affinity Report view.
  • For a CICSPlex SM WLM transaction group file, open the Affinity Build view.
  • For a threadsafe report, open the Report Browser view.

A new menu option, Open in Browser, is provided to open the currently selected affinity report in the Report Browser view.