IBM Support

CA10: CICS Performance Analyzer for z/OS - Output to JSON Lines

Download


Abstract

SupportPac CA10 provides sample JSON Lines data output by IBM CICS Performance Analyzer for z/OS (CICS PA), and related user documentation.

Download Description

IBM CICS Performance Analyzer for z/OS (CICS PA) V5.4 with the PTF for APAR PH16158 introduces enhancements to output CICS performance and statistics data in JSON Lines format.
 
This SupportPac provides:
  1. Sample JSON Lines data output by CICS PA
  2. User documentation for the performance and statistics data enhancements 
The sample JSON Lines data can be used with the sample Splunk app for CICS PA, which is available on Splunkbase.
In addition to describing the CICS PA output to JSON Lines, the user documentation also describes corresponding enhancements to the existing output to comma-separated values (CSV) format.
Capabilities
The sample JSON Lines data provides the ability to:
  • Test the sample Splunk app, without requiring the user to forward their own data to the app
  • Test this data in the user's analytics platform of choice, without having to forward their own data
The user documentation describes how to:
  • Use CICS PA to output JSON Lines
  • Install the sample Splunk app and sample data that demonstrate using JSON Lines from CICS PA
  • Get JSON Lines from CICS PA into (i) Splunk, (ii) Elastic Stack
Possible uses
Many data analytics platforms support JSON Lines as an input format. Using CICS PA to output CICS performance and statistics data in JSON Lines format expands the opportunities for analyzing this data.
Modern transaction processing environments are often heterogeneous; a single transaction can involve processing across multiple systems, on and off the mainframe. Making CICS performance and statistics data available in a platform-independent format, such as JSON Lines, makes it easier to analyze this data alongside data from other, non-mainframe, systems. Therefore, enabling more integrated analysis of the overall transaction lifecycle.

Skill level required
  • To use CICS PA to output JSON Lines, users will need to understand how to use the CICS PA Interactive System Productivity Facility (ISPF) dialog.
  • To use the sample data an understanding of the JSON Lines format is required, together with how to use a data analytics platform of choice, such as Splunk or Elastic Stack.
  • To try out the sample Splunk app, users do not need to understand how to use CICS PA. Detailed step-by-step information is provided, in the supplied documentation, on how to install the sample Splunk app.

Details
Author: Rocket Software Inc, in collaboration with IBM CICS Development, Hursley, UK.
Category: 2
Released: 06Mar20
Current Version: 1.0
 

Prerequisites

The following minimum prerequisites are required to use this SupportPac: 
  • A data analytics platform to analyze JSON Lines data from CICS PA. Splunk users can use the sample Splunk app for CICS PA.
  • CICS PA V5.4 with the PTF for APAR PH16158. This PTF enhances CICS PA to output data in JSON Lines format.
The sample data in this SupportPac can be used with the sample Splunk app for CICS PA, without specifically requiring CICS PA. For this use-case, the only prerequisite is Splunk. Further details on this use-case are in the supplied documentation, in the section headed by text that begins with "Splunk app". Note that the sample data can be used in any data analytics platform of choice; the sample data is not restricted for use only with Splunk.

Installation Instructions

To download the files provided by this SupportPac click the links below.
Details on how to use this SupportPac are provided in the supplied PDF documentation.
Important: To view the sample data in the sample Splunk app for CICS PA, set the time range in the app dashboards to "Presets > Other > All time". Otherwise, the default time range of the dashboards (i.e. "Last 24 hours") will not show the sample data.

[{"INLabel":"CICS PA V5.4 - Output to JSON Lines user documentation","INLang":"US English","INSize":"805668 B","INURL":"https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/cicspa_apar_ph16158_user_doc.1.0.0.pdf"}]
Off
[{"DNLabel":"CICS PA V5.4 sample data in JSON Lines format","DNDate":"02 Mar 2020","DNLang":"US English","DNSize":"1576732 B","DNPlat":{"label":"z/OS","code":"PF035"},"DNURL":"https://www14.software.ibm.com/cgi-bin/weblap/lap.pl?popup=Y&li_formnum=L-ACRR-BL5F4L&accepted_url=https://public.dhe.ibm.com/software/htp/cics/support/supportpacs/individual/ca10_cicspa_json_lines_sample_data.1.0.0.zip","DNURL_FTP":"","DDURL":null}]

Technical Support

SupportPacs in this category are available at no charge and provided "AS-IS", under the terms and conditions of the IBM International License Agreement for Non-Warranted Programs and of the associated License Information and other documentation. The terms and conditions of this license DO NOT provide for any entitlement to defect correction.

To determine if you want to use this SupportPac, read the accompanying license agreement.

Other CICS SupportPacs
Other SupportPacs are available for the CICS portfolio of products. Visit the CICS SupportPacs Home Page.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSPPU4","label":"CICS Performance Analyzer for z\/OS"},"Component":"SupportPac","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB17","label":"Mainframe TPS"}}]

Product Synonym

CICS PA/CICS Performance Analyzer

Document Information

Modified date:
03 March 2020

UID

ibm11282648