How To Apply Superzaps to IAM Load Library

Applying IAM PTFs

Fixes to the IAM products are usually provided by BMC CORP in the form of zaps.

These zaps can be applied using the IBM SUPERZAP program (PGM=AMASPZAP or IMASPZAP). In general, if the load library being zapped is in the Link List, then an LLA REFRESH is needed for the zapped modules to be retrieved. Long running address spaces will need to be recycled to pick up the fixed modules.

Zaps to an active IAM VIF module, that is one loaded by the IAMSTART process, can be zapped in storage to take effect immediately. This is usually noted in the text of the fix. Instructions for applying such fixes with PGM=IAMZAP are included with the text of the fix.

Zaps can also be applied to an active IAM/RLS or IAM/PLEX region using the IAM/RLS or IAM/PLEX APPLY command via the z/OS MODIFY if noted in the zap text for immediate effect.

Due to quad-word alignment required for some modules with 64-bit support, the IAM Load Library is required to be distributed with a block of 32760. In order to apply maintenance to some of the load modules, they must reside in a PDSE. While a normal PDS can be used for the IAM Load Library, some modules will need to be temporarily copied to a PDS to apply the maintenance, and can then be copied back to the original load library.

Using AMASPZAP (Superzap)

IAM maintenance is typically applied using the IBM AMASPZAP (or IAMASPZAP) Service Aid program. This program permanently applies to the fixes to the IAM Load Library. And example of the JCL is:

Example of PGM=AMASPZAP JCL

//APPLY    EXEC PGM=AMASPZAP
//SYSLIB    DD DISP=SHR,DSN=iam.load.library
//SYSPRINT DD SYSOUT=*
//SYSIN     DD *
Zap control statements provided by Compuware.
/

Please check for any additional instructions within each PTF for any special instructions that may be required. That information is typically in the “Notes” section of the PTF.

Using IAMZAP

If the use of IAMZAP is recommended, there will be comments in the PTF NOTES section indicating that, along with example JCL. IAMZAP will apply the zap to the copy of the module that is in the common system area of virtual storage. When the LPAR is re-IPL’d the fix will need to be reapplied if it wasn’t applied with PGM=AMASPZAP as shown above.

An example of the JCL is shown below:

Example of using IAMZAP to apply the fix immediately

//APPLY    EXEC PGM=IAMZAP,REGION=0M
//STEPLIB   DD DISP=SNR,DSN=iam.load.library
//SYSLIB    DD DISP=SHR,DSN=iam.load.library
//SYSPRINT DD SYSOUT=*
//SYSIN     DD *
Zap control statements provided by Compuware
/*

A PARM of either PROD or TEST may be required if such was specified on the IAMSTART.

IAM/RLS APPLY Command

Zaps to modules that are in the IAM/LRLS or IAM/PLEX address space can be applied to the virtual storage within that address space using the z/OS Modify command. An example of that command ins shown below:

F iamrlsjobname,APPLY,your.iam.zap.file(membername)

If the fixes have not been applied with PGM=AMASPZAP then the zap will need to be re-applied if IAM/RLS or IAM/PLEX has been recycled.

Fixes applied with the APPLY command can also be backed out with the IAM/RLS RESTORE command.

Listing PTF Information

The IAM fixes also include a IDRDATA that is save in the load module when the fix is installed, This information can be printed out by the IBM Service Aid Program AMBLIST.

Shown it tie JCL to do this.

Example of LISTIDR to print information on the zaps that are applied

//IDRLIST EXEC PGM=AMBLIST
//SYSPRINT DD   SYSOUT-*
//SYSLIB   DD   DISP=SHR,DSN=iam.load.library
//SYSIN    DD   *
LISTIDR MEMBER=modname
/
*