COB85XLK

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


COB85XLK

     COMPILES AND LINKS AN HP COBOL II/iX PROGRAM USING THE 1985
     ANSI STANDARD ENTRY POINT.  HP COBOL II/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 COBOL II/iX IS INSTALLED ON YOUR
     SYSTEM.  (NM)

NOTE


THIS COMMAND FOLLOWS THE MORE FLEXIBLE MPE/iX COMMAND LINE SYNTAX.

SYNTAX


     COB85XLK [TEXTFILE][,[PROGFILE][,[LISTFILE]

               [,[MASTERFILE][,NEWFILE]]]]
               [;INFO=QUOTEDSTRING]
               [;WSKP=WORKSPACENAME]
               [;XDB=XDBFILENAME]


PARAMETERS


TEXTFILE            THE NAME OF THE FILE THAT CONTAINS THE SOURCE CODE
                    THAT IS TO BE COMPILED.  THIS CAN BE ANY ASCII OR
                    TOOLSET ACCESS METHOD (TSAM) FILE.  THE FORMAL FILE
                    DESIGNATOR IS COBTEXT.

                    IF YOU ARE RUNNING HP COBOL II/iX FROM YOUR
                    TERMINAL, YOU WILL PROBABLY SPECIFY A DISK TEXTFILE.
                    IF YOU DO NOT SPECIFY TEXTFILE, THE DEFAULT FILE IS
                    $STDIN. $STDIN IS THE CURRENT INPUT DEVICE, USUALLY
                    YOUR TERMINAL.

PROGFILE            THE NAME OF THE OBJECT FILE TO WHICH THE LINKEDITOR
                    WRITES THE LINKED PROGRAM.  IF YOU DO NOT SPECIFY
                    PROGFILE, THE DEFAULT IS $NEWPASS.

LISTFILE            THE NAME OF THE FILE TO WHICH THE COMPILER WRITES
                    THE PROGRAM LISTING.  THIS CAN BE ANY ASCII FILE.
                    THE FORMAL FILE DESIGNATOR IS COBLIST.  IF YOU DO
                    NOT SPECIFY LISTFILE, THE DEFAULT IS $STDLIST.
                    $STDLIST IS USUALLY THE TERMINAL IN A SESSION OR THE
                    PRINTER IN A BATCH JOB.

MASTERFILE          ACTUAL FILE DESIGNATOR OF THE FILE WHICH IS MERGED
                    AGAINST TEXTFILE TO PRODUCE A COMPOSITE SOURCE.
                    THIS CAN BE ANY ASCII INPUT FILE.  FORMAL FILE
                    DESIGNATOR IS COBMAST. DEFAULT IS THAT THE MASTER
                    FILE IS NOT READ; INPUT IS READ FROM TEXTFILE, OR
                    FROM $STDIN IF TEXTFILE IS NOT SPECIFIED.

NEWFILE             ACTUAL FILE DESIGNATOR OF THE FILE CREATED BY
                    MERGING TEXTFILE AND MASTERFILE.  THIS CAN BE ANY
                    ASCII OUTPUT FILE.  FORMAL FILE DESIGNATOR IS
                    COBNEW.  DEFAULT IS THAT NO FILE IS WRITTEN.

QUOTEDSTRING        A PARAMETER SPECIFYING COMPILE TIME OPTIONS
                    FOR THE COMPILER.  IT IS A QUOTED STRING OF NO MORE
                    THAN 255 CHARACTERS (INCLUDING THE SINGLE OR DOUBLE
                    QUOTE MARKS THAT ENCLOSE IT).

                    THE QUOTEDSTRING STRING MAY BE USED TO PASS $
                    (DOLLAR SIGN) COMMANDS TO THE COMPILER
                    "$COMMAND1$COMMAND2$COMMAND3...." THE $ MUST BE THE
                    FIRST CHARACTER IN THE STRING, AND IT MUST BE USED
                    TO SEPARATE MULTIPLE COMMANDS.  YOU MAY EXTEND THE
                    QUOTEDSTRING STRING OVER MORE THAN ONE PHYSICAL LINE
                    BY MAKING AN AMPERSAND (&) THE LAST CHARACTER OF ONE
                    LINE AND CONTINUING THE QUOTEDSTRING STRING ONTO THE
                    NEXT PHYSICAL LINE.

                    EACH $ COMMAND IS LIMITED IN LENGTH TO THE SAME SIZE
                    AS IN THE SOURCE FILE.

                    COB85XLK SALARIES,SALPRG;INFO="$CONTROL &
                    BOUNDS,MAP,VERBS$SET &$X9=ON"
                    COB85XLK ACCOUNTS;INFO="$DEFINE %A=5#"

WORKSPACENAME       THIS PARAMETER IS THE ACTUAL FILE DESIGNATOR OF AN
                    HPTOOLSET WORKSPACE USED WITH HPTOOLSET.  THE FORMAL
                    FILE DESIGNATOR IS COBWKSP.

XDBFILENAME         ACTUAL FILE DESIGNATOR FOR THE FILE TO BE USED BY
                    XDB.  THIS WILL BE A PERMANENT FILE CREATED BY THE
                    COMPILER THAT CONTAINS THE LISTING OF THE SOURCE
                    FILES.  THE FORMAL FILE DESIGNATOR IS COBXDB.

                    IF THIS FILE EXISTS, IT MUST BE IN A SPECIAL
                    FORMAT CREATED BY A PREVIOUS COMPILE USING
                    THIS OPTION.  IN THIS CASE, IT IS FIRST
                    PURGED.  IF THE FILE IS OF THE WRONG TYPE,
                    THE COMPILE IS NOT ATTEMPTED.  THE USER MUST
                    THEN USE A DIFFERENT NAME OR PURGE THE FILE.

                    ONCE THE FILE IS CREATED, XDB EXPECTS THE
                    FULLY QUALIFIED NAME OF THE FILE TO BE
                    UNCHANGED.  A FILE EQUATION COULD BE USED IF
                    THE FILE IS RENAMED.


NOTE


THE FORMAL FILE DESIGNATORS USED IN THIS COMMAND (COBTEXT, COBOBJ,
COBLIST, COBMAST, COBNEW, AND COBWKSP, COBXDB) CANNOT BE BACKREFERENCED
AS ACTUAL FILE DESIGNATORS IN THE COMMAND PARAMETER LIST. FOR FURTHER
INFORMATION, REFER TO THE SUBENTRY IMPLICIT OF THE FILE ENTRY IN THE
HELP FACILITY.

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


OPERATION


     THE COB85XLK COMMAND COMPILES AND LINKS AN HP COBOL II/iX
     PROGRAM INTO A DISK FILE.  IF YOU DO NOT SPECIFY TEXTFILE,
     HP COBOL II/iX EXPECTS YOUR INPUT FROM YOUR STANDARD INPUT
     DEVICE.  IF YOU DO NOT SPECIFY LISTFILE, HP COBOL II/iX
     SENDS THE LISTING OUTPUT TO YOUR CURRENT LIST DEVICE.

     THE OBJECT FILE CREATED DURING COMPILATION IS A SYSTEM-
     DEFINED TEMPORARY FILE, $NEWPASS, WHICH IS PASSED DIRECTLY
     TO THE LINKEDITOR AS $OLDPASS.  THE LINKEDITOR 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 WILL NOT BE
EXECUTED, AND THE COMMAND WILL FAIL.


EXAMPLE(S)


     TO COMPILE AND LINK AN HP COBOL II/iX PROGRAM ENTERED FROM
     YOUR STANDARD INPUT DEVICE WITH THE LISTING PRINTED ON THE
     STANDARD LIST DEVICE, ENTER

     COB85XLK

     TO COMPILE AND LINK AN HP COBOL II/iX SOURCE PROGRAM INPUT
     FROM THE TEXT FILE SFILE INTO A PROGRAM FILE NAMED MYPROG,
     WITH THE RESULTING LISTING SENT TO THE CURRENT LIST DEVICE,
     ENTER

     COB85XLK SFILE,MYPROG

ADDITIONAL INFORMATION


COMMANDS:   COB85XL, COB85XLG, LINK

MANUALS :   HP COBOL II/XL REFERENCE MANUAL (31500-90001)
            HP COBOL II/XL PROGRAMMER'S GUIDE (31500-90002)
            HP Link Editor/iX Reference Manual (32650-90030)

Back to Main Index