HP 3000 Manuals HP 3000 Manuals
COBOLII
Compiles a compatibility mode COBOLII program on the COBOL 74 compiler.
COBOLII is not part of the 900 Series HP 3000 Computer System Fundamental
Operating Software and must be purchased separately. The native mode
equivalent of this command is COB74XL.
For information on the 85 entry point, refer to the HP COBOL II/XL
Reference Manual (31500-90001)
Syntax
COBOLII [textfile] [,[uslfile][,[listfile][,[masterfile][,newfile]]]]
[;INFO=quotedstring][;WKSP=workspacename]
Parameters
textfile Actual file designator of the input file from which
the source program is read. This can be any ASCII
input file. Formal file designator is COBTEXT.
Default is $STDIN.
uslfile Actual file designator of the user subprogram
library (USL) on which the object program is
written. This can be any binary output file with a
file code of USL or 1024. Its formal file
designator is COBUSL. If the uslfile parameter is
omitted, the object code is saved to the temporary
file $OLDPASS. If this parameter is entered, it
indicates that the file was created in one of four
ways:
* By using the SAVE command to save the
default USL file created during a previous
compilation.
* By building the USL with the segmenter
command -BUILDUSL. Refer to the MPE
Segmenter Reference Manual (30000-90011).
* By creating a new USL file with the MPE/iX
BUILD command and specifying a file code of
USL or 1024.
* By specifying a nonexistent uslfile
parameter, thereby creating a permanent file
of the correct size and type.
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
Manuals HP COBOL II/XL Reference Manual (31500-90001)