The fix is shipped as file IBM.HAKG910.UI55757
The fix has rework (build) date 2018130 (10 May 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.HAKG910.<req>.
The following fixes are superseded by this fix:
AI21624 AI36761 AI38814 AI40871 AI50521 AI56098 AI59418 AI74730 AI87756 AI97799 UI23674 UI26077 UI27246 UI27582 UI32128 UI35709 UI41258 UI44168 UI50667 AI21625 AI36767 AI38819 AI40872 AI50523 AI56099 AI59419 AI74734 AI87757 AI97802 UI23671 UI26078 UI27249 UI27583 UI32129 UI35710 UI41259 UI44169 UI50668 AI36778 AI38825 AI40877 AI50524 AI56104 AI59420 AI74737 AI87764 AI97803 UI23675 UI26079 UI27250 UI27584 UI32130 UI35711 UI41260 UI44170 UI50669 AI31454 AI37279 AI38826 AI39909 AI41042 AI55604 AI56096 AI74747 AI87805 AI97808 UI23675 UI26044 UI26075 UI27251 UI27581 UI32127 UI35708 UI41257 UI44171 UI50670Steps required to install 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 //* //UI55757 DD DSN=hlq.IBM.HAKG910.UI55757, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(3855,770)) //* //UI55758 DD DSN=hlq.IBM.HAKG910.UI55758, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(5050,1010)) //* //UI55759 DD DSN=hlq.IBM.HAKG910.UI55759, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(3817,760)) //* //UI55760 DD DSN=hlq.IBM.HAKG910.UI55760, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(696,130)) //*
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.HAKG910.UI55757 200 Port request OK. 125 Storing data set hlq.IBM.HAKG910.UI55757 250 Transfer completed successfully 215259040 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG910.UI55758 200 Port request OK. 125 Storing data set hlq.IBM.HAKG910.UI55758 250 Transfer completed successfully 281965520 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG910.UI55759 200 Port request OK. 125 Storing data set hlq.IBM.HAKG910.UI55759 250 Transfer completed successfully 213139360 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG910.UI55760 200 Port request OK. 125 Storing data set hlq.IBM.HAKG910.UI55760 250 Transfer completed successfully 38855280 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UI55760) SYS FMID(HAKG910) REASON(ACTION) DATE(18130)
COMMENT
(****************************************************************
* Affected function: RSE daemon *
****************************************************************
* Description: PARMLIB(IFAPRDxx) update *
****************************************************************
* Timing: pre-APPLY *
****************************************************************
* Part: sys1.parmlib(IFAPRDxx) *
****************************************************************
After applying this fix, Rational Developer for System z host
Utilities (Code Coverage and Code Review) will register with
z/OS during startup. If registration fails, for example because
RDzUtil coponents are disabled in SYS1.PARMLIB(IFAPRDxx),
startup of the RDzUtil components will fail also.
If you purchased Developer for System z Host Utilities as part
of product code 5697-CDT, IBM Enterprise COBOL Suite for z/OS,
V1.1 (or later), 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 Enterprise COBOL
Suite for z/OS (product code 5697-CDT):
PRODUCT OWNER('IBM CORP')
NAME('IBM COBOL SUITE')
ID(5697-CDT)
VERSION(*) RELEASE(*) MOD(*)
FEATURENAME(*)
STATE(ENABLED)
Alternatively and optionally, if you purchased Developer for
System z Host Utilities separately (NOT part of Enterprise COBOL
Suite for z/OS), you may include an entry in the IFAPRDxx
parmlib member for Developer for System z Host Utilities using
the stand-alone product code, 5724-T07:
PRODUCT OWNER('IBM CORP')
NAME('IBM RDZ UTIL')
ID(5724-T07)
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).
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). //*
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.HAKG910.UI55757
// DD DISP=SHR,DSN=hlq.IBM.HAKG910.UI55758
// DD DISP=SHR,DSN=hlq.IBM.HAKG910.UI55759
// DD DISP=SHR,DSN=hlq.IBM.HAKG910.UI55760
//SMPCNTL DD *
SET BOUNDARY(GLOBAL) .
RECEIVE SELECT(
UI55757
UI55758
UI55759
UI55760
) SYSMODS LIST .
//*
//APPLY EXEC PGM=GIMSMP,REGION=0M
//SMPCSI DD DISP=OLD,DSN=#globalcsi
//SMPCNTL DD *
SET BOUNDARY(#tzone) .
APPLY SELECT(
UI55757
UI55758
UI55759
UI55760
) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*
Restart started tasks to activate changes.