Installation instructions for fix UI59304 for IBM Rational Developer for z Systems Host Utilities v9.5 (FMID HAKG951)

The fix is shipped as file IBM.HAKG951.UI59304

The fix has rework (build) date 2018297 (24 Oct 2018)

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>.

The following fixes are superseded by this fix:

AH04144 AI55453 AI56497 AI69743 AI72068 AI74771 AI77627 AI83806 AI91183 AI93927 UI35034 UI38160 UI41937 UI42733 UI44928 UI46693 UI52252 UI53384 UI57475 AH00807 AH04148 AI55454 AI56501 AI69753 AI72079 AI74772 AI77638 AI82320 AI92745 UI35035 UI38161 UI41938 UI42734 UI44929 UI46694 UI52251 UI53385 UI57476 AH00813 AH04157 AI55455 AI56513 AI69780 AI72080 AI74773 AI77645 AI81798 AI92747 UI35036 UI38162 UI41939 UI42735 UI44930 UI46695 UI52250 UI53386 UI57477 AH00818 AH04160 AI55439 AI56494 AI69783 AI72390 AI74774 AI77654 AI80458 AI92748 UI35033 UI38159 UI41940 UI42736 UI44931 UI46696 UI52249 UI53387 UI57503

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
//*
//UI59304    DD DSN=hlq.IBM.HAKG951.UI59304,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4767,950))
//*
//UI59305    DD DSN=hlq.IBM.HAKG951.UI59305,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4193,830))
//*
//UI59306    DD DSN=hlq.IBM.HAKG951.UI59306,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(4295,850))
//*
//UI59307    DD DSN=hlq.IBM.HAKG951.UI59307,
//            DISP=(NEW,CATLG,DELETE),
//            DSORG=PS,
//            RECFM=FB,
//            LRECL=80,
//            UNIT=SYSALLDA,
//*            VOL=SER=volser,
//*            BLKSIZE=6160,
//            SPACE=(TRK,(690,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.UI59304
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI59304
250 Transfer completed successfully
266141520 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI59305
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI59305
250 Transfer completed successfully
234127840 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI59306
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI59306
250 Transfer completed successfully
239822640 bytes sent in 0.28 seconds
 
ftp> put d:\IBM.HAKG951.UI59307
200 Port request OK.
125 Storing data set hlq.IBM.HAKG951.UI59307
250 Transfer completed successfully
38524480 bytes sent in 0.28 seconds
 
ftp> quit
221 Quit command received. Goodbye.

SMP/E hold information for the fix

none
  

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

Restart started tasks to activate changes

Restart started tasks to activate changes.