COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

Specifying Library Names
There are three places you can specify the name of the library from which a COPY statement is to
collect text:
• The COPY statement itself can include an IN library-name phrase (see COPY Statement),
in which the name can be a file-system file name or (in the Guardian environment) an
alphanumeric literal containing a DEFINE name.
• The COBOL85 command that initiates the compilation can include a library name to be used
whenever a COPY statement does not include a library name (see Starting a Compilation
(page 529)). On a command line, the library name parameter is either a file-system file name
or (in the Guardian environment) a DEFINE name, but neither can be enclosed in quotation
marks.
• In the OSS environment, you can specify the default COPY library with the -Wcopylib flag.
If no name is specified on either the command line or the COPY statement, the compiler uses the
name COPYLIB.
If library-name is not fully qualified with volume and subvolume, the current default volume or
subvolume is used.
Library Format
pre-text
is one or more text lines. These lines are never copied. When a library file begins with
pre-text, this text can be comments about the library’s sections. The compiler examines
pre-text only to look for a question mark (?) in column 1 followed by zero or more spaces
followed by the directive COLUMNS (in any combination of cases). If it finds such a directive,
it attempts to translate and use it.
section-text
SECTION
is the SECTION directive described in SECTION (page 566).
text-name
is the name of the section, the name that identifies the portion of the library file to be copied.
It is a COBOL word (1 to 30 letters, digits, and hyphens but not all digits).
format
is the keyword TANDEM or ANSI.
506 Source Text Manipulation