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

The fix is shipped as file IBM.HHOP760.UK57122

The following fixes are prerequisites for this fix:

- 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
    //*
    //UK57122    DD DSN=hlq.IBM.HHOP760.UK57122,
    //            DISP=(NEW,CATLG,DELETE),
    //            DSORG=PS,
    //            RECFM=FB,
    //            LRECL=80,
    //            UNIT=SYSALLDA,
    //*            VOL=SER=volser,
    //*            BLKSIZE=6160,
    //            SPACE=(TRK,(164,30))
    //*

### 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.UK57122
    200 Port request OK.
    125 Storing data set hlq.IBM.HHOP760.UK57122
    250 Transfer completed successfully
    9102960 bytes sent in 0.28 seconds

    ftp> quit
    221 Quit command received. Goodbye.

### SMP/E hold information for the fix

    ++HOLD(UK57122) SYS FMID(HHOP760) REASON(ACTION) DATE(10140)
    COMMENT
    (****************************************************************
    * Affected function: MVS build procedures                      *
    ****************************************************************
    * Description: new build procedure ELAXFDCL                    *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: SYS1.PROCLIB(ELAXFDCL)                                 *
    *       [FEK.SFEKSAMP(ELAXFDCL)]                               *
    ****************************************************************
    This maintenance introduces a new proclib member, ELAXFDCL,
    which is used by certain (MVS) build actions initated on the
    client.

    Customize and copy this member to SYS1.PROCLIB.

    ****************************************************************
    * Affected function: application deployment manager            *
    ****************************************************************
    * Description: add URIMAP as CICS Explorer resource            *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: FEK.SFEKSAMP(ADNJSPAU)                                 *
    *       FEK.SFEKSAMP(ADNVCRD)                                  *
    ****************************************************************
    This maintenance adds tolerance for defining URIMAP as CICS
    Explorer resource.
    The ADNJSSPAU JCL used to manage the CRD repository is updated
    with sample URIMAP definitions.
    If you have customized this member, ensure you create a backup
    before applying this maintenance, and redo your changes after
    the maintenance has been applied.

    The CRD repository VSAM must be rebuild to be able to define
    URIMAP. You can use the ADNJSPAU JCL to repopulate the CRD
    repository.

    ****************************************************************
    * Affected function: CARMA                                     *
    ****************************************************************
    * Description: add unique RAM identifier                       *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: SFEKVSM2(CRA0VDEF)                                     *
    * Part: SFEKVSM2(CRA0VCAD)                                     *
    * Part: SFEKSAMP(CRA390SD)                                     *
    ****************************************************************
    This maintenance introduces the toleration of a new CARMA key
    that defines a unique RAM identifier.
    The sample CARMA VSAM inputs are updated to have a unique RAM
    identifier.
    The CARMA side deck is updated with the unique RAM id functions.

    ****************************************************************
    * Affected function: CARMA                                     *
    ****************************************************************
    * Description: variable length message strings                 *
    ****************************************************************
    * Timing: n/a                                                  *
    ****************************************************************
    * Part: SFEKVSM2(CRA0VSTR)                                     *
    * Part: SFEKVSM2(CRA0VCAS)                                     *
    * Part: SFEKSAMP(CRADSDEF)                                     *
    * Part: SFEKSAMP(CRA390H)                                      *
    ****************************************************************
    This maintenance introduces the toleration of a new format for
    the CARMA message VSAM. This new format allows variable length
    strings to be stored.
    The sample CARMA VSAM inputs are updated to use the new
    variable-length format.
    Sample CARMA source code is updated to support the new
    variable-length format.

    ****************************************************************
    * Affected function: CARMA                                     *
    ****************************************************************
    * Description: VSAM conversion utility                         *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: SFEKSAMP(CRA#VS2)                                      *
    ****************************************************************
    This maintenance introduces a utility, SFEKSAMP(CRA#VS2),
    to convert an existing fixed-length CARMA VSAM to a
    variable-length format.

    ****************************************************************
    * Affected function: console messages                          *
    ****************************************************************
    * Description: updated messages for Java 64-bit support        *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: n/a                                                    *
    ****************************************************************
    Console message FEK001I is updated to indicate whether 31bit or
    64bit JAva is being used.
    FEK001I RseDaemon being initialized in {0} bit mode

    ****************************************************************
    * Affected function: CA Endevor(R) interface                   *
    ****************************************************************
    * Description: updated pre-allocation exec                     *
    ****************************************************************
    * Timing: pre-APPLY                                            *
    ****************************************************************
    * Part: FEK.SFEKPROC(CRANDVRA)                                 *
    ****************************************************************
    This maintenance introduces minor changes to the CA Endevor(R)
    pre-allocation exec, CRANDVRA.
    If you have customized this member, ensure you create a backup
    before applying this maintenance, and redo your changes after
    the maintenance has been applied.

    ****************************************************************
    * Affected function: CA Endevor(R) integration                 *
    ****************************************************************
    * Description: add EXT2ELM DD to support new functions         *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: FEK.#CUST.CNTL(CRASUBCA)                               *
    *       /etc/rdz/crastart.endevor.conf                         *
    *       [FEK.SFEKSAMP(CRASUBCA)]                               *
    *       [/usr/lpp/rdz/samples/crastart.endevor.conf]           *
    ****************************************************************
    This maintenance adds new functions to the CA Endevor(R)
    integration. In order to use these new function, CRASUBCA or
    crastart.endevor.conf (depending on your chosen CARMA startup
    method) must be updated with a new EXT2ELM DD statement.
    The defintion is identical to the existing EXT1ELM definition,
    except for the DD name.

    ****************************************************************
    * 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. It is now able to trap all ISPF Client Gateway output
    files written to /tmp.
    If you have customized this member, ensure you create a backup
    before applying this maintenance, and redo your changes after
    the maintenance has been applied.

    ****************************************************************
    * Affected function: JES Job Monitor                           *
    ****************************************************************
    * Description: HOST_CODEPAGE becomes optional                  *
    ****************************************************************
    * Timing: n/a                                                  *
    ****************************************************************
    * Part: FEK.SFEKSAMP(FEJJCNFG)                                 *
    ****************************************************************
    When used in combination with a v7610 or higher client, this
    maintenance makes the HOST_CODEPAGE directive in FEJJCNFG an
    optional parameter.).

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

SMP/E RECEIVE and APPLY the fix.