Installing Z Code Optimization Advice on your z/OS system

Edit online

2.1.0+

IBM® watsonx Code Assistant™ for Z Code Optimization Advice consists of a z/OS host installation package and a VS Code extension installation package. This section refers to information on the z/OS host installation package.

z/OS host requirements

  • IBM z/OS 2.4 or above
  • IBM Z server 14 or above
Important:

Installing the z/OS host package on a z/OS LPAR is recommended for accurate results.

2.4.0+

Installations of the z/OS host package can also be made on emulated environments through zPDT (Program Development Tool) or zD&T (Z Development & Test), however performance measurements and problem priority may be inaccurate compared to profiling on IBM Z hardware.

Z Code Optimization Advice does not work with zVDT (IBM Virtual Dev and Test for z/OS) or z/VM.

Code page configuration

Z Code Optimization Advice uses the VS Code default code page 1047. If another code page is used, it may prevent Z Code Optimization Advice from being able to process the report.
Note: If you are unable to open the optimization report in VS Code, check your configuration and ensure code page 1047 is used. To reconfigure the code page, refer to Zowe™ Explorer profiles.

Connecting your Zowe profile with z/OS

To make use of Zowe to open and edit files directly from z/OS MVS or USS, you need the Zowe client software and either IBM RSE API or z/OSMF configured. For more information, refer to Installing Zowe CLI and VS Code Extension for Zowe. Once installed, follow the instructions at Interacting with z/OS to create a Zowe CLI team configuration file so that data sets can be found and accessed.

User authorization

Users must be authorized to be able to submit JCL using TSO/E commands. For information on how to enroll users to TSO/E, refer to Overview of enrolling users through the Information Center Facility. For information on authorization settings in TSO/E, refer to TSO/E authorization information.

For first time users

First time installers need the z/OS host component package from the IBM watsonx Code Assistant for Z product IBM Passport Advantage® product download to perform installation of the z/OS portion of Z Code Optimization Advice.

Important: This information is intended for system programmers or other users familiar with installing IBM z/OS SMP/E product packages.
  1. Transfer the PAX file to your z/OS machine and perform SMP/E installation by following the instructions in Chapter 6 of the Program Directory for IBM watsonx Code Assistant for Z Code Optimization Advice.
    Note: The Program Directory contains complete Z Code Optimization Advice installation information and instructions.

    The Program Directory can also be accessed from Passport Advantage, through unzipping the z/OS host zipfile and opening the README.htm file.

    This file guides you to the location of the HAMQ210 Program Directory, a sample JCL with upload instructions, as well as information on PTFs that may be required on your z/OS system.

  2. After installing the SMP/E image, install the latest PTF for the host component following instructions in the download package.

For upgrading between versions

For users looking to upgrade to the latest version of Z Code Optimization Advice, check the Fix List for IBM watsonx Code Assistant for Z Code Optimization Advice (z/OS Host component) and install the latest PTF.

The latest PTF is cumulative and contains corrective fixes and features made available for a new release of the product. It is recommended that users keep the z/OS host component updated in line with any VS Code extension upgrades.