z/OS MVS Program Management: User's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


INSERT statement

z/OS MVS Program Management: User's Guide and Reference
SA23-1393-00

We do not recommend using the INSERT and OVERLAY statements for program objects. The binder supports the overlay format for compatibility only. If you use the OVERLAY statement, a program object will be created with a compatibility level of PM1 and, therefore, will not make use of the binder enhancements available in later releases. For more information on the use of the INSERT statement, see Designing and specifying overlay programs.

The INSERT statement repositions a section from its position in the input sequence to a segment in an overlay structure. However, the sequence of sections within a segment is not necessarily the order of the INSERT statements.

If a symbol specified in the operand field of an INSERT statement is not present in the external symbol dictionary, it is entered as an external reference. If the reference has not been resolved at the end of primary input processing, the binder attempts to resolve it from the automatic call library. The syntax of the INSERT statement is:

INSERT          sectionname[,sectionname]...
sectionname
The name of the section to be repositioned. A particular section can appear only once within a program object or load module.
Placement: The INSERT statement must be placed in the input sequence following the OVERLAY statement that specifies the origin of the segment in which the section is positioned. If the section is positioned in the root segment, the INSERT statement must be placed before the first OVERLAY statement.
Note:
  1. Sections that are positioned in a segment must contain all address constants to be used during execution unless:
    • The A-type address constants are located in a segment in the path.
    • The V-type address constants used to pass control to another segment are located in the path. If an exclusive reference is made, the V-type address constant must be in a common segment.
    • The V-type address constants used with the SEGLD and SEGWT macro instructions are located in the segment.
  2. Automatically called sections not specified on INSERT statements are added to the root segment.
Parent topic: Binder control statement reference

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014