Invoking the linkage editor from a program

You can pass control to the linkage editor from a program using the LINK, ATTACH, LOAD, CALL, and XCTL macros using either 24-bit or 31-bit addressing. You must supply a save area address in register 13.

The linkage editor is invoked using the HEWLKED program name, or one of these aliases: HEWLF064, IEWLF440, IEWLF880, or IEWLF128.

The use of these macros is identical to usage for the binder with the exception of the ddname list passed as a parameter on LINK, ATTACH, CALL, and XCTL calls.

The sequence of the 8-byte entries in the ddname list for the linkage editor is as follows:

Entry: Alternate Name For:
1: SYSLIN
2: Member name (The name under which the output load module is stored in the SYSLMOD data set. This entry is used if the name is not specified on the SYSLMOD DD statement or if there is no NAME control statement.)
3: SYSLMOD
4: SYSLIB
5: Not applicable
6: SYSPRINT
7: Not applicable
8: SYSUT1
9-11: Not applicable
12: SYSTERM

Note:

The linkage editor supports all data sets allocated in the extended addressing space (EAS) of an extended address volume (EAV).
The linkage editor does not support the following dynamic allocation (DYNALLOC or SVC 99) options for any data sets: S99TIOEX(XTIOT), S99ACUCB(NOCAPTURE), and S99DSABA(DSAB above the line).

When the linkage editor completes processing, a return code is returned in register 15 (see Linkage editor return codes for a list of linkage editor return codes).