Although the use of ICEPRMxx members in PARMLIB is the recommended way to change installation defaults (see Using ICEPRMxx members in PARMLIB), you can also change installation defaults using the ICEMAC macro.

See Installation options syntax diagram for the syntax of the installation options you can specify with the ICEMAC macro.

The rules for coding the ICEMAC macro are the same as those for coding IBM assembler language macro statements. ICEMAC must be preceded and followed by at least one blank, and options must be separated by commas. For more complete rules, refer to your assembler language manual.

You must specify one and only one of the following keywords to indicate the installation environment you are modifying: JCL for ICEAM1, INV for ICEAM2, TSO for ICEAM3, TSOINV for ICEAM4, TD1 for ICETD1, TD2 for ICETD2, TD3 for ICETD3 or TD4 for ICETD4. Options must be coded as shown in the syntax diagram, for example, ABCODE=MSG but not ABCODE=(MSG) or ABCODE(MSG). Individual options (such as ABCODE) cannot be repeated.

The ICEMAC macro can be found in the SICEUSER library. The source statement for any installation environment can be found in the AICESRCE library.

To change the IBM-supplied defaults with the ICEMAC macro:

1. Create an SMP/E usermod to modify the ICEMAC macro call in the source statement for any installation environment (ICEAM1, ICEAM2, ICEAM3, ICEAM4, ICETD1, ICETD2, ICETD3, or ICETD4) you want to change in your source distribution library (AICESRCE or a private library). The SMP/E usermod is an IEBUPDTE update. For an SMP/E usermod example, see the ICEOPREC sample job provided on the distribution tape.

   Except for the first line of the statements, you can create your own sequence numbers for your update statements, since the statements result from your source code rather than the IBM-supplied default.

   Your update statements must conform to the syntax requirements of IEBUPDTE, assembler language, and the ICEMAC macro. See z/OS DFSMSdfp Utilities for a description of the IEBUPDTE syntax. Examples and rules for coding the ICEMAC macro are given in Examples of ICEMAC macros.

2. Modify (as instructed in the comments) and run the following sample jobs:

   1. ICEOPREC to RECEIVE the changes.
   2. ICEOPAPP to APPLY the changes.

   MNOTE messages are produced by the assembler program while expanding the ICEMAC statement during the APPLY step. If you violate any of the rules for coding ICEMAC, an appropriate error message will be issued when ICEAM1, ICEAM2, ICEAM3, ICEAM4, ICETD1, ICETD2, ICETD3, or ICETD4 is reassembled during the APPLY step. The ICEMAC error messages (MNOTEs) are explained in ICEMAC and message module messages.

   If you receive an error message:

   1. Correct and recode the statement containing the error.
   2. Run an SMP/E RESTORE to remove the SMP/E usermod. (See SMP/E for z/OS Reference for details).
   3. Run an SMP/E REJECT to remove the SMP/E usermod from the global zone, or add a later REWORK date to the updated SMP/E usermod.
   4. Rerun the RECEIVE and APPLY jobs ICEOPREC and ICEOPAPP.