Binder Manual (G06.24+, H06.03+)

BIND Commands
Binder Manual—528613-003
3-8
ADD Command
To ensure Binder builds the target file correctly, add names to the lists in the order
in which you want them to appear in the target file. Binder adds names to the
include lists in the order in which ADD commands specify them and, in general,
uses the include list order to build the target file.
•
COBOL85 Files
For COBOL85 files, ADD CODE is equivalent to ADD *, because COBOL85 files
do not have separate data blocks except for COBOL85 EXTERNAL.
•
Creating an Object File that Has Multiple Code Segments
ADD SPACE lets you create an object file that has multiple code segments by
adding code blocks from one object file, adding a space boundary marker, adding
more blocks from the same file or another file, inserting another space, and so on.
•
Rules for Setting HIGHPIN, HIGHREQUESTERS, and RUNNAMED
Binder sets HIGHPIN ON for a target object file only if all of the files that make up
the target object file are set HIGHPIN ON. Binder sets HIGHREQUESTERS ON for
a target object file if and only if HIGHREQUESTERS ON is set for the object file
containing the main program. Binder sets RUNNAMED ON for a target object file if
any object file that makes up the target file is set RUNNAMED ON.
•
Error Conditions
If a specified entry point or data block is not in the specified FROM file, Binder
issues an error message and halts execution of the ADD command.
•
Similarity Between the REPLACE Command and the ADD,DELETE Command
ADD,DELETE adds a specified entry name to the end of the include list, deleting
the previous occurrence of the entry; REPLACE removes the previous occurrence
of the entry name and inserts the new reference in its place. If an error occurs
when you attempt an ADD command, you might accomplish your goal by using a
REPLACE command. (Use REPLACE with caution for COBOL85 and FORTRAN
files. For details, see the REPLACE Command
on page 3-41.)
Examples
•
In this example, the first ADD command transfers the contents of OLDFILE to
NEWFILE; the second ADD command includes BLK-1 to BLK-5 of OBJ in
NEWFILE.
@FILE oldfile
@ADD *
@ADD CODE blk-1 TO blk-5 FROM obj
@BUILD newfile