Installation instructions for fix UI46693 for IBM Rational Developer for z Systems Host Utilities v95 (FMID HAKG951)

The fix is shipped as file IBM.HAKG951.UI46693

The fix has rework (build) date 2017115 (25 Apr 2017)

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.HAKG951.<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
//*
//UI46693    DD DSN=hlq.IBM.HAKG951.UI46693,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4138,820))
//*
//UI46694    DD DSN=hlq.IBM.HAKG951.UI46694,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4151,830))
//*
//UI46695    DD DSN=hlq.IBM.HAKG951.UI46695,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4241,840))
//*
//UI46696    DD DSN=hlq.IBM.HAKG951.UI46696,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(686,130))
//*

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.HAKG951.UI46693
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI46693
250 Transfer completed successfully
231016800 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI46694
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI46694
250 Transfer completed successfully
231743840 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI46695
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI46695
250 Transfer completed successfully
236809680 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI46696
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI46696
250 Transfer completed successfully
38283280 bytes sent in 0.28 seconds
 
ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

++HOLD(UI46696) SYS FMID(HAKG951) REASON(ACTION) DATE(17115)                   
   COMMENT                                                                      
    (****************************************************************           
     * Affected function: product registration                      *           
     ****************************************************************           
     * Description: PARMLIB(IFAPRDxx) update                        *           
     ****************************************************************           
     * Timing: pre-APPLY                                            *           
     ****************************************************************           
     * Part: sys1.parmlib(IFAPRDxx)                                 *           
     ****************************************************************           
     After applying this fix, Rational Developer for z Systems Host             
     Utilities will be able to register as being a part of                      
     "IBM Application Delivery Foundation for z Systems".                       
                                                                                
     If you purchased Developer for z Systems Host Utilities as part            
     of product code 5697-CDT, IBM Application Delivery Foundation              
     for z Systems, and have not already done so for another program            
     in product code 5697-CDT, include an entry in the IFAPRDxx                 
     parmlib member to enable the related programs.                             
     Define PROD=xx in the IEASYSxx parmlib member to specify which             
     IFAPRDxx parmlib member should be used during IPL.                         
                                                                                
     Specify the following in IFAPRDxx to define IBM Application                
     Delivery Foundation for z Systems (product code 5697-CDT):                 
                                                                                
     PRODUCT OWNER('IBM CORP')                                                  
     NAME('IBM APP DLIV FND')                                                   
     ID(5697-CDT)                                                               
     VERSION(*) RELEASE(*) MOD(*)                                               
     FEATURENAME(*)                                                             
     STATE(ENABLED)                                                             
                                                                                
     After the IFAPRDxx parmlib member is updated, it can be                    
     activated dynamically (until the next IPL) with the following              
     console command:                                                           
                                                                                
     SET PROD=xx).                                                              
  

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(
   ) 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.HAKG951.UI46693
//         DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI46694
//         DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI46695
//         DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI46696
//SMPCNTL  DD *
   SET BOUNDARY(GLOBAL) .
   RECEIVE SELECT(
     UI46693
     UI46694
     UI46695
     UI46696
   ) SYSMODS LIST .
//*
//APPLY    EXEC PGM=GIMSMP,REGION=0M
//SMPCSI   DD DISP=OLD,DSN=#globalcsi
//SMPCNTL  DD *
   SET BOUNDARY(#tzone) .
   APPLY SELECT(
     UI46693
     UI46694
     UI46695
     UI46696
   ) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*

Restart started tasks to activate changes

Restart started tasks to activate changes.