Installation instructions for fix UI41212 for IBM Rational Developer for System z v91 (FMID HHOP910)

The fix is shipped as file IBM.HHOP910.UI41212

The fix has rework (build) date 2016272 (28 Sep 2016)

The following fixes are prerequisites for this fix:

The following fixes are corequisites for this fix:

These requisites can be downloaded from the Developer for z Systems Recommended Fixes page, if not included as file IBM.HHOP910.<req>.

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

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.HHOP910.UI41212
200 Port request OK.
125 Storing data set hlq.IBM.HHOP910.UI41212
250 Transfer completed successfully
28891200 bytes sent in 0.28 seconds
 
ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

++HOLD(UI41212) SYS FMID(HHOP910) REASON(ACTION) DATE(16272)                   
   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:                                             
                                                                                
     #GSK_FIPS_STATE=OFF                                                        
       Specifies whether the FIPS 140-2 standard for encrypted                  
       communication is used. The default is OFF. Uncomment and                 
       specify ON to use encrypted communication that conforms to               
       the FIPS 140-2 standard.                                                 
                                                                                
     ****************************************************************           
     * 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: work files                                *           
     ****************************************************************           
     * Description: add sticky bit to shared directory              *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.SFEKSAMP(FEKSETUP)                                 *           
     *       [FEK.#CUST.JCL(FEKSETUP)]                              *           
     ****************************************************************           
     This maintenance adds the sticky bit (+t) to the shared work               
     directories.                                                               
                                                                                
     It is advised for existing setups to repeat this action manually           
     chmod +t /var/rdz/WORKAREA                                                 
     chmod +t /var/rdz/logs                                                     
                                                                                
     ****************************************************************           
     * Affected function: CA Endevor SCM(R) interface               *           
     ****************************************************************           
     * Description: new option                                      *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.#CUST.PARMLIB(CRACFG)                              *           
     *       [FEK.SFEKSAMP(CRACFG)]                                 *           
     ****************************************************************           
     This fix updates configuration file CRACFG, which is used by               
     Edit support for CA Endevor(R) SCM.                                        
                                                                                
     # DYNAMIC-FB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to fixed blocked (FB) data sets with              
       different (not 80) record lengths (LRECL).                               
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DYNAMIC-VB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to variable blocked (VB) data sets with           
       different record lengths (LRECL).                                        
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DATASET-ALLOC-OVERRIDE                                                   
       Uncomment and specify allocation options to override default             
       values used by Developer for System z to dynamically allocate            
       work data sets.                                                          
       This directive is only honored if DYNAMIC-VB-DATASET-ALLOC or            
       DYNAMIC-FB-DATASET-ALLOC is YES.                                         
       The options specified here must adhere to TSO ALLOCATE rules.            
       Default allocation parameters are taken from the BROWSEV (for            
       VB) and BROWSE (for FB) allocation done by SFELPROC(CRANDVRA).           
     ****************************************************************           
     * Affected function: console messages                          *           
     ****************************************************************           
     * Description: new message, FEJ211I                            *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: n/a                                                    *           
     ****************************************************************           
     This maintenance introduces a new console message for JES                  
     Job Monitor, where %0 is replaced with the JES Job Monitor port            
     number:                                                                    
                                                                                
     FEJ211I Server ready to accept connections on port %0                      
     ****************************************************************           
     * Affected function: work files                                *           
     ****************************************************************           
     * Description: add sticky bit to shared directory              *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.SFEKSAMP(FEKSETUP)                                 *           
     *       [FEK.#CUST.JCL(FEKSETUP)]                              *           
     ****************************************************************           
     This maintenance adds the sticky bit (+t) to the shared work               
     directories.                                                               
                                                                                
     It is advised for existing setups to repeat this action manually           
     chmod +t /var/rdz/WORKAREA                                                 
     chmod +t /var/rdz/logs                                                     
     ****************************************************************           
     * Affected function: CA Endevor SCM(R) interface               *           
     ****************************************************************           
     * Description: new option                                      *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.#CUST.PARMLIB(CRACFG)                              *           
     *       [FEK.SFEKSAMP(CRACFG)]                                 *           
     ****************************************************************           
     This fix updates configuration file CRACFG, which is used by               
     Edit support for CA Endevor(R) SCM.                                        
                                                                                
     # DYNAMIC-FB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to fixed blocked (FB) data sets with              
       different (not 80) record lengths (LRECL).                               
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DYNAMIC-VB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to variable blocked (VB) data sets with           
       different record lengths (LRECL).                                        
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DATASET-ALLOC-OVERRIDE                                                   
       Uncomment and specify allocation options to override default             
       values used by Developer for System z to dynamically allocate            
       work data sets.                                                          
       This directive is only honored if DYNAMIC-VB-DATASET-ALLOC or            
       DYNAMIC-FB-DATASET-ALLOC is YES.                                         
       The options specified here must adhere to TSO ALLOCATE rules.            
       Default allocation parameters are taken from the BROWSEV (for            
       VB) and BROWSE (for FB) allocation done by SFELPROC(CRANDVRA).           
     ****************************************************************           
     * Affected function: CA Endevor SCM(R) interface               *           
     ****************************************************************           
     * Description: new option                                      *           
     ****************************************************************           
     * Timing: post-APPLY                                           *           
     ****************************************************************           
     * Part: FEK.#CUST.PARMLIB(CRACFG)                              *           
     *       [FEK.SFEKSAMP(CRACFG)]                                 *           
     ****************************************************************           
     This fix updates configuration file CRACFG, which is used by               
     Edit support for CA Endevor(R) SCM.                                        
                                                                                
     # DYNAMIC-FB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to fixed blocked (FB) data sets with              
       different (not 80) record lengths (LRECL).                               
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DYNAMIC-VB-DATASET-ALLOC                                                 
       Uncomment and specify YES if some of the CA Endevor(R) SCM               
       TYPE definitions point to variable blocked (VB) data sets with           
       different record lengths (LRECL).                                        
       Note that enabeling this option impacts performance, as                  
       Developer for System z will now allocate a work data set with            
       the correct record length for each member being processed.               
                                                                                
     # DATASET-ALLOC-OVERRIDE                                                   
       Uncomment and specify allocation options to override default             
       values used by Developer for System z to dynamically allocate            
       work data sets.                                                          
       This directive is only honored if DYNAMIC-VB-DATASET-ALLOC or            
       DYNAMIC-FB-DATASET-ALLOC is YES.                                         
       The options specified here must adhere to TSO ALLOCATE rules.            
       Default allocation parameters are taken from the BROWSEV (for            
       VB) and BROWSE (for FB) allocation done by SFELPROC(CRANDVRA).).         
  

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.

This step can be skipped if there are no prerequisites, or if there is a reason to not make a prerequisite permanent.

You can accept the prerequisites 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(
     UI23762
     UI26082
     UI32110
     UI35670
   ) 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.HHOP910.UI41212
//SMPCNTL  DD *
   SET BOUNDARY(GLOBAL) .
   RECEIVE SELECT(
     UI41212
   ) SYSMODS LIST .
//*
//APPLY    EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#tzone) .
   APPLY SELECT(
     UI41212
   ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Restart started tasks to activate changes

Restart started tasks to activate changes.