HP 3000 Manuals HP 3000 Manuals
COBOLIIPREP
Compiles and prepares 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 COB74XLK.
For information on the 85 entry point, refer to the COBOL/II 3000
Reference Manual (31500-90001)
Syntax
COBOLIIPREP [textfile] [,[progfile][,[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.
progfile Actual file designator of the program file to which
the prepared program segments are written. If
progfile is omitted, the MPE segmenter creates the
program file, which resides in the temporary file
domain as $OLDPASS. If entered, progfile indicates
that the file was created in one of two ways:
* By specifying a file code of 1029 or PROG,
and a numextents value of 1. This file is
then used by the PREP command.
* By specifying a nonexistent file in the
progfile parameter. A temporary job file of
the correct size and type is created.
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 file which is merged
against textfile to produce a composite source.
This can be any ASCII input file. Formal file
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 file created by
merging 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 or
double quotation marks 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 This parameter is the actual file designator of an
HPToolset workspace used with HPToolset. The
formal file designator created by the compiler is
COBWKSP.
Operation Notes
The COBOLIIPREP command compiles and prepares a compatibility mode
COBOLII program into a program file on disk. If you do not specify
textfile, COBOLII expects your input from your standard input device. If
you do not specify listfile, COBOLII sends the listing output to your
current list device.
The USL file created during compilation is a system-defined temporary
file, $OLDPASS, which is passed directly to the MPE segmenter. The
segmenter overwrites the USL file and writes the prepared program to
$OLDPASS, if progfile is omitted, which can then be executed.
You cannot backreference the formal file designators used in this command
(COBTEXT, COBLIST, COBMAST, COBNEW, and COBWKSP) 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. It is not
available in BREAK. Pressing Break suspends the execution of this
command. Entering the RESUME command continues the execution.
Examples
To compile and prepare a COBOLII program entered from your standard input
device ($STDIN), with the listing printed on the standard list device
($STDLIST), enter:
COBOLIIPREP
To compile and prepare a COBOLII source program input from the text file
SFILE into a program file named MYPROG, with the listing sent to the
current list device, enter:
COBOLIIPREP SFILE,MYPROG
Related Information
Commands COBOLII, COBOLIIGO
Manuals HP COBOL II Reference Manual (31500-90001)