Migrate from version 16.0 to version 17.0

These notes are for a migration from a base version 16.0 to version 17.0. It includes changes that are already documented as part of version 16.0 maintenance. The changes that are part of the maintenance stream, and thus possibly already implemented, are marked with the release where they were introduced.

IBM z/OS Explorer Extensions, FMID HHOPH00

  • The default SMP/E install location for MVS components did not change and remains FEL.*.
  • The default SMP/E install location for z/OS® UNIX components did not change and remains /usr/lpp/IBM/zee/*.
  • Since PTF UI90947:
    • Samples: A customizable file has been updated:
      • FEKRNPLI: support +DD:OPTIONS
  • New customizable files have been added:
    • zee.prime.env: early initialization of environment variables
  • ZUnit: The functionality moved to a new product, IBM Test Accelerator for Z, and the related components are no longer shipped as part of IBM® z/OS Explorer Extensions. The following customizable SFELSAMP members have been removed:
    • AZUALLOC
    • AZUCSD
    • AZUSIP
    • AZUTCPLI
    • AZUTSTRX
    • AZUUDB2
    • AZUZUNIT

Configurable files

Table 1 shows an overview of z/OS Explorer Extensions files that are customized in version 16.0. The z/OS Explorer Extensions sample libraries, FEL.SFELSAMP and /usr/lpp/IBM/zee/samples/, contain more customizable members than listed here, such as sample CARMA source code and jobs to compile them.

Note: Sample job FELSETUP copies all listed members to different data sets and directories, default FEL.#CUST.* and /etc/zexpl/*.

Table 1. Version 17.0 customizations
Member/File Default location Purpose Migration notes
FELSETUP
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create data sets and directories, and populate them with customizable files Updated to copy new files and removal of obsolete members
ELAXF
FEL.SFELSAMP 
[FEL.#CUST.PROCLIB]
JCL INCLUDE to manage HLQs Updated with new default high level qualifiers and removal of obsolete entries
ELAXF*
FEL.SFELSAMP 
[FEL.#CUST.PROCLIB]
JCL for remote project builds, and so on None
FELRACF
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL for security definitions None
FELSMF
FEL.SFELSAMP[
FEL.#CUST.JCL]
JCL forSMF Reporting None
CRA$VMSG
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the CARMA message VSAM None
CRA$VDEF
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the CARMA configuration VSAM None
CRA$VSTR
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the CARMA custom information VSAM None
CRA$VCAD
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the CARMA configuration VSAM for CA Endevor® SCM RAM None
CRA$VCAS
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the CARMA custom information VSAM for CA Endevor® SCM RAM None
CRASUBMT
FEL.SFELSAMP 
[FEL.#CUST.CNTL]
CARMA batch startup CLIST None
CRASUBCA
FEL.SFELSAMP 
[FEL.#CUST.CNTL]
CARMA batch startup CLIST for CA Endevor® SCM RAM None
CRACFG
FEL.SFELSAMP
[FEL.#CUST.PARMLIB]
CARMA interaction configuration for CA Endevor® SCM RAM None
CRABCFG
FEL.SFELSAMP
[FEL.#CUST.PARMLIB]
CARMA batch actions configuration for CA Endevor® SCM RAM None
CRABATCA
FEL.SFELSAMP 
[FEL.#CUST.CNTL]
CARMA batch action JCL for CA Endevor® SCM RAM None
CRASCL
FEL.SFELSAMP
[FEL.#CUST.PARMLIB]
Template SCL for CA Endevor® SCM None
CRASHOW
FEL.SFELSAMP
[FEL.#CUST.PARMLIB]
CARMA configuration for CA Endevor® SCM RAM None
CRATMAP
FEL.SFELSAMP
[FEL.#CUST.PARMLIB]
CARMA configuration for CA Endevor® SCM RAM None
CRANDVRA
FEL.SFELPROC
CARMA allocation REXX for CA Endevor® SCM RAM None
CRADYNDA
FEL.SFELPROC
CARMA allocation REXX for CA Endevor® SCM RAM None
CRAALLOC
FEL.SFELPROC
CARMA allocation REXX None
CRA#VSLM
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the SCLM RAM's message VSAM None
CRA#ASLM
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the SCLM RAM's data sets None
CRA#VPDS
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to create the PDS RAM's message VSAM None
CRA#UADD
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to merge RAM definitions None
CRA#UQRY
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to extract RAM definitions None
CRAXJCL
FEL.SFELSAMP 
[FEL.#CUST.ASM]
Sample source code for IRXJCL replacement None
CRA#CIRX
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to compile CRAXJCL None
FELTEP2
FEL.SFELSAMP 
[FEL.#CUST.SQL]
SQL command input used by ELAXF* None
FELTIAD
FEL.SFELSAMP
[FEL.#CUST.SQL]
SQL command input used by ELAXF* None
FEKRNPLI
FEL.SFELSAMP 
[FEL.#CUST.CNTL]
REXX to call the PL/I compiler from within the preprocessor framework Updated to support +DD:OPTIONS
IRZCSD
FEL.SFELSAMP
[FEL.#CUST.JCL]
JCL to define Enterprise Service Tools to CICS® None
zee.env
/usr/lpp/IBM/zee/samples/
[/etc/zexpl/]
RSE environment variables None
zee.prime.env /usr/lpp/IBM/zee/samples/[/etc/zexpl/] RSE environment variables New
CRASRV.properties
/usr/lpp/IBM/zee/samples/
[/etc/zexpl/]
CARMA configuration file None
crastart.conf
/usr/lpp/IBM/zee/samples/
[/etc/zexpl/]
CARMA configuration file for CRASTART usage None
crastart.endevor.conf
/usr/lpp/IBM/zee/samples/
[/etc/zexpl/]
CARMA configuration file for CRASTART usage for CA Endevor® SCM RAM None
include.conf
/usr/lpp/IBM/zee/samples/
[/etc/zexpl/]
Forced includes for C/C++ content assist None

IBM z/OS Source Code Analysis, FMID HAKGH00

  • The default SMP/E install location for MVS did not change and remains AKG.*.
  • The default SMP/E install location for z/OS UNIX did not change and remains /usr/lpp/IBM/akg/*.
  • Since PTF UI96056:
    • Code Coverage: A customizable file has been updated:
      • AKGCC: support DD CCOPT and options -KEEP and -LEFIRST
  • Code Coverage: A customizable file has been updated:
    • AKGCC: Java 17 or higher required

Configurable files

Table 2 shows an overview of files that are customized in version 17.0. The IBM z/OS Source Code Analysis sample libraries, AKG.SAKGSAMP and /usr/lpp/IBM/akg/samples, contain more customizable members than listed here, such as sample code review post-processing script.

Note: Sample job AKGSETUP copies all listed members to different data sets, default AKG.#CUST.*.
Table 2. Version 17.0 customizations
Member or File Default location Purpose Migration notes
AKGSETUP
AKG.SAKGSAMP
[AKG.#CUST.JCL]
JCL to create data sets, and populate them with customizable files None
AKGCC
AKG.SAKGSAMP
[AKG.#CUST.PROCLIB]
JCL for code coverage Updated to support new features and Java 17 requirement
AKGCR
AKG.SAKGSAMP
[AKG.#CUST.PROCLIB]
JCL for code review None
AKGCRADD
AKG.SAKGSAMP
[AKG.#CUST.JCL]
JCL to add third-party code to code review None