 |
» |
|
|
|
Compiles and links an HP COBOL II/iX program using the 1985
ANSI standard entry point. HP COBOL II/iX is not part of the HP
3000 Series 900 Computer System Fundamental Operating Software and
must be purchased separately. This command is recognized only if
HP COBOL II/iX is installed on your system. (Native Mode) Syntax | |
[ ,[ progfile] [ ,[ listfile] [ ,[ masterfile] [ ,newfile] ] ] ] |
[ ;INFO=quotedstring] [ ;WKSP=workspacename] [ ;XDB=xdbfilename] |
| | | |  | NOTE: This command follows the optional MPE/iX command line
syntax. Refer to "Optional Format for MPE/iX Commands" at the beginning
of this chapter. | | | | |
Parameters | |
- textfile
The name of the file that contains the source code
that is to be compiled. This can be any ASCII or toolset access
method (TSAM) file. The formal file designator is COBTEXT. If you are running HP COBOL II/iX from your terminal, you
will probably specify a disk textfile.
If you do not specify textfile, the default
file is $STDIN.
$STDIN is the
current input device, usually your terminal. - progfile
The name of the object file to which the Link Editor
writes the linked program. If you do not specify progfile,
the default is $NEWPASS. - listfile
The name of the file to which the compiler writes
the program listing. This can be any ASCII file. The formal file
designator is COBLIST.
If you do not specify listfile, the default
is $STDLIST.
$STDLIST is usually
the terminal in a session or the printer in a batch job. - 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 quoted string of no more than 255 characters (including
the single or double quotation marks that enclose it). The quotedstring string may be
used to pass dollar sign ($)
commands to the compiler: "$command1$command2$command3...".
The $ must be
the first character in the string, and it must be used to separate
multiple commands. To extend the quotedstring
string over more than one physical line, make an ampersand (&)
the last character of one line and continue the quotedstring
string onto the next physical line. Each $
command is limited in length to the same size as in the source file: COB85XLK SALARIES,SALPRG;INFO="$CONTROL &
BOUNDS,MAP,VERBS$SET&$X9=ON"
COB85XLK ACCOUNTS;INFO="$DEFINE %A=5#" |
- workspacename
This parameter is the actual file designator of
an HPToolset workspace. The formal file designator is COBWKSP. - xdbfilename
Actual file designator for the file to be used by
the symbolic debugger (XDB). This is a permanent file created by
the compiler that contains the listing of the source files. The
formal file designator is COBXDB. If this file exists, then it must be in a special format created
by a previous compile using this option. In this case, it is first
purged. If the file is of the wrong type, the compile is not attempted.
The user must either use a different name or purge the file. Once the file is created, XDB expects the fully qualified
name of the file to be unchanged. A FILE
equation could be used if the file is renamed.
Operation Notes | |
The COB85XLK
command compiles and links an HP COBOL II/iX program into a disk
file. If you do not specify textfile,
HP COBOL II/iX expects your input from your standard input device.
If you do not specify listfile, HP COBOL
II/iX sends the listing output to your current list device. The object file created during compilation is a system-defined
temporary file, $NEWPASS,
which is passed directly to the Link Editor as $OLDPASS.
The Link Editor overwrites progfile which
can then be executed. You cannot backreference the formal file designators used
in this command (COBTEXT,
COBOBJ, 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. | | | | | NOTE: This command is implemented as a command file. If you
set the HPPATH
variable to null (SETVAR HPPATH ""),
the command file is not executed, and the command fails. | | | | |
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. Examples | |
To compile and link an HP COBOL II/iX program entered from
your standard input device, with the listing printed on the standard
list device, enter: To compile and link an HP COBOL II/iX source program input
from the text file SFILE
into a program file named MYPROG,
with the listing sent to the current list device, enter: Related Information | |
- Commands
COB85XL,
COB85XLG, LINK,
RUN, XEQ,
LINKEDIT Utility - Manuals
HP COBOL II/XL Reference Manual HP COBOL II/XL Programmer's Guide
|
