COBOLII

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

Back to Main Index


COBOLII


     COMPILES A COMPATIBILITY MODE COBOLII PROGRAM ON THE COBOL
     74 COMPILER.  COBOLII IS NOT PART OF THE 900 SERIES HP 3000
     COMPUTER SYSTEM FUNDAMENTAL OPERATING SOFTWARE AND MUST BE
     PURCHASED SEPARATELY.  THE NATIVE MODE EQUIVALENT OF THIS
     COMMAND IS COB74XL.

     FOR INFORMATION ON THE 85 ENTRY POINT, REFER TO THE COBOL II/XL
     REFERENCE MANUAL (31500-90001)

SYNTAX


     COBOLII [TEXTFILE][,[USLFILE][,[LISTFILE]

              [,[MASTERFILE][,NEWFILE]]]]
              [;INFO=QUOTEDSTRING]
              [;WKSP=WORKSPACENAME]


PARAMETERS


TEXTFILE            ACTUAL FILE DESIGNATOR OF THE INPUT FILE FROM WHICH
                    THE SOURCE PROGRAM IS READ. THIS CAN BE ANY ASCII
                    INPUT FILE. FORMAL FILE DESIGNATOR IS COBTEXT.
                    DEFAULT IS $STDIN.

USLFILE             ACTUAL FILE DESIGNATOR OF THE USER SUBPROGRAM
                    LIBRARY (USL) ON WHICH THE OBJECT PROGRAM IS
                    WRITTEN.  THIS CAN BE ANY BINARY OUTPUT FILE WITH A
                    FILE CODE OF USL OR 1024.  ITS FORMAL FILE
                    DESIGNATOR IS COBUSL.  IF THE USLFILE PARAMETER IS
                    OMITTED, THE OBJECT CODE IS SAVED TO THE TEMPORARY
                    FILE $OLDPASS. IF THE PARAMETER IS ENTERED, IT
                    INDICATES THAT THE FILE WAS CREATED IN ONE OF FOUR
                    WAYS

                    O  BY USING THE SAVE COMMAND TO SAVE THE DEFAULT
                       USL FILE CREATED DURING A PREVIOUS COMPILATION.

                    O  BY BUILDING THE USL WITH THE SEGMENTER COMMAND -
                       BUILDUSL.  (REFER TO THE MPE SEGMENTER REFERENCE
                       MANUAL (32650-60026).)

                    O  BY CREATING A NEW USL FILE WITH THE MPE/iX BUILD
                       COMMAND, SPECIFYING A FILE CODE OF USL OR 1024.

                    O  BY SPECIFYING A NONEXISTENT USLFILE PARAMETER,
                       THEREBY CREATING A PERMANENT FILE OF THE CORRECT
                       SIZE AND TYPE.

LISTFILE            ACTUAL FILE DESIGNATOR OF THE FILE TO WHICH THE
                    PROGRAM LISTING IS WRITTEN. THIS CAN BE ANY ASCII
                    OUTPUT FILE. FORMAL FILE DESIGNATOR IS COBLIST.
                    DEFAULT IS $STDLIST.

MASTERFILE          ACTUAL FILE DESIGNATOR OF THE MASTER FILE WITH WHICH
                    TEXTFILE IS MERGED TO PRODUCE A COMPOSITE SOURCE.
                    THIS CAN BE ANY ASCII INPUT FILE.  THE FORMAL
                    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 MERGED TEXTFILE AND
                    MASTERFILE.  THIS CAN BE ANY ASCII OUTPUT FILE.
                    FORMAL FILE DESIGNATOR IS COBNEW.  DEFAULT IS THAT
                    NO FILE IS WRITTEN.

QUOTEDSTRING        A SEQUENCE OF ASCII CHARACTERS BOUNDED BY A PAIR OF
                    SINGLE QUOTATION MARKS (APOSTROPHES) OR BY DOUBLE
                    QUOTATION MARKS.  YOU MAY USE THE DELIMITING
                    CHARACTER AS PART OF THE STRING SO LONG AS IT
                    APPEARS TWICE. ANY OCCURRENCE OF TWO SINGLE QUOTES
                    IN A ROW OR TWO DOUBLE QUOTES IN A ROW, IS
                    CONSIDERED PART OF THE STRING, AND, THEREFORE, NOT
                    THE TERMINATING DELIMITER.

                    INFO=QUOTEDSTRING IS USED IN THE COBOLII PROGRAMMING
                    LANGUAGE TO PASS COMPILER OPTIONS TO A PROGRAM.
                    THESE OPTIONS WILL APPEAR BEFORE THE FIRST LINE OF
                    SOURCE CODE IN THE TEXT FILE.

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

NOTE


THE FORMAL FILE DESIGNATORS USED IN THIS COMMAND (COBTEXT, COBUSL,
COBLIST, COBMAST, COBNEW, AND COBWKSP) CANNOT BE BACKREFERENCED AS
ACTUAL FILE DESIGNATORS IN THE COMMAND PARAMETER LIST.  FOR FURTHER
INFORMATION, REFER TO THE "IMPLICIT FILE COMMANDS FOR SUBSYSTEMS"
DISCUSSION OF THE MPE/iX FILE COMMAND.


OPERATION


     THE COBOLII COMMAND COMPILES A COMPATIBILITY MODE COBOLII
     PROGRAM INTO A USL FILE ON DISK.  IF YOU DO NOT SPECIFY
     TEXTFILE, COBOLII EXPECTS THE SOURCE TEXT TO BE ENTERED FROM
     YOUR STANDARD INPUT DEVICE.  IF YOU DO NOT SPECIFY LISTFILE,
     COBOLII SENDS THE PROGRAM LISTING TO THE CURRENT LIST
     DEVICE.

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 RESUME CONTINUES THE EXECUTION.


EXAMPLE(S)


     TO COMPILE A COBOLII PROGRAM STORED IN THE FILE SOURCE INTO
     AN OBJECT PROGRAM ON THE USL FILE OBJECT AND SEND THE
     LISTING TO THE DISK FILE LISTFL, ENTER

     BUILD OBJECT;CODE=USL
     COBOLII SOURCE,OBJECT,LISTFL


Additional Discussion

COMMANDS:   COBOLIIGO, COBOLIIPREP

MANUALS :   HP COBOL II/XL REFERENCE MANUAL (31500-90001)
            MPE SEGMENTER REFERENCE MANUAL (32650-60026)

Back to Main Index