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

The fix is shipped as file IBM.HHOP760.UK96854

The fix has rework (build) date 2013232 (20 Aug 2013)

The following fixes are prerequisites for this fix:

These prerequisites can be downloaded from the Developer for System z Recommended Fixes page, if not included as file IBM.HHOP760.<prereq>.

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 ACCEPT for the prerequisites.
  5. Perform SMP/E RECEIVE and APPLY for the fix.
  6. Restart started tasks to activate changes.

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

SMP/E hold information for the fix

++HOLD(UK96854) SYS FMID(HHOP760) REASON(ACTION) DATE(13232)                   
   COMMENT                                                                      
    (****************************************************************           
     * Affected function: RSE                                       *           
     ****************************************************************           
     * Description: new environment variables                       *           
     ****************************************************************           
     * Timing: pre-APPLY                                            *           
     ****************************************************************           
     * Part: /usr/lpp/rdz/samples/rsed.envvars                      *           
     *       [/etc/rdz/rsed.envvars]                                *           
     ****************************************************************           
     This fix updates the sample rsed.envvars by adding the                     
     following optional directives:                                             
                                                                                
     #_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsearch.server.limit.timeout=0"            
                                                                                
     When set, this optional variable limits how long a search will             
     be allowed to run (specified in seconds) before the server ends            
     it. When set to zero, there is no limit.                                   
                                                                                
     ****************************************************************           
     * Affected function: RSE                                       *           
     ****************************************************************           
     * Description: new environment variables                       *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: /usr/lpp/rdz/samples/rsed.envvars                      *           
     *       [/etc/rdz/rsed.envvars]                                *           
     ****************************************************************           
     This fix updated sample file rsed.envvars.                                 
     Redo your customizations, if any, after applying this                      
     maintenance.                                                               
     ****************************************************************           
     * Affected function: JES Job Monitor                           *           
     ****************************************************************           
     * Description: altered TCP/IP bind                             *           
     ****************************************************************           
     * Timing: pre-APPLY                                            *           
     ****************************************************************           
     * Part: FEK.SFEKAUTH(FEJJMON)                                  *           
     ****************************************************************           
     This fix changes JES Job Monitor to bind to the loopback                   
     address only. This change is incompatible with older RDz                   
     servers that expect JMON to bind to the default IP stack.                  
                                                                                
     By specifying LOOPBACK_ONLY=OFF in FEJJCNFG you instruct the               
     JMON server to bind to the default stack and the loopback                  
     address. This allows both older and the current RDz server to              
     connect to a single JMON server.                                           
                                                                                
     ****************************************************************           
     * Affected function: JES Job Monitor                           *           
     ****************************************************************           
     * Description: config file update                              *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.#CUST.PARMLIB(FEJJCNFG)                            *           
     *       [FEK.SFEKSAMP(FEJJCNFG)]                               *           
     ****************************************************************           
     This fix updates the sample FEJJCNFG member:                               
     1. add optional directive                                                  
     #LOOPBACK_ONLY=ON                                                          
                                                                                
     LOOPBACK_ONLY                                                              
       Defines whether JES Job Monitor binds to the loopback address            
       only, or to every available TCP/IP stack. Binding to loopback            
       is more secure, because only tasks local to this z/OS system             
       will be able to contact JES Job Monitor. The default is ON.              
       Uncomment this directive and specify OFF if you want JES Job             
       Monitor to bind to all TCP/IP stacks.                                    
                                                                                
     2. remove optional directive                                               
     #_BPXK_SETIBMOPT_TRANSPORT=TCPIP                                           
                                                                                
       As the loopback address has no TCP/IP stack affinity, support            
       for _BPXK_SETIBMOPT_TRANSPORT has been removed.                          
     ****************************************************************           
     * Affected function: RSE                                       *           
     ****************************************************************           
     * Description: EAV support                                     *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: n/a                                                    *           
     ****************************************************************           
     This fix adds EAV (Extended Address Volume) support to RSE.                
                                                                                
     Also, after applying this fix, v851 and higher clients can                 
     specifiy EATTR(NO|OPT) for EAV dataset allocation.                         
     ****************************************************************           
     * Affected function: console messages                          *           
     ****************************************************************           
     * Description: new console message                             *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: n/a                                                    *           
     ****************************************************************           
     This maintenance introduces new console messages                           
                                                                                
     FEK215W = Command {0} is not processed by all thread pools                 
     FEK216W = Unable to process command, busy processing previous              
       command                                                                  
                                                                                
     These messages can be shown when there is a problem processing             
     operator commands.                                                         
                                                                                
     FEK106E = No Resource Bundle of {0}                                        
                                                                                
     This message is shown when a properties file cannot be found.              
                                                                                
     ****************************************************************           
     * Affected function: console messages                          *           
     ****************************************************************           
     * Description: changed message, FEK210I                        *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: n/a                                                    *           
     ****************************************************************           
     This maintenance changes the text of console message                       
                                                                                
     FEK210I = {0} was disconnected forcibly because of the active              
       single.logon directive.                                                  
                                                                                
     ****************************************************************           
     * Affected function: RSED operator commands                    *           
     ****************************************************************           
     * Description: new RSED operator command                       *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: n/a                                                    *           
     ****************************************************************           
     This service introduces a new operator command for the RSED                
     started task.                                                              
                                                                                
     MODIFY RSED,APPL=DEBUG CG,PID=pid                                          
       Request a Java Garbage Collection for a specified thread pool,           
       where pid is the process ID of an RSE thread pool.                       
                                                                                
     ****************************************************************           
     * Affected function: data set lock                             *           
     ****************************************************************           
     * Description: limit delays in releasing data set locks        *           
     ****************************************************************           
     * 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 non-customizable directive:                                      
                                                                                
     _RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dlock.info.timeout=10000"                   
                                                                                
     Add this directive to your active rsed.envvars (by default                 
     located in /etc/rdz).                                                      
                                                                                
     ****************************************************************           
     * Affected function: RSE                                       *           
     ****************************************************************           
     * Description: updated environment variable                    *           
     ****************************************************************           
     * Timing: pre-APPLY                                            *           
     ****************************************************************           
     * Part: /usr/lpp/rdz/samples/rsed.envvars                      *           
     *       [/etc/rdz/rsed.envvars]                                *           
     ****************************************************************           
     This fix updates the sample rsed.envvars by altering the                   
     following non-customizable directive:                                      
                                                                                
     _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDSTORE_SPIRIT_ON=false"                    
     (previous value was true)                                                  
       Note that even if you don't update the variable in                       
       rsed.envvars, RSE will treat it as being false.                          
                                                                                
     Update this directive in your active rsed.envvars (by default              
     located in /etc/rdz) if you want to use it.                                
     ****************************************************************           
     * 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.                                                                   
     - added DD REFORMAT to present refomatted logs                             
                                                                                
     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 fix updated sample member SFEKSAMP(FEKLOGS).                          
     Redo your customizations, if any, after applying this                      
     maintenance.).                                                             
  

Perform SMP/E ACCEPT for the prerequisites

SMP/E ACCEPT the prerequisites to facilitate an easy backout of the fix, if required. Note that once accepted, you cannot backout the accepted prerequisites.

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.

//*
//* Change #globalcsi to the data set name of your global CSI.
//* Change #dzone to your CSI distribution zone name.
//*
//ACCEPT   EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#dzone) .
   ACCEPT SELECT(
                 UK81273
                 UK74316
                 UK69574
                 UK63066
                 UK57122
                 UK54177
          ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Perform SMP/E RECEIVE and APPLY for the fix

SMP/E RECEIVE and APPLY the fix.

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.

//*
//* Change hlq to the high level qualifier used to upload the fix.
//* Change (2x) #globalcsi to the data set name of your global CSI.
//* Change #tzone to your CSI target zone name.
//*
//RECEIVE  EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPPTFIN DD DISP=SHR,DSN=hlq.IBM.HHOP760.UK96854
//SMPCNTL  DD *
   SET BOUNDARY(GLOBAL) .
   RECEIVE SELECT(UK96854) SYSMODS LIST .
//*
//APPLY    EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#tzone) .
   APPLY SELECT(UK96854) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Restart started tasks to activate changes

Restart started tasks to activate changes.