Loading the relative files

SMP/E uses IEBCOPY or a user-defined copy utility to load the relative files into the SMPTLIB data sets. (A user-defined utility is specified through OPTIONS and UTILITY entries.) Each element defined by an MCS in the SYSMOD is selectively copied, including each ALIAS, DALIAS, TALIAS, and MALIAS name. This selective copying ensures that the relative files contain the correct elements. If the copy is successful, any unused space in the SMPTLIB data sets is released.

Note:

Any required aliases must be in the distribution libraries before the libraries are put into relative files. Relative files represent distribution library data sets for a function. When SMP/E loads the relative files, it copies in only members from the unloaded data sets; it does not cause aliases to be created for those members.
Errors can occur if the DSNTYPE value for a RELFILE is incompatible with the associated SMPTLIB data set or with the system on which you are running. Here are some examples:
- An SMPTLIB data set was preallocated with a DSNTYPE value that is incompatible with that of the associated RELFILE data set, and the RELFILE data set contains ++MOD elements for load modules or program objects.
- An SMPTLIB data set was dynamically allocated, SMP/E could not determine the DSNTYPE value of the associated RELFILE data set, and the RELFILE data set contains ++MOD elements for load modules or program objects.
- The system on which you are running does not support program objects, and RECEIVE is attempting to copy program objects from a RELFILE data set into an SMPTLIB data set.

When a SYSMOD has been received and its relative files have been loaded, SMP/E saves the high-level qualifier for the SMPTLIB data sets as the TLIBPREFIX value in the global zone SYSMOD entry for that SYSMOD. You can change the DSPREFIX value in the DDDEF or OPTIONS entry that was used without affecting any SYSMODs that have already been received.

Sometimes errors occur while the SMPTLIB data sets are being allocated or the relative files are being unloaded. In this case, the return code from IEBCOPY may be higher than the SMP/E default value or the maximum return code value defined in the COPY UTILITY entry that is in effect. If such an error occurs, SMP/E cannot receive the SYSMOD, and it deletes all the SMPTLIB data sets associated with that SYSMOD, even if they were preallocated.