INSERTS positions a control section or named common area within the program module or within overlay segments in an overlay structure. This specification is overridden by the order specified on an ORDERS call.
The syntax of the INSERTS call is:
[symbol] | IEWBIND | FUNC=INSERTS [,VERSION=version] |
The INSERTS function is valid only when the processing intent is BIND.
In an overlay structure, INSERTS places the section within the overlay segment defined by the preceding OVERLAY control statement or STARTS function. Sections named on insert functions that precede the first STARTS, as well as those not named on any insert statements, are placed in the root segment.
The common binder API reason codes are shown in Table 1.
Return Code | Reason Code | Explanation |
---|---|---|
00 | 00000000 | Normal completion. Positioning of section will take place during bind operation. |
04 | 83000711 | An insert was already processed for this section, and has been replaced. |
12 | 83000104 | INSERT is not valid against a workmod specified with INTENT=ACCESS. Request rejected. |
If your program does not use the IEWBIND macro, place the address of the INSERTS parameter list in general purpose register 1.
PARMLIST | DS | 0F | |
DC | A(INSERTS) | Function code | |
DC | A(RETCODE) | Return code | |
DC | A(RSNCODE) | Reason code | |
DC | A(WORKMOD) | Workmod token | |
DC | A(SECTION+X'80000000') | Section name and end-of-list indicator | |
INSERTS | DC | H'36' | INSERTS function code |
DC | H'version' | Interface version number | |