## Installation instructions for fix UK63066 for IBM Rational Developer for System z v76 (FMID HHOP760)

The fix is shipped as file IBM.HHOP760.UK63066

The following fixes are prerequisites for this fix:

- UK57122
- UK54177

### Overview of the installation steps

Steps required to install the fix:

1. Allocate host data sets for the fix.
2. Upload the fix from your workstation to z/OS.
3. SMP/E hold information for the fix.
4. Perform SMP/E RECEIVE and APPLY for the fix.

### Allocate host data sets for the fix

A sequential data set must be allocated on the z/OS system to receive the fix that you will upload from your workstation. You can do this by submitting the job below. Add a job card and modify the parameters to meet your site's requirements before submitting.

    //ALLOC    EXEC PGM=IEFBR14
    //*
    //UK63066    DD DSN=hlq.IBM.HHOP760.UK63066,
    //            DISP=(NEW,CATLG,DELETE),
    //            DSORG=PS,
    //            RECFM=FB,
    //            LRECL=80,
    //            UNIT=SYSALLDA,
    //*            VOL=SER=volser,
    //*            BLKSIZE=6160,
    //            SPACE=(TRK,(142,20))
    //*

### Upload the fix from your workstation to z/OS

Upload the file in binary format from your workstation to the z/OS data set. On a Windows system, you can use FTP from a command prompt to upload the file. In the sample dialog shown below, commands or other information entered by the user are in bold, and the following values are assumed:

User enters: | Values
--- | ---
`mvsaddr` | TC P/IP address of the z/OS system
`tsouid` | Your TSO user ID
`tsopw` | Your TSO password
`d:` | Your drive containing the fix files
`hlq` | High-level qualifier that you used for the data set that you allocated in the job above

    C:\>ftp mvsaddr
    Connected to mvsaddr.
    220-FTPD1 IBM FTP CS %version% at mvsaddr, %time% on %date%.
    220 Connection will close if idle for more than 60 minutes.

    User (mvsaddr:(none)): tsouid
    331 Send password please.

    Password: tsopw
    230 tsouid is logged on.  Working directory is "tsouid.".

    ftp> cd ..
    250 "" is the working directory name prefix.

    ftp> cd hlq
    250 "hlq." is the working directory name prefix.

    ftp> binary
    200 Representation type is Image

    ftp> put d:\IBM.HHOP760.UK63066
    200 Port request OK.
    125 Storing data set hlq.IBM.HHOP760.UK63066
    250 Transfer completed successfully
    7903440 bytes sent in 0.28 seconds

    ftp> quit
    221 Quit command received. Goodbye.

### SMP/E hold information for the fix

    ++HOLD(UK63066) SYS FMID(HHOP760) REASON(ACTION) DATE(10347)
    COMMENT
    (****************************************************************
    * Affected function: CA Endevor(R) SCM integration             *
    ****************************************************************
    * Description: Update CARMA Endevor code                       *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: FEK.SFEKLOAD(CRARNDVR)                                 *
    *       FEK.SFEKSAMP(CRA#VCAS)                                 *
    *       FEK.SFEKSAMP(CRA#VCAD)                                 *
    *       FEK.SFEKSAMP(CRASUBCA)                                 *
    *       FEK.SFEKSAMP(CRANDVRA)                                 *
    *       FEK.SFEKSAMP(CRASHOW)                                  *
    *       FEK.SFEKSAMP(CRATMAP)                                  *
    *       FEK.SFEKVSM2(CRA0VCAD)                                 *
    *       FEK.SFEKVSM2(CRA0VCAS)                                 *
    *       usr/lpp/rdz/samples/crastart.endevor.conf              *
    ****************************************************************
    This maintenance updates all parts related to CA Endevor(R) SCM
    integration. The following steps must be performed to update
    your current setup:

    1. Customize and submit FEK.SFEKSAMP(CRA#VCAD and CRA#VCAS) to
    replace the CARMA CRADEF and CRASTRS VSAM data sets with the
    newer versions

    2a. Make a backup of your current FEK.#CUST.PARMLIB(CRASHOW and
    CRATMAP)
    2b. Copy FEK.SFEKSAMP(CRASHOW and CRATMAP) to FEK.#CUST.PARMLIB
    2c. Optionally customize FEK.#CUST.PARMLIB(CRASHOW and CRATMAP)

    Note: FEK.SFEKPROC(CRANDVRA) has changed. If you use a
    customized version of this exec, you must:
    3a. Make a backup of your current customized CRANDVRA
    3b. Copy FEK.SFEKPROC(CRANDVRA) to a customizable location
    3c. Customize the copy of CRANDVRA

    4. Choose your CARMA startup method:

    CRASTART method

    5a. Make a backup of your current
    /etc/rdz/crasstart.endevor.conf
    5b. Copy /usr/lpp/rdz/samples/crastart.endevor.conf to /etc/rdz
    5c. Customize /etc/rdz/crastart.endevor.conf

    Batch Submit method

    6a. Make a backup of your current FEK.#CUST.CNTL(CRASUBCA)
    6b. Copy FEK.SFEKSAMP(CRASUBCA) to FEK.#CUST.CNTL
    6c. Customize FEK.#CUST.CNTL(CRASUBCA)
    ****************************************************************
    * Affected function: SCLM Developer Toolkit                    *
    ****************************************************************
    * Description: customizable temporary file size                *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: /usr/lpp/rdz/samples/SITE.conf                         *
    *       [/var/rdz/sclmdt/CONFIG/PROJECT/SITE.conf]             *
    ****************************************************************
    This maintenance introduces a new variable to SITE.conf, which
    allows you to customize the size of temporary file allocations.
    Add the following to the bottom of your current SITE.conf, and
    uncomment and customize if desired.

    * Large temporary dataset allocations for users are set in the
    * product. The maximum temporary dataset allocation is
    * SPACE(15,75) TRACKS.
    * To alter the maximum dataset allocation uncomment the variable
    * below and specify the primary and secondary extent values
    * (in TRACKS).
    *TEMPDSN=SPACE(15,75)
    ****************************************************************
    * Affected function: TSO SUBMIT method to submit jobs          *
    ****************************************************************
    * Description: Support IKJEFT01 jobs                           *
    ****************************************************************
    * Timing: pre-APPLY                                            *
    ****************************************************************
    * Part: FEK.SFEKSAMP(FEJTSO)                                   *
    ****************************************************************
    This maintenance updates the TSO SUBMIT skeleton job, FEJTSO.
    If you have customized this file, it is advised to back it
    up before proceeding with SMP/E Apply.

    ****************************************************************
    * Affected function: TSO SUBMIT method to submit jobs          *
    ****************************************************************
    * Description: Support IKJEFT01 jobs                           *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: FEK.SFEKSAMP(FEJTSO)                                   *
    *       [FEK.#CUST.CNTL(FEJTSO)]                               *
    ****************************************************************
    This maintenance updates the TSO SUBMIT skeleton job, FEJTSO.
    Redo your customizations, if any, after applying this
    maintenance.
    The update also introduces a new variable to FEJTSO,
    a temporary data set name, by default
    &SYSPREF..&SYSUID..&SYSNAME..FEJ$TMP$.SUBMIT

    ****************************************************************
    * Affected function: Configuration problem analysis            *
    ****************************************************************
    * Description: Updated debug information gathering tool        *
    ****************************************************************
    * Timing: pre-APPLY                                            *
    ****************************************************************
    * Part: FEK.SFEKSAMP(FEKLOGS)                                  *
    ****************************************************************
    This maintenance updates the debug information gathering tool,
    FEKLOGS.
    If you have customized this file, it is advised to back it
    up before proceeding with SMP/E Apply.

    ****************************************************************
    * Affected function: Configuration problem analysis            *
    ****************************************************************
    * Description: Updated debug information gathering tool        *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: FEK.SFEKSAMP(FEKLOGS)                                  *
    *       [FEK.#CUST.JCL(FEKLOGS)]                               *
    ****************************************************************
    This maintenance updates the debug information gathering tool,
    FEKLOGS.
    Redo your customizations, if any, after applying this
    maintenance.

    ****************************************************************
    * Affected function: Uneditable character detection            *
    ****************************************************************
    * Description: Updated uneditable character table              *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: /usr/lpp/rdz/samples/uchars.settings                   *
    *       [/etc/rdz/uchars.settings]                             *
    ****************************************************************
    This maintenance updates the uneditable character table,
    uchars.settings.
    Copy the updated file to /etc/rdz to use it.

    ****************************************************************
    * Affected function: RSE console messages                      *
    ****************************************************************
    * Description: New console message                             *
    ****************************************************************
    * Timing: n/a                                                  *
    ****************************************************************
    * Part: n/a                                                    *
    ****************************************************************
    This service introduces a new RSE console message.
    FEK012I (RSE home directory = /usr/lpp/rdz)
    The message is issued during startup of RSED.
    ****************************************************************
    * Affected function: Uneditable character detection            *
    ****************************************************************
    * Description: Updated uneditable character table              *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: /usr/lpp/rdz/samples/uchars.settings                   *
    *       [/etc/rdz/uchars.settings]                             *
    ****************************************************************
    This maintenance updates the uneditable character table,
    uchars.settings.
    Copy the updated file to /etc/rdz to use it.).

### Perform SMP/E RECEIVE and APPLY for the fix

SMP/E RECEIVE and APPLY the fix.