CCXLLK



CCXLLK

     Compiles and links an HP C/XL program.  HP C/XL 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/XL is installed on your system.

SYNTAX

     CCXLLK [TEXTFILE][,[PROGFILE][,[LISTFILE]]
[;INFO=QUOTEDSTRING]

NOTE:

THIS COMMAND FOLLOWS THE OPTIONAL MPE/iX COMMAND LINE SYNTAX.


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/XL 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, WHICH IS USUALLY THE TERMINAL,
IF YOU ARE RUNNING HP C/XL FROM A TERMINAL; IT IS
USUALLY THE PRINTER, IF YOU ARE RUNNING 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 PARAMETER FOR THE COMPILER. IT IS A QUOTED STRING
OF NO MORE THAN 1024 CHARACTERS (INCLUDING THE
SINGLE OR DOUBLE QUOTE 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 VALID OPTIONS REFER
TO THE HP C/IX REFERENCE MANUAL (31506-90005).

NOTE

THE FORMAL FILE DESIGNATORS USED IN THIS COMMAND (CCTEXT, CCLIST)
CANNOT BE BACKREFERENCED AS ACTUAL FILE DESIGNATORS IN THE COMMAND
PARAMETER LIST.

OPERATION

     THE CCXLLK COMMAND COMPILES AND LINKS AN HP C/XL 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 LINKEDITOR AS $OLDPASS. LINKEDITOR OVERWRITES
PROGFILE AND WRITES THE LINKED PROGRAM TO $OLDPASS, IF
PROGFILE IS OMITTED, WHICH CAN THEN BE EXECUTED.

THIS COMMAND MAY BE ISSUED FROM A SESSION, PROGRAM OR A JOB. IT
MAY NOT BE USED IN BREAK. PRESSING [BREAK] SUSPENDS THE EXECUTION
OF THIS COMMAND. ENTERING RESUME CONTINUES THE EXECUTION.

NOTE

THIS COMMAND IS IMPLEMENTED AS A COMMAND FILE. IF YOU SET THE HPPATH
VARIABLE TO NULL (:SETVAR HPPATH ""), THE COMMAND FILE WILL NOT BE
EXECUTED, AND THE COMMAND WILL FAIL.

EXAMPLE(S)

     THE FOLLOWING EXAMPLE COMPILES AND LINKS AN HP C/XL PROGRAM
ENTERED THROUGH YOUR STANDARD INPUT DEVICE AND STORES THE
LINKED PROGRAM IN THE FILE $OLDPASS. THE LISTING WILL BE
PRINTED ON YOUR STANDARD LIST DEVICE.

CCXLLK

TO COMPILE AND LINK AN HP C/XL SOURCE PROGRAM FROM THE
SOURCE FILE SOURCE, STORING IT IN PROG, AND SENDING THE
LISTING TO YOUR STANDARD LIST DEVICE, ENTER

CCXLLK SOURCE,PROG

ADDITIONAL INFORMATION

COMMANDS:   CCXL, CCXLGO

MANUALS :   HP C PROGRAMMER'S GUIDE (92434-90002)
            HP C/IX REFERENCE MANUAL (31506-90005)