HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 3  Command Definitions C-E

CCXLLK

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Compiles and links an HP C/iX program. HP C/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 C/iX is installed on your system. (Native Mode)

Syntax

CCXLLK [textfile] [,[ [progfile]] [,[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.

progfile

The name of the program file on which the MPE/iX linker writes the linked program. If you omit the progfile parameter, the program is saved to the temporary file $OLDPASS.

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. Options must be delimited by blank spaces. For a list of options, refer to the HP C/iX Reference Manual (31506-90005).

NOTE: The formal file designators used in this command (CCTEXT and CCLIST) cannot be backreferenced as actual file designators in the command parameter list.

Operation Notes

The CCXLLK command compiles and links an HP C/iX program into a file on disk. If you do not specify textfile, the compiler expects input from the current input device. If you do not specify listfile, the compiler sends the listing output to the formal file designator CCLIST (default $STDLIST).

The object file created during compilation is a system-defined temporary file, $NEWPASS, which is passed directly to the Link Editor as $OLDPASS. Link Editor overwrites progfile and writes the linked program to $OLDPASS, if progfile is omitted, which can then be executed.

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. 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 and links an HP C/iX program entered through your standard input device and stores the linked program in the file $OLDPASS. The listing is printed on your standard list device:

 CCXLLK

To compile and link an HP C/iX source program from the source file SOURCE, store it in PROG, and send the listing to your standard list device, enter:

 CCXLLK SOURCE,PROG

Related Information

Commands

CCXL, CCXLGO, RUN, LINK, XEQ, LINKEDIT Utility

Manuals

HP C Programmer's Guide

HP C/iX Reference Manual

Feedback to webmaster