CCXL



CCXL

     Compiles 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

     CCXL [TEXTFILE][,[OBJECTFILE][,[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/V. 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.

OBJECTFILE ACTUAL FILE DESIGNATOR OF THE OBJECT FILE TO WHICH
THE OBJECT CODE IS STORED. THIS FILE IS STORED 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 WILL STORE
THE OBJECT FILE IN A PERMANENT FILE OF THE CORRECT
SIZE AND TYPE, AND WITH THE NAME YOU SPECIFIED. IF
A FILE OF THE SAME NAME ALREADY EXISTS, THE OBJECT
CODE WILL OVERWRITE THAT FILE.

IF THE COMPILER ISSUES AN ERROR MESSAGE TELLING YOU
THAT A NEW OR EXISTING OBJECT FILE YOU ARE TRYING TO
COMPILE TO IS TOO SMALL, YOU WILL HAVE TO BUILD THE
OBJECT FILE WITH A LARGER SIZE 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, 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 PROGRAM. OPTIONS MUST BE
DELIMITED BY BLANK SPACES.

NOTE

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

OPERATION

     THE CCXL COMMAND COMPILES AN HP C/XL 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.

THIS COMMAND MAY BE ISSUED FROM A SESSION, JOB OR A PROGRAM. 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 HP PATH ""), THE COMMAND FILE WILL NOT BE
EXECUTED, AND THE COMMAND WILL FAIL.


EXAMPLE(S)

     THE FOLLOWING EXAMPLE COMPILES AN HP C/XL 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/XL 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

NOTE

     PROGRAM DEVELOPMENT IN NATIVE MODE OF MPE/iX USES THE NEW 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 LINKEDITOR 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

ADDITIONAL INFORMATION

COMMANDS:   CCXLGO, CCXLLK

MANUALS :   HP C PROGRAMMER'S GUIDE (92434-90002)