Macro replacements

One of the steps in actually updating the target libraries is to install macro replacements. Multiple SYSMODs can be applied, each of which can contain a replacement for the same macro. When two or more SYSMODs replacing the same macro are applied concurrently, SMP/E determines the version at the highest function and service level. For a full explanation of how SMP/E determines the functional and service level of an element, see Element selection.

SMP/E then schedules the actual update of the target macro library. The library to be updated is determined from the SYSLIB information in the target zone MAC entry. For further information about the initial setting of the MAC SYSLIB, see Adding new elements other than modules to the target libraries.

If there is no SYSLIB value in the MAC entry, SMP/E looks for a DLIB entry with the same name as the DISTLIB value in the MAC entry and uses the SYSLIB value from the DLIB entry.

Note: In this case, before you run the APPLY command, make sure there is only one SYSLIB subentry in the DLIB entry and that it specifies the ddname of the correct library.

If no SYSLIB is present, the SMPMTS is used as the target macro library. (For further information about the use of the SMPMTS as a target macro library, see Use of the SMPMTS and SMPSTS as target libraries.)

The actual update is done by calling either the copy utility or the update utility.

The copy utility is used in these cases:
- The macro was packaged in a relative file (the RELFILE operand was specified).
- The macro was packaged in a text library (the TXLIB operand was specified) and had no alias names—that is, no MALIAS names are in the target zone MAC entry and no MALIAS operands are on the ++MAC statement.
- The macro was packaged inline, it had no alias name, and the SSI operand was not specified.
The SSI operand is ignored when TXLIB or RELFILE is specified.
The update utility is called in these cases:
- The macro was packaged in a text library, and the element had an alias name.
- The macro was packaged inline, and either it had an alias name or the SSI operand was specified.

Upon return from either utility, SMP/E issues a message indicating whether the macro was replaced successfully.