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

The fix is shipped as file IBM.HHOP760.UK54177

The following fixes are prerequisites for this fix:

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
//*
//UK54177    DD DSN=hlq.IBM.HHOP760.UK54177,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(91,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.HHOP760.UK54177
200 Port request OK.
125 Storing data set hlq.IBM.HHOP760.UK54177
250 Transfer completed successfully
5034720 bytes sent in 0.28 seconds
 
ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

++HOLD(UK54177) SYS FMID(HHOP760) REASON(ACTION) DATE(10036)
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: RSE                                       *
****************************************************************
* Description: new variables                                   *
****************************************************************
* 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 directives:
 
#_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.
 
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddeny.nonzero.port=true"
Disallow the client to choose the communication port number.
The default is false. Uncomment and specify true to refuse
connections where the client specifies which host port must
be used by RSE server for the connection.
 
Note:
The port number used by the RSE server is determined in the
following order:
1. If a nonzero port number is specified in the subsystem
properties on the client, then the specified port number
is used. If the port is not available connect will fail.
This setup is not recommended.
Note:
The host can deny this type of connection request by
specifying the deny.nonzero.port=true directive in
rsed.envvars.
2. If the port number in the subsystem properties is 0, and
if _RSE_PORTRANGE is specified in rsed.envvars, then the
port range specified by _RSE_PORTRANGE is used. If no port
in the range is available, connect will fail.
3. If the port number in the subsystem properties is 0, and
_RSE_PORTRANGE is not specified in rsed.envvars, then any
available port is used.
 
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsingle.logon=false"
 
Allow a user ID to log on multiple times. The default is
false. Uncomment and specify true to allow a user ID to log
on multiple times to a single RSE daemon.
 
Note:
A second logon attept will cause the first one to be
cancelled by the host if this directive is not active and set
to false. This cancel will be accompanied by console message
FEK210I.
 
Add these directives to your active rsed.envvars (by default
located in /etc/rdz) if you want to use them.
 
****************************************************************
* Affected function: console message                           *
****************************************************************
* Description: new message, FEK210I                            *
****************************************************************
* Timing: n/a                                                  *
****************************************************************
* Part: n/a                                                    *
****************************************************************
This fix introduces a new console message.
 
FEK210I = {0} canceled owing to duplicate logon
 
The message is issued when the host cancels an existing session
because of a new logon request for that user ID.).
  

Perform SMP/E RECEIVE and APPLY for the fix

SMP/E RECEIVE and APPLY the fix.