## Installation instructions for fix UK53001 for IBM Rational Developer for System z v75 (FMID HHOP750)

The fix is shipped as file IBM.HHOP750.UK53001

The following fixes are prerequisites for this fix:

- UK51499
- UK45253
- UK43840

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

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

    ftp> quit
    221 Quit command received. Goodbye.

### SMP/E hold information for the fix

    ++HOLD(UK53001) SYS FMID(HHOP750) REASON(ACTION) DATE(09351)
    COMMENT
    (****************************************************************
    * Affected function: JES Job Monitor                           *
    ****************************************************************
    * Description: incorrect time values                           *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: SFEKSAMP(FEJJJCL)                                      *
    ****************************************************************
    When using the _CEE_ENVFILE keyword to define environment
    variables, LE pads these variables with blanks. This padding can
    cause LE to ignore the settings of the TZ variable, in which
    case it uses the GMT timezone.

    LE provided a fix (z/OS 1.8 and higher) in the form of the
    _CEE_ENVFILE_S keyword. Here no padding takes place, and the TZ
    environment variable is interpreted correctly.

    If need be, the _CEE_ENVFILE_S keyword can be used (instead of
    _CEE_ENVFILE) in the startup JCL, as shown in the updated sample
    JCL, FEK.SFEKSAMP(FEJJJCL).

    //*
    //* JES JOB MONITOR
    //*
    //JMON     PROC PRM=,               * PRM='-TV' TO START TRACING
    //            LEPRM='RPTOPTS(ON)',
    //            HLQ=FEK,
    //            CFG=FEK.#CUST.PARMLIB(FEJJCNFG)
    //*
    //JMON     EXEC PGM=FEJJMON,REGION=0M,TIME=NOLIMIT,
    //       PARM=('&LEPRM,ENVAR("_CEE_ENVFILE_S=DD:ENVIRON")/&PRM')
    //STEPLIB  DD DISP=SHR,DSN=&HLQ..SFEKAUTH
    //ENVIRON  DD DISP=SHR,DSN=&CFG
    //SYSPRINT DD SYSOUT=*
    //SYSOUT   DD SYSOUT=*
    //         PEND
    //*
    ****************************************************************
    * Affected function: client logon                              *
    ****************************************************************
    * Description: control port selection by client                *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: /etc/rdz/rsed.envvars                                  *
    *       [/usr/lpp/rdz/samples/rsed.envvars]                    *
    ****************************************************************
    This fix updates the sample rsed.envvars by adding the
    following optional directive:

    #_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dprocess.cleanup.interval=600"
    Automatically remove RSE thread pools that are in an
    unrecoverable error state. By default, erroneous RSE thread
    pools are not automatically removed. Uncomment and customize
    to automatically remove erroneous RSE thread pool servers at
    every interval (interval unit is seconds). Specifying 0
    disables the function.

    Add this directive to your active rsed.envvars (by default
    located in /etc/rdz) if you want to use it.
    ****************************************************************
    * Affected function: JES Job Monitor                           *
    ****************************************************************
    * Description: incorrect time values                           *
    ****************************************************************
    * Timing: post-APPLY                                           *
    ****************************************************************
    * Part: SFEKSAMP(FEJJJCL)                                      *
    ****************************************************************
    When using the _CEE_ENVFILE keyword to define environment
    variables, LE pads these variables with blanks. This padding can
    cause LE to ignore the settings of the TZ variable, in which
    case it uses the GMT timezone.

    LE provided a fix (z/OS 1.8 and higher) in the form of the
    _CEE_ENVFILE_S keyword. Here no padding takes place, and the TZ
    environment variable is interpreted correctly.

    If need be, the _CEE_ENVFILE_S keyword can be used (instead of
    _CEE_ENVFILE) in the startup JCL, as shown in the updated sample
    JCL, FEK.SFEKSAMP(FEJJJCL).

    //*
    //* JES JOB MONITOR
    //*
    //JMON     PROC PRM=,               * PRM='-TV' TO START TRACING
    //            LEPRM='RPTOPTS(ON)',
    //            HLQ=FEK,
    //            CFG=FEK.#CUST.PARMLIB(FEJJCNFG)
    //*
    //JMON     EXEC PGM=FEJJMON,REGION=0M,TIME=NOLIMIT,
    //       PARM=('&LEPRM,ENVAR("_CEE_ENVFILE_S=DD:ENVIRON")/&PRM')
    //STEPLIB  DD DISP=SHR,DSN=&HLQ..SFEKAUTH
    //ENVIRON  DD DISP=SHR,DSN=&CFG
    //SYSPRINT DD SYSOUT=*
    //SYSOUT   DD SYSOUT=*
    //         PEND
    //*).

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

SMP/E RECEIVE and APPLY the fix.