The fix is shipped as file IBM.HAKG951.UI53384
The fix is shipped as file IBM.HAKG951.UI53385
The fix is shipped as file IBM.HAKG951.UI53386
The fix is shipped as file IBM.HAKG951.UI53387
The fix has rework (build) date 2018023 (23 Jan 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:
AI55453 AI56497 AI69743 AI72068 AI74771 AI77627 AI83806 AI91183 UI35034 UI38160 UI41937 UI42733 UI44928 UI46693 UI52252 AI55454 AI56501 AI69753 AI72079 AI74772 AI77638 AI82320 AI92745 UI35035 UI38161 UI41938 UI42734 UI44929 UI46694 UI52251 AI55455 AI56513 AI69780 AI72080 AI74773 AI77645 AI81798 AI92747 UI35036 UI38162 UI41939 UI42735 UI44930 UI46695 UI52250 AI55439 AI56494 AI69783 AI72390 AI74774 AI77654 AI80458 AI92748 UI35033 UI38159 UI41940 UI42736 UI44931 UI46696 UI52249Steps 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 //* //UI53384 DD DSN=hlq.IBM.HAKG951.UI53384, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(4767,950)) //* //UI53385 DD DSN=hlq.IBM.HAKG951.UI53385, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(4193,830)) //* //UI53386 DD DSN=hlq.IBM.HAKG951.UI53386, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(4295,850)) //* //UI53387 DD DSN=hlq.IBM.HAKG951.UI53387, // DISP=(NEW,CATLG,DELETE), // DSORG=PS, // RECFM=FB, // LRECL=80, // UNIT=SYSALLDA, //* VOL=SER=volser, //* BLKSIZE=6160, // SPACE=(TRK,(687,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.HAKG951.UI53384 200 Port request OK. 125 Storing data set hlq.IBM.HAKG951.UI53384 250 Transfer completed successfully 266143600 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG951.UI53385 200 Port request OK. 125 Storing data set hlq.IBM.HAKG951.UI53385 250 Transfer completed successfully 234127680 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG951.UI53386 200 Port request OK. 125 Storing data set hlq.IBM.HAKG951.UI53386 250 Transfer completed successfully 239789280 bytes sent in 0.28 seconds ftp> put d:\IBM.HAKG951.UI53387 200 Port request OK. 125 Storing data set hlq.IBM.HAKG951.UI53387 250 Transfer completed successfully 38324560 bytes sent in 0.28 seconds ftp> quit 221 Quit command received. Goodbye.
++HOLD(UI53387) SYS FMID(HAKG951) REASON(ACTION) DATE(18023)
COMMENT
(****************************************************************
* Affected function: batch code review *
****************************************************************
* Description: new meaning for return codes *
****************************************************************
* Timing: post-APPLY *
****************************************************************
* Part: AKG.SAKGSAMP(AKGCR) *
****************************************************************
This fix changes the meaning of some of the AKGCR return codes.
new meaning, old meaning moved to return code 8
4: processing did not complete for one or more files
the most severe review violation is a syntax error (15)
the generated code review output is valid, but excludes
results for the file(s) with a syntax error
the (optional) post-processing script executed successfully
new meaning matches old return code 4
old meaning moved to return code 9
8: warning, non-critical issues were encountered
the state of the code review violations is unknown
the state of the generated code review output is unknown
the state of the post-processing script is unknown
previously not used
meaning matches old return code 8
9: error, critical issues were encountered
the generated code review output is not valid
****************************************************************
* 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).
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.HAKG951.UI53384
// DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI53385
// DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI53386
// DD DISP=SHR,DSN=hlq.IBM.HAKG951.UI53387
//SMPCNTL DD *
SET BOUNDARY(GLOBAL) .
RECEIVE SELECT(
UI53384
UI53385
UI53386
UI53387
) SYSMODS LIST .
//*
//APPLY EXEC PGM=GIMSMP,REGION=0M
//SMPCSI DD DISP=OLD,DSN=#globalcsi
//SMPCNTL DD *
SET BOUNDARY(#tzone) .
APPLY SELECT(
UI53384
UI53385
UI53386
UI53387
) REDO COMPRESS(ALL) BYPASS(HOLDSYS,HOLDERROR).
//*
Restart started tasks to activate changes.