INSERTS: Insert section

z/OS MVS Program Management: Advanced Facilities

INSERTS: Insert section

z/OS MVS Program Management: Advanced Facilities
SA23-1392-00

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]
[,RETCODE=retcode]
[,RSNCODE=rsncode]
,WORKMOD=workmod
,SECTION=section

FUNC=INSERTS: Requests that a specified control section be positioned at the current location within the program module or overlay segment.
VERSION=1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Specifies the version of the parameter list to be used. The default value is VERSION=1.
RETCODE=retcode — RX-type address or register (2-12): Specifies the location of a fullword integer that is to receive the return code returned by the binder.
RSNCODE=rsncode — RX-type address or register (2-12): Specifies the location of a 4-byte hexadecimal string that is to receive the reason code returned by the binder.
WORKMOD=workmod — RX-type address or register (2-12): Specifies the location of an 8-byte area that contains the workmod token for this request.
SECTION=section — RX-type address or register (2-12): Specifies the location of a 16-byte varying character string that contains the name of the control section or named common area to be inserted at the current location.

Processing notes

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.

Return and reason codes

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.

Parameter list

If your program does not use the IEWBIND macro, place the address of the INSERTS parameter list in general purpose register 1.

Table 1. INSERTS parameter list

`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