Source replacements

Another step in actually updating the target libraries is the installation of source replacements. Multiple SYSMODs can be applied, each of which can contain a replacement for the same source.

When two or more SYSMODs replacing the same source are applied concurrently, SMP/E determines the version at the highest function and service level. For 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 source library. The library to be updated is determined from the SYSLIB information in the target zone SRC entry. For further information about the initial setting of the SRC SYSLIB, see Adding new elements other than modules to the target libraries.

If there is no SYSLIB value in the SRC entry, SMP/E looks for a DLIB entry with the same name as the DISTLIB value in the SRC entry and uses the SYSLIB value from that 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 target library.

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

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

The copy utility is used if the source replacement resides in either a text library (that is, the TXLIB operand was specified) or in a RELFILE (the RELFILE operand was specified). When TXLIB or RELFILE is specified, the SSI operand is ignored.
The update utility is called if the source replacement was contained inline and the SSI operand was specified.

Upon return from either utility, SMP/E issues a message indicating whether the source has been replaced successfully.