CCXL

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


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)

Back to Main Index