COBOLIIGO [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
COBOLIIGO
Compiles, prepares, and executes 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 COB74XLG.
For information on the 85 entry point, refer to the HP COBOL II/XL
Reference Manual (31500-90001)
Syntax
COBOLIIGO [textfile][,[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.
listfile Actual file designator of the file on 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 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 merged textfile and
the 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 two
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. The formal file designator
created by the compiler is COBWKSP.
Operation Notes
The COBOLIIGO command compiles, prepares, and executes a compatibility
mode program using the COBOL 74 compiler. If you do not specify
textfile, COBOLII expects the source program to be entered from your
standard input device. If you do not specify listfile, COBOLII sends the
output to your standard 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 purges the USL file and writes the prepared program to
$OLDPASS, which is then executed and may be executed repeatedly.
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. It is not
available in BREAK. Pressing Break suspends the execution of this
command. Entering the RESUME command continues the execution.
Examples
To compile, prepare, and execute a compatibility mode COBOLII program
entered from your standard input device and send the program listing to
your standard list device, enter:
COBOLIIGO
To compile, prepare, and execute a COBOLII program from the disk file
TEXTFL and send the program listing to the disk file LISTFL, enter:
COBOLIIGO TEXTFL,LISTFL
Related Information
Commands COBOLII, COBOLIIPREP, LINK, RUN, XEQ, LINKEDIT Utility
Manuals HP COBOL II/XL Reference Manual (31500-90001)
MPE/iX 5.0 Documentation