CCXL [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
CCXL
Compiles an HP C/iX program. HP C/iX is not part of the 900 Series HP
3000 Computer System Fundamental Operating Software and must be purchased
separately. This command is recognized only if HP C/iX is installed on
your system. (Native Mode)
Syntax
CCXL [textfile][,[objectfile][,[listfile]]] [;INFO=quotedstring]
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 text file that contains the source
code to be compiled. This is an ASCII file that
you prepare with an editor such as EDIT/3000. The
formal file designator is CCTEXT.
If you are running HP C/iX from your terminal, you
will probably specify a disk textfile. If you do
not specify textfile, then the default file is
$STDIN. $STDIN is the current input device, usually
your terminal.
When textfile is your terminal, you can enter
source code interactively. When you have entered
all the source code, type a colon (:) to end the
interactive input.
objectfile Actual file designator of the object file to which
the object code is stored. This file is in binary
form and has a file code of 1461 or NMOBJ. Its
formal file designator is CCOBJ. If the objectfile
parameter is omitted, the object code is saved to
the temporary file $OLDPASS.
If you specify objectfile, the compiler stores the
object file in a permanent file of the correct
size, type, and name you specified. If a file of
the same name already exists, the object code
overwrites that file.
If the compiler issues an error message telling you
that a new or existing object file to which you are
trying to compile is too small, build a larger
object file and recompile to it.
You may use the MPE/iX SAVE command to store
$OLDPASS as a permanent file under another name.
listfile The name of the file on which the compiler writes
the program listing. It can be any ASCII file.
The default is $STDLIST.$STDLIST is usually the
terminal from a session or the printer from a batch
job. The formal file designator is CCLIST.
If listfile is $NULL or a file other than $STDLIST,
the compiler displays on $STDLIST those lines that
contain errors.
quotedstring A string of no more than 1024 characters (including
the single or double quotation marks that enclose
it).
The quotedstring is used to pass initial compiler
options to the compiler program. Options must be
delimited by blank spaces.
NOTE The formal file designators used in this command (CCTEXT, CCOBJ,
and CCLIST) cannot be backreferenced as actual file designators in
the command parameter list.
Operation Notes
The CCXL command compiles an HP C/iX program and stores the object code
in a permanent file (objectfile) or in $OLDPASS if you do not specify an
object file. If textfile is not specified, the compiler expects the
source program to be entered from your standard input device. If you do
not specify listfile, the compiler sends the program listing to your
standard device and identifies it by the formal file designator CCLIST.
NOTE This command is implemented as a command file. If you set the
HPPATH variable to null (SETVAR HP PATH ""), the command file is
not executed, and the command fails.
Use
This command may be issued from a session, job, or program. It may not
be used in BREAK. Pressing Break suspends the execution of this command.
Entering the RESUME command continues the execution.
Examples
The following example compiles an HP C/iX program entered from your
standard input device and stores the object program in the object file
$OLDPASS. The listing is then sent to your standard list device.
CCXL
The next example compiles an HP C/iX program contained in the disk file
SOURCE and stores the object program in the object file OBJECT. The
program listing is stored in the disk file LISTFILE.
CCXL SOURCE,OBJECT,LISTFILE
Program development in native mode uses the MPE/iX LINK command, not the
MPE V/E PREP command. This produces a significant change in the method
of linking code. In MPE/iX, you must compile the source files into
separate object files and then use the Link Editor to link the two object
files into the program file, as in this example:
CCXL MAIN, OBJMAIN
CCXL SUB, OBJSUB
LINK FROM=OBJMAIN,OBJSUB;TO=SOMEPROG;RL=LIBCINIT.LIB.SYS
RUN SOMEPROG
Related Information
Commands CCXLGO, CCXLLK, RUN, LINK, XEQ, LINKEDIT Utility
Manuals HP C Programmer's Guide (92434-90002)
MPE/iX 5.0 Documentation