Release Notes

ISPW 17.02

October 2, 2017

Obtaining the Latest Release Notes

What’s New in Release 17.02

Software and Hardware Requirements

Technical Notes

Known Issues

Product Documentation

Support Resources

Obtaining the Latest Release Notes

If you accessed this document from a product or documentation media, you may not be reading the latest Release Notes . For the most recent information, go to FrontLine , Compuware’s customer support website. The first time you access FrontLine, you are required to register and obtain a password. After logging onto FrontLine, select your product from the drop-down list and click Go. On the left side of the page, click the Documentation link. You will find the latest Release Notes listed with the other product documentation.


What’s New in Release 17.02

ISPW is a modern, end-to-end Agile source code management, release automation, and deployment automation tool that enables mainframe application developers at all skill levels to fulfill business requirements, optimize code quality, and improve developer productivity through mainframe DevOps.

The ISPW Release Notes include all information--such as new features, system requirements, technical notes, and known issues--for ISPW.

Release 17.02 includes the following enhancements:
October 2, 2017
Webhooks

Webhook notifications can now be setup for ISPW. Webhooks can communicate information on ISPW activities such as generate, promote, regress, deploy and fallback to other DevOps tools in real time. Webhooks can be triggered regardless of whether developers or operators use Topaz, 3270 or REST APIs.

HCI Communications

The web component of ISPW now use the Compuware Host Communications Interface (HCI) for communication to ISPW. The ISPW web login dialogs will now prompt users for the Host Connection they wish to use. Personal Access Tokens used for ISPW’s REST API have also been updated to a Host Connection.

REST API Enhancements

Other ISPW REST API improvements include:

  Getting a Task list for a Release container

  Fallback operation on Set container

  Retrieving a compiler listing for a Task

  Retrieving Deploy information on a Set container

  Supports the Generate operation on a Release container

  Supports specifying a specific Environment or system for Deploy operations on Assignment and Release containers

  APIs for Promote and Generate now have the ability to control whether ISPW’s integrated deploy will be triggered as part of the Promote operation.

June 28, 2017
Single Signon

You will now be able to use your existing common Compuware HCI connection with ISPW.

Notes:

  Applying this maintenance will affect how the product communicates with Topaz Workbench. This needs to be coordinated with applying the July maintenance for Topaz Workbench. Implementing single signon was done with a shift to HCI. HCI also needs to be updated.

  Requires an update to ISPW on the mainframe, HCI, and CSS 17.2 PTF CXS105A.

  You must update the ECC parameters ISPW_HOST and ISPW_PORT as described in the Enterprise Common Components Installation and Configuration Guide “Task 8.5 Activating ISPW Support”.

  When used together, ISPW Eclipse and ISPW must be on the same release level to enable single signon. If your site intends to use ISPW in Topaz Workbench, Compuware recommends that you install the latest version of ISPW before installing the latest version of ISPW Eclipse.

April 3, 2017
New ISPW REST Endpoints

Four new ISPW REST endpoints have been added. These endpoints allow you to further integrate ISPW into your DevOps toolchain with tools such as Jenkins.

  Create Assignment: Sets up an Assignment, which is a container where you can add the “Tasks” or items you will be working on.

  Add Tasks (Task Load) to Assignment: Gives you the ability to load Tasks such as programs, JCL, etc. into an Assignment.

  Generate: Provides a way to leverage the ISPW Generate process to do your compile and link. It can be used to perform the Generate operation on Tasks in an Assignment. When processing is complete, you can view the status indicating the success or failure of the compiles.

  Get Information about an Assignment: Retrieves the Application, Stream, Description, Owner, and the customizable WorkRef Number. Additionally, information about Tasks contained in the Assignment can be retrieved, such as the status of Generate operations on each Task in an Assignment.

January 4, 2017
ISPW Eclipse Enhancements

This release adds a number of significant capabilities to ISPW Eclipse:

  You can now import new source code members into ISPW from an external PDS mainframe file.

  It is now possible to multi-select Sets, Assignments, and Release containers and issue actions against them.

  You are now able to create a New Assignment or Release from the Add to Assignment dialog.

  The Generate List view has been renamed to Generate Impacts to better reflect how it’s used.

  When you create a New Task, ISPW will now automatically show the Tasks View and select that new task.

October 3, 2016

ISPW has been enhanced as follows:

ISPW Deploy APIs

A set of new REST APIs have been made available to enable integrations with products such as XebiaLabs XL Release. These APIs make it easy to leverage ISPW Deploy in conjunction with existing release management infrastructure using Jenkins, HipChat, and Slack. The initial delivery includes APIs for Create Release, Get Release Information, Promote Release, Deploy Release, and Get Set Information.

ISPW Eclipse Enhancements

  Quick Search bar in the Tasklist and containers views so you can find items just by typing the start of a string

  Ability to do a mass add and checkout of multiple components to an assignment

  Automatic cleanup of completed sets

  The ability to perform actions from a context menu

  The ability to set problem markers on a source listing in the Problems view for Compile Diagnostics

  The ability to “Add to Assignment” or “checkout” with right-click option from Impacts View.

July 1, 2016

ISPW has been enhanced as follows:

ISPW Web Interface for Deploy

A new Web Interface for Deploy is now available to join the existing Approval Interface. You will be able to see the current status of your Releases and even see a graphical representation of what is being deployed and where.

Miscellaneous Enhancements

  Improved User Experience in the Topaz Eclipse Interface

  Web Server now available as a z/OS or Linux installation in addition to the previous Windows version.

April 1, 2016

ISPW has been enhanced as follows:

Visualization of Impact Results

Knowing the potential impact of a change is key; knowing right when you start is critical. ISPW Eclipse now provides for visualization of the impact. Impacts can be generated from source, copybooks, and JCL. For a program, it would show the target calls, what calls it, and the jobs it is in--not only the programs but also where each of those assets are in the development cycle will be obvious in the chart. Adding the visual element provides an easier, more intuitive way to spot dependencies that can affect a project. The chart can be saved as a jpg, png or pdf. The Impact Table can now be saved as a csv.

Topaz Program Analysis Enablement

In ISPW Eclipse, if the Impact Analysis shows other programs might need to be changed, users can now select Program Analysis and get an in-depth view of their program. When editing programs, users will be able to view the structure, code flaws, logic and data flows. CES and a license for Topaz for Program Analysis are required to enable this functionality.

Compile Errors Shown in SlickEdit and Problems View upon Generate

New to ISPW Eclipse is the ability to synchronize compiler errors to a SlickEdit edit session. Clicking an error in the Problems view positions the source code to the line of code that has produced the compile error. Users can quickly size up errors from the compile and go right to the affected lines to see them in context.

New Mobile Approval Interface

Building on the existing Web Approval interface, Compuware now offers a mobile interface suitable for a mobile browser. This enables approvals to be done when away from the office; perfect for critical fixes that need to get into production.

Non-z/OS Warehouses

The ISPW Deploy feature has always supported the usage of warehouses on non-z//OS platforms for staging of deployments to open systems. However, Compuware has now extended the warehouse capability so that, when such open system components are checked in or imported to ISPW, they can now be stored in place and managed by an ISPW remote server on any supported platform.

License Management

Licensing for ISPW has been brought under Compuware licensing to make it simpler to administer.


Software and Hardware Requirements

The Software and Hardware Requirements section of the Release Notes has been standardized across all Compuware Mainframe products and their Distributed components. Please note that any versions of third-party software that are no longer supported by their vendors under standard published contracts have been removed from the Software and Hardware Requirements section and placed in the Discontinued Support section of the release notes. However, any third-party software that was supported when this Compuware product went GA will continue to be supported until this product release has reached its End of Support date. No functionality has been removed from the product.

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 .

ISPW - Mainframe
Hardware Platforms

Mainframe Systems:

-- z13, z13s, z14

-- zEC12, zBC12

-- z196, z114

-- z10-EC/BC

-- z9-EC/BC

-- z900, z990

-- z800, z890

EAV Storage

Yes

Operating Systems

  IBM z/OS V2.1, 2.2, 2.3

  IBM ISPF for the supported z/OS releases

  IBM Communications Server for z/OS for the supported z/OS releases

Major Subsystems

  IBM DB2 for z/OS V10.1, 11.1, 12.1

  IBM IMS Transaction and Database Servers V13.1, 14.1

  IBM WebSphere MQ for z/OS V7.1.0, 8.0

  IBM MQ for z/OS V9.0

Corequisites

For specific required PTFs, consult the Product Currency Tables at https://frontline.compuware.com/apps/oscharts/zos.aspx .

  Compuware Products and Components:

-- Enterprise Common Components (ECC) 16.05, 17.02

ISPW - Eclipse
Hardware Platforms

  Distributed Systems:

-- Microsoft Windows x86, x64. 2 GHz minimum

-- Hard Disk: 700 MB minimum

-- Memory: 2 GB minimum

Operating Systems

  Microsoft Windows 7, 8.1 Update (KB 2919355), 10

Languages

  Oracle Java SE 8

For more information, see Configuring Memory Settings for ISPW Eclipse below.

Corequisites

  Compuware products and components:

-- ISPW:

  17.02

-- Topaz Workbench:

  17.02, 18.02

-- Compuware Enterprise Services (if using the Program Analysis feature):

  5.0.2, 5.0.3, 5.0.4, 5.0.5, 5.0.6, 16.3, 17.2

Distributed

  Browsers and IDEs (optional):

-- Eclipse V4.4.2, 4.5

-- IBM Rational Developer for System z V9.5

-- IBM Rational Developer for the Enterprise V9.5

-- Microsoft Internet Explorer 9, 10, 11 for the supported Windows releases

ISPW - Web
Corequisites

  Compuware Products and components:

-- Compuware Enterprise Services version matching the six-digit release number of ISPW (e.g. ISPW 17.02.02 requires CES 17.02.02).

Distributed

Browsers and IDEs:

-- Google Chrome (current version)

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

-- Mozilla Firefox (current version)

ISPW - Mobile
Corequisites

  Compuware Products and components:

-- Compuware Enterprise Services version matching the six-digit release number of ISPW (e.g. ISPW 17.02.02 requires CES 17.02.02).

Distributed

Browsers and IDEs:

-- Google Chrome on Android 4.4.0+

-- Apple Safari on iOS 7+


Technical Notes

Configuring Memory Settings for ISPW Eclipse

Java OutOfMemory errors may occur when editing a large file or displaying a large JES report. These errors can often be avoided by increasing the maximum size of the JVM memory heap. The initialization files in Topaz Workbench or Eclipse (topaz.ini or eclipse.ini) include an Xmx parameter (default 512m or 1024m) used to specify the maximum heap size. The optimum value for this parameter varies depending on the OS used, memory fragmentation, and other factors.

On 32-bit Windows, the theoretical heap size is limited to 2GB due to how Windows allocates memory, but this is reduced by many factors. Generally, the stated maximum is 1536m, while a commonly stated max range is 1200m to 1500m. The optimal setting for a particular installation--with no OutOfMemory errors or noticeable garbage collection pauses--can only be determined by experimenting with different values. Compuware recommends increasing the Xmx value to 1200m as a starting point and increasing or decreasing the value in small increments, such as 512m, until an optimum value is found. However, even with a setting of 1536m, large JES output can easily exceed that value. The only practical solution in such situations is to install the products on a 64-bit OS.

On 64-bit Windows operating systems, heap size is limited by your Windows virtual memory specification, minus a small amount of memory used by the OS and other processes. Specifying 4GB or more for the Xmx parameter can be practical depending on the Windows virtual memory size.


Known Issues

NA


Product Documentation

The product installation package does not include the product documentation. The following ISPW 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 ISPW 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 ISPW 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.


Doc. OCT2017