MPE/iX Commands Reference Manual (32650-90877)

Chapter 4 133
Command List II
Commands CALC thru COPY
listfile Actual file designator of the file to which the program listing is written.
This can be any ASCII output file. Formal file designator is COBLIST.
Default is $STDLIST.
masterfile Actual file designator of the master file with which textfile is merged to
produce a composite source. This can be any ASCII input file. The formal
designator is COBMAST. Default is that the master file is not read; input is
read from
textfile , or from $STDIN if textfile is not specified.
newfile Actual file designator of the merged textfile and masterfile . This can
be any ASCII output file. Formal file designator is COBNEW. Default is that
no file is written.
quotedstring A sequence of ASCII characters bounded by a pair of single quotation
marks (apostrophes) or by double quotation marks. You may use the
delimiting character as part of the string so long as it appears twice. Any
occurrence of two single quotes in a row or two double quotes in a row, is
considered part of the string, and, therefore, not the terminating delimiter.
INFO=
quotedstring is used in the COBOLII programming language to
pass compiler options to a program. These options appear before the first
line of source code in the text file.
workspacename Actual file designator of an HPToolset workspace. The formal designator
is COBWKSP.
Operation Notes
The COBOLII command compiles a compatibility mode COBOLII program into a USL file
on disk. If you do not specify
textfile , COBOLII expects the source text to be entered
from your standard input device. If you do not specify
listfile , COBOLII sends the
program listing to the current list device.
You cannot backreference the formal file designators used in this command (COBTEXT,
COBLIST, COBMAST, COBNEW, COBWKSP, and COBXDB) as actual file designators in the
command parameter list. For further information, refer to the "Implicit FILE Commands
for Subsystems" discussion of the FILE command.
Use
This command may be issued from a session, job, or program but not in BREAK. Pressing
Break suspends the execution of this command. Entering the RESUME command continues
the execution.
Example
To compile a COBOLII program stored in the file SOURCE into an object program on the
USL file OBJECT and send the listing to the disk file LISTFL, enter:
BUILD OBJECT;CODE=USL
COBOLII SOURCE,OBJECT,LISTFL
Related Information
Commands COBOLIIGO, COBOLIIPREP, LINK, RUN, XEQ, LINKEDIT Utility