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

The fix is shipped as file IBM.HHOP760.UK57126

The following fixes are prerequisites for this fix:

- UK57122

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

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

    ftp> quit
    221 Quit command received. Goodbye.

### SMP/E hold information for the fix

    ++HOLD(UK57126) SYS FMID(HHOP760) REASON(ACTION) DATE(10140)
    COMMENT
    (****************************************************************
    * Affected function: SMP/E install                             *
    ****************************************************************
    * Description: enlarge SMP/E and installation data sets.       *
    ****************************************************************
    * Timing: pre-APPLY                                            *
    ****************************************************************
    * Part: n/a                                                    *
    ****************************************************************
    Applying/accepting this maintenance requires substantially
    larger SMP/E work, target and distribution data sets than
    normal. For permanent data sets, this growth might be covered
    by data set extents.
    * SMPPTS holds received service.
    It will grow to 900 tracks (60 cylinders).
    The new advised space allocation is TRK(1200,75,80).
    * AFEKHFS holds accepted z/OS UNIX parts.
    It will grow to 2010 tracks (134 cylinders).
    The new advised space allocation is TRK(2100,75,40).
    * z/OS UNIX file system holds applied z/OS UNIX parts.
    It will grow to 2010 tracks (134 cylinders).
    The new advised space allocation is CYL(140,10).

    For temporary data sets, SMP/E TARGET and DLIB DDDEF statements
    might require an update.
    * SMPWRK6, the new advised space allocation is CYL(20,10)
    * SYSUT1,  the new advised space allocation is CYL(20,10)

    For a new install, you can use the sample SMP/E jobs in
    FEK.SFEKJCL, which are updated by a pre-requisite PTF.
    * FEK1SMPE - create an SMP/E environment
    * FEK3ALOC - allocate target and distribution libraries
    * FEK4MNT  - allocate and mount a file system).

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

SMP/E RECEIVE and APPLY the fix.