Release Notes

Strobe and iStrobe 5.2

April 12, 2017

These Release Notes cover both Strobe and iStrobe. Use the following navigational links to access the contents:

  Latest Release Notes

  What’s New

  Software and Hardware Requirements

  Discontinued Support

  Technical Notes

  Product Documentation

  Support Resources

Latest Release Notes

For the most current version of these Release Notes , go to Compuware Go, Compuware's customer support website. The first time you access Compuware Go, you are required to register and obtain a password. After logging onto Compuware Go, select your product from the drop-down list and click Go. Below the product name at the top of the page, click the Documentation link. You will find the latest Release Notes listed with the other product documentation.


What’s New

With Strobe 5.2 and iStrobe 5.2, Compuware continues to evolve the next generation of Application Performance Management (APM) on z/OS. The purpose of our next generation solution is to enable our customers to proactively identify, understand, and act upon emerging performance problems in order to be successful in achieving their APM goals.

Common ISPF Dialog for SMP/E Installation Using RFN

The Receive From Network (RFN) installation procedure introduced with Release 5.1 has been enhanced with a common ISPF dialog for Release 5.2. The new Compuware Installer dialog lets installers SMP/E install all products received in a single order if desired. The Compuware Installer Mainframe Products SMP/E Installation Guide is attached to the order email.

New Insight Soft Cap Reports

Strobe Insight now includes a soft cap peak time report that customers can use to identify and control soft cap CPU charges. Using SMF data collected throughout the month, Insight identifies the peak period and exactly what was executing during the peak period. Because priorities are included, customers can determine what workload to migrate to another time period, as well as which application components to tune using Strobe, thus resulting in lower licensing charges.

Role-Based Navigation in iStrobe

New roles are now available in the iStrobe user interface to enable users to more easily get to reports and data they find most useful. The new roles are:

  CICS

  DB2

  IMS

  IDMS

When a user selects a role, the iStrobe profile reports are prioritized relevant to that role. For example, the DB2 reports are prioritized for a DB2/DBA role.

Strobe Advisor Enhancements

Release 5.2 includes the following Strobe Advisor enhancements:

  New reports for WebSphere MQ, highlighting key details about the five top MQ calls by CPU usage. The information includes recommended tuning actions for these MQ calls

  Tuning hints to help users improve performance when using the new COBOL 5.1 compiler

  Link in all Strobe Advisor reports to take the user to the underlying profile report for further analysis if desired

  Highlight in the Strobe Advisor DB2 report when DB2 11 has automatically changed the predicate.

DB2 Reporting Enhancements

Strobe for DB2 reports have been updated with the following enhancements:

  Display the Consistency Token value (CONTOKEN) on iStrobe reports

  Exploit new EXPLAIN tables available in DB2 11 to provide performance statistics recommendations

  Provide a new buffer pool statistics report showing active buffer pools, their sizes, hit ratios, and read rates

  Provide DB2 analytics and new Strobe Insight reports to display the data

  Include an option to display dynamic SQL literal information

  Reformatted SQL statement text for better readability.

Enhanced Global Monitoring

Release 5.2 includes the following Global Monitoring enhancements:

  When Batch Global Monitoring submits the Add Queued measurement request, it now uses a session time value set to the average elapsed time. Doing so provides a more meaningful measurement time frame.

  Batch Global Monitoring criteria have been expanded to allow the complete STEP.PROCSTEP to be identified for subsequent measurements. In addition to jobs, users can now also exclude certain steps in Global Monitoring.

  A Global Monitoring facility is now available for IMS transactions. This functionality is similar to what is available with Global Monitoring for CICS. Elapsed and CPU times for individual transaction types are calculated.

  Strobe Global Monitoring has been enhanced to capture and send to iStrobe the four-hour rolling average (4HRA) MSU (millions of service units) and the current MSU for an LPAR. A new Strobe Insight report displays a chart and a supporting table showing the 4HRA MSU and the current MSU value over time. Users can click on a time data item to drill down into the data, resulting in a subreport, presenting the executing jobs during the time interval.

  The ability to view and specify Global Monitoring criteria.

iStrobe Usability Enhancements

The following usability enhancements have been added to iStrobe:

  Smoother installation process for z/OS UNIX and Tomcat

  Ability to simultaneously process multiple downloaded profiles

  Strobe Insight links to take the user to the most appropriate profile report

  Ability to sort columns in a Strobe Insight report

  Up to ten decimal precisions displayed on appropriate DB2 reports.

Additional Profiling and Measurement Enhancements

The following profiling and measurement enhancements are also included:

  When indexing a profile, Strobe provides more accurate attribution of source statements by automatically using a resolution of two bytes.

  Strobe now supports user-written data collectors when performing CICS transaction profiling.

  User can now set up an Add Queued measurement request for CICS transactions.


Software and Hardware Requirements
Strobe

For additional details about supported environments, refer to the Strobe Installation and Customization Guide .

For further information about IBM System z software and hardware compatibility--specifically regarding IBM's z/OS Recommended Service Upgrade, IBM's Extended Address Volumes, IBM DB2 for z/OS, and z/OS product compatibility--refer to http://frontline.compuware.com/charts/hardware.aspx.

Hardware Platforms

Mainframe Systems:

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

EAV Storage

Yes

Operating Systems

  IBM z/OS 1.13, 2.1, 2.2

  IBM ISPF for the supported z/OS releases

Major Subsystems

  IBM DB2 for z/OS 10.1, 11.1, 12.1

  IBM IMS Transaction and Database Servers 12.1, 13.1

  IBM CICS Transaction Server for z/OS V3.1, 3.2, 4.1, 4.2, 5.1, 5.2

  IBM WebSphere Application Server for z/OS V7.0, 8.0, 8.5, 8.5.5

  IBM WebSphere MQ for z/OS V7.0.1, 7.1, 8.0

Languages

  IBM 31-bit and 64-bit SDK for z/OS, Java Technology Edition V6.0, 6.0.1, 7.0, 7.1, 8.0

  IBM Enterprise COBOL for z/OS V3.4, 4.2, 5.1, 6.1

  IBM Enterprise PL/I for z/OS V3.9, 4.2, 4.3, 4.4, 5.1

  IBM VS FORTRAN Compiler and Library V2.6

  IBM XL C/C++ for supported z/OS releases

ISV Software

  CA Gen 7.6 SPO, 8 Base

  CA IDMS 17, 18.0 SPO, 18.5

  SAG Adabas 8.2.2, 8.2.5, 8.2.6, 8.3.1, 8.3.2, 8.3.3, 8.3.4 for the supported z/OS releases

  SAG Natural z/OS 8.2.3, 8.2.4, 8.2.5 for the supported z/OS releases

iStrobe
Hardware Platforms

Mainframe Systems (for a web server running on IBM z/OS UNIX System Services or IBM Linux on System z):

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

Distributed Systems

  Linux x86, x64

  Windows x86, x64

Distributed

  Google Chrome (current version)

  Microsoft Internet Explorer 9 (with Compatibility View disabled), 10, 11 for the supported Windows releases

  Mozilla Firefox (current version)

The following sections show the possible software configurations for each of the components tested with iStrobe. Other configurations might be compatible with iStrobe, but have not been tested.

Operating Systems

  IBM z/OS UNIX System Services with JZOS toolkit (for the supported releases of z/OS)

  Microsoft Windows 7, 8.1, 32-bit or 64-bit

  Microsoft Windows Server 2003, 2003 R2, 2008, 2008 R2, 2012, 2012 R2, 32-bit or 64-bit

  Red Hat Enterprise Linux 5.x, 6.x, 32-bit or 64-bit*

  SUSE Linux Enterprise Server 10, 11, 32-bit or 64-bit*

* Red Hat Enterprise Linux and SUSE Linux Enterprise Server are supported on Intel x86 and x64 with IBM Linux on System z.

Major Subsystems

IBM WebSphere Application Server for z/OS V8.5.5

Languages

  IBM 31-bit and 64-bit SDK for z/OS, Java Technology Edition V7.1

  Oracle Java SE 7, 8

ISV Software

Apache Tomcat

-- For IBM z/OS UNIX System Services: 6.x, 7.x, 8

-- For Microsoft Windows and Linux: 6.x, 7.x, 8

Hardware Requirements

These are the minimum requirements for a server dedicated to iStrobe with less than 20 users. If performance problems are encountered, it may be necessary to increase memory or processor speed.

  Hard Disk: 1 GB minimum. Each Performance Profile requires 0.2-50 MB of disk space, depending on the measured application and the Strobe measurement parameters. Space requirements can vary widely depending on the number of users and how many profiles they keep. The files may be stored on the iStrobe server or on another file server.

  Memory: 4 GB minimum

  Processor: 2 GHz minimum

Database Management Server Requirements
Major Subsystems

IBM DB2 for z/OS (in Compatibility Mode or New Function Mode) V10.1, 11.1

Distributed

IBM DB2 for Linux, UNIX, and Windows (LUW) V9.5, 9.7, 10.1, 10.5

ISV Software

  Microsoft SQL Server 2005, Standard and Enterprise Editions

  Microsoft SQL Server 2008, Standard and Enterprise Editions

  Microsoft SQL Server 2008 R2, Standard, Enterprise, and Datacenter Editions

  Microsoft SQL Server 2012, Standard and Enterprise Editions

  Oracle Database 11g, 12c

Discontinued Support

Strobe 5.2 is the last release to support the following:

  CA IDMS 17

  Compuware License Management System 3.1

  IBM Enterprise COBOL for z/OS V3.4

  IBM Enterprise PL/I for z/OS V3.9

  IBM WebSphere MQ for z/OS V7.0.1

  IBM 31-bit and 64-bit SDK for z/OS, Java Technology Edition V7.0

iStrobe 5.2 is the last release to support IBM DB2 for Linux, UNIX, and Windows (LUW) V9.5.


Technical Notes

  A Google Chrome security update prohibits viewing of WebHelp when the help is deployed locally from a file server (as opposed to a Web server). Attempting to view locally deployed help displays a blank help window. Compuware suggests that online help be viewed using Internet Explorer. Alternatively, Chrome's security feature can be turned off by launching Chrome with the command line option --allow-file-access-from-files. This method should only be used when opening local WebHelp that you trust.

  Sites that want to run Strobe 5.2 concurrently with Strobe 4.3 must have PTF U02798A applied.

  IBM DB2 for z/OS V10 PTF UK77953 is required for correct population of SQL execution statistics displayed in the new SQL Activity Statement Metrics sections available in DB2 V10.

  If your site intends to use Strobe and iStrobe, Compuware recommends that you install the latest version of iStrobe before installing the latest version of Strobe in order to exploit any new measurement functionality in iStrobe.

  In the iStrobe Linux installation, if you back up from a password prompt, all data entry will be masked with asterisks.

  When running iStrobe on Apache Tomcat, the recommended Tomcat Java JVM memory should be configured as follows:

-- Initial memory pool field is set to 1024 or greater

-- Maximum memory pool field is set to 1500 or greater

-- XXMaxPermSize=1024m in order to adequately allocate Java HEAP storage.

The JZOS version specified in the JZOSPROC member of the iStrobe JCL dataset needs to specify a Java 7 version (e.g. 70 for 31-bit, 76 for 64-bit). The "export JAVA_HOME" line in the ISMGREMN member of the iStrobe JCL dataset will need to specify a Java 7 path that corresponds to the version selected in the JZOSPROC. It is also suggested that the shell scripts in iStrobe's manager directory be changed to specify the same value for JAVA_HOME as ISMGREMN in the iStrobe JCL dataset.

  When running iStrobe on Apache Tomcat with a 64-bit operating system, you may use either a 32-bit or a 64-bit version of Java. But when running iStrobe on Apache Tomcat with a 32-bit operating system, you must use a 32-bit version of Java.

  The following error message may occur in iStrobe when clicking a link to a profile in a Strobe Insight report.

Uncaught SecurityError: Blocked a frame with origin "http://<myMachine.fullyQualified.domain>:<port>" from accessing a frame with origin "http://<myMachine>:<port>". Protocols, domains, and ports must match.

You can avoid this error by using the same domain to access iStrobe as was specified in the Compuware Enterprise Services (CES) URL during installation.


Product Documentation

The product installation package does not include the product documentation. The following Strobe documentation is available in electronic format on the product documentation site at Compuware’s FrontLine customer support website, https://go.compuware.com .

  Release Notes in HTML format

  The product manuals in PDF format, which may include a PDX index file and associated folder.

Access the Strobe documentation on the FrontLine documentation site at https://go.compuware.com .

PDF and PDX Files

View and print the PDF files with Adobe Reader version 6.0 or more current. Download a free copy of the reader from Adobe’s website, http://www.adobe.com .

Note: With a few minor exceptions, the provided PDF files comply with the requirements of section 508 of the Rehabilitation Act of 1973.

How to Use a PDX File to Search a Compuware Documentation Set

Compuware creates a PDX file for each release of every mainframe product. The file is available in ZIP format on FrontLine, Compuware’s customer support website, along with this README and a folder containing two data files. By pre-cataloging the content of the product’s PDFs, the PDX file allows you to quickly search across the entire documentation set without having to search each PDF individually.

To use the PDX file for a Compuware product:

1. Go to FrontLine ( https://go.compuware.com ) and navigate to the Documentation page for the desired product.

2. Download all of the PDF files for that product to the same local directory. (The Compuware Installer PDF is only cataloged in the Enterprise Common Components PDX file.)

3. Download the ZIP containing the product’s index file.

4. Extract the contents of the ZIP, sending it to the same directory as the PDF files. Be sure to select “All files/folders in archive” and “Use folder names.”

5. Double click the product’s PDX file (< product >Index.pdx). A Search dialog box will appear with the index pre-selected.

6. Enter a word or phrase to search for. To optimize your search, select one or more qualifiers such as “Whole words only,” then click Search.

Your search results will appear almost instantly, grouped by document. Each document with results can be expanded to show a list of matches, with each match including a brief sample of the context in which it occurred. Every match is hyperlinked to the specific page in the PDF where it was found, enabling you to quickly locate the information you’re looking for.

HTML Format

For your convenience, Compuware also provides the Strobe manuals in the Hypertext Markup Language (HTML) format. View HTML files with any standard web browser. Click the icon in the HTML column on the selected FrontLine Documentation page.


Support Resources

Compuware provides a variety of support resources to make it easy for you to find the information you need.

Compuware FrontLine Customer Support Website

You can access online information for Compuware products via our FrontLine customer support website at https://go.compuware.com .

Compuware FrontLine provides access to critical information about your Compuware products. You can review frequently asked questions, read or download documentation, access product fixes, or e-mail your questions or comments. The first time you access Compuware FrontLine, you are required to register and obtain a password. Registration is free.

Contacting Customer Support

Phone

  USA and Canada: 1-800-538-7822 or 1-313-227-5444.

  All other countries: Contact your local Compuware office. Contact information is available at https://go.compuware.com .

Web

You can report issues via the Quick Link Create & View Support Cases on the Compuware FrontLine home page.

Note: Please report all high-priority issues by telephone.

Mail

Compuware Customer Support
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099

Corporate Website

To access Compuware’s site on the Web, go to http://www.compuware.com .

The Compuware site provides a variety of product and support information.

Strobe Information for Customer Support

If a problem arises while installing Strobe, consult the documentation. If the problem persists, please obtain the following information before calling Compuware’s 24-hour product support hotline. This information may be required to help determine the cause of the problem:

If you suspect a Strobe program or documentation problem, report the trouble to Customer Support. To help us resolve the problem, please include the following information:

Strobe measurement abends:

  Strobe log dataset

  Strobe sample dataset

  Dump, if available.

Strobe session manager errors:

  Strobe session manager JES log

  Dump, if available

  Strobe SSA JES log.

Strobe/ISPF errors:

  Strobe log dataset

  Screen print of the Strobe/ISPF panel displaying the error message

  An account of the sequence of events leading up to the error

  Strobe/ISPF panel and option chosen

  Complete error message numbers.

Application or region abends:

  Strobe log dataset

  Dump, if available

  Strobe sample dataset

  JES log from address space

  Strobe SSA JES log.

Reporting errors:

  Strobe sample dataset

  JES log

  Dump, if available.

Indexing errors:

  Strobe sample dataset

  DDIO file

  Compiler SYSPRINT listing showing source program

  Strobe map dataset.

Strobe SSA issues:

  Strobe SSA JES log

  Strobe log dataset

  Dump, if available.

Strobe MSAS issues:

  Strobe MSAS JES log

  Strobe log dataset

  Dump, if available.

Strobe documentation problems:

  Description of the problem

  Book name and page number or help panel on which you found the problem.