IMASPZAP (or, more correctly, AMASPZAP, as IMASPZAP is actually an alias for the load module stored under the name AMASPZAP) is the IBM supplied utility for applying patches to object modules. The load module resides in SYS1.LINKLIB and is installed during System Generation.
IMASPZAP frequently drives auditors into a frenzy, because it may be used to indiscriminately alter instructions in load modules without leaving any audit trail. However, the functions it provides to the toolbox of the system programmer are irreplaceable and the load module for the utility generally resides in some (or several) library on any IBM system, regardless of the dictates of whatever team of auditors recently paraded through the installation.
The functions provided by IMASPZAP are:
Control statements are used to control the functions of IMASPZAP. They are read from SYSIN, or from the MVS Operator's console if a CONSOLE control statement is included in the SYSIN input. The acceptable control statements are:
As each control statement is read it is written to the SYSPRINT dataset and then the operation is performed before obtaining the next control statement. When an error occurs during an operation, an error message is written to the SYSPRINT device immediately below the control statement in error. If the console option is in effect, error messages are written to the console as well as the SYSPRINT dataset.
All data that is dumped is written to the SYSPRINT dataset in hexadecimal. If translation was specified, the mnemonic representation of each halfword of data is printed below the respective two bytes of hex data and the EBCDIC representation of the hex data is translated to the right of the hex data in the dump.
If a REPlace operation is performed on a load module, the SSI and IDR information are updated automatically.
IMASPZAP utilizes system open. Hence, IMASPZAP cannot modify read only or inspect write only password protected datasets unless the correct password is provided at the time the dataset is opened. Also, unexpired datasets cannot be modified unless the operator replies R 00,'U' to the expiration message that is issued when the dataset is opened.
The SYSLIB DD cannot specify a concatenated dataset.
SYSLIB DD must specify DSN=FORMAT4.DSCB if operations are to be performed on a
Volume Table of Contents (VTOC).
Replace SVC 14 (0A0E) instruction in load module with SLR 15,15 (1FFF):
Print formatted dump of all CSECTs of a load module:
Print dump of all records in an Indexed-Sequential Organization dataset:
I hope that you have found my instructions useful. If you have questions that I can answer to help expand upon my explanations and examples shown here, please don't hesitate to send them to me:
This page was last updated on April 06, 2004 .