Obtaining the required modules

To find a usable copy of each module specified on the MODULE operand, SMP/E checks the MOD entries in the target zone specified on the FROMZONE operand. SMP/E determines whether the modules have been installed in a target library (and are available for linking) by checking whether each MOD entry has both an FMID and an RMID value. If so, SMP/E checks the target zone MOD entry to determine whether there is a stand-alone version of the module that can be used for the link-edit. A stand-alone version exists in either of these cases:

The module was copied into a target library from a distribution library. (It is in a copied library.)
The module exists by itself in a load module in a target library. (It is a single-CSECT load module.)

If SMP/E finds a stand-alone copy of the module, it saves the name of its target library for subsequent use in link-edit processing.

If SMP/E cannot find a stand-alone copy of a module in a target library, it checks the related distribution zone to determine whether a distribution library contains a usable copy. If there is a MOD entry in the distribution zone, SMP/E checks whether it contains both an FMID and an RMID value. If so, the module has been accepted into a distribution library, and a usable copy for the link-edit exists. SMP/E saves the name of the distribution library for subsequent use in link-editing the load module. In addition, SMP/E compares the distribution zone MOD entry to the related target zone MOD entry to determine whether they are at the same level. If they are at different levels, a warning message is issued, but the distribution zone copy of the module is still used for the link-edit.

Note:

If the two copies of the module are at different levels, you may want to synchronize the target zone version of the module with the distribution zone version. You can do this by accepting any applied SYSMODs that affect the module, or by restoring applied SYSMODs. Once the synchronization is done, you may want to use the LINK MODULE command again to relink the module into the load module.
SMP/E does not assemble a module in order to use it with the LINK MODULE command. The module must exist as a load module so it can serve as input to the link-edit utility.
If the load module already contains a copy of the module (for example, as a result of previous LINK MODULE command processing), SMP/E does not check whether the copy of the module about to be linked into the load module is at an equal or higher level than the previous copy.

The following types of errors cause the LINK MODULE command to fail:

No MOD entry was found in the FROMZONE target zone for a module specified on the MODULE operand.
A module specified on the MODULE operand was not installed into a target library (its MOD entry in the FROMZONE target zone is missing either an FMID, an RMID, or both).
There is no stand-alone version of a module in the target library, and one of the following errors was also found:
- No related distribution zone is defined for the FROMZONE target zone.
- SMP/E cannot obtain access to the related distribution zone.
- No MOD entry exists in the distribution zone.