COBOLIIPREP

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

Back to Main Index


COBOLIIPREP


     Compiles and prepares 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 COB74XLK.

     For information on the 85 entry point, refer to the COBOL II/XL
     Reference Manual (31500-90001)

SYNTAX


     COBOLIIPREP [TEXTFILE][,[PROGFILE][,[LISTFILE]

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


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.

PROGFILE            ACTUAL FILE DESIGNATOR OF THE PROGRAM FILE TO WHICH
                    THE PREPARED PROGRAM SEGMENTS ARE WRITTEN.  WHEN YOU
                    OMIT PROGFILE, THE MPE SEGMENTER CREATES THE PROGRAM
                    FILE, WHICH WILL RESIDE IN THE TEMPORARY FILE DOMAIN
                    AS $OLDPASS.  IF ENTERED, THIS PROGFILE INDICATES
                    THAT A FILE WAS CREATED IN ONE OF TWO WAYS

                    O  BY SPECIFYING A FILE CODE OF 1029 OR PROG, AND A
                       NUMEXTENTS VALUE OF 1.  THIS FILE IS THEN USED BY
                       THE PREP COMMAND.

                    O  BY SPECIFYING A NONEXISTENT FILE IN THE PROGFILE
                       PARAMETER.  A TEMPORARY JOB FILE OF THE CORRECT
                       SIZE AND TYPE IS CREATED.

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 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 $STDLIST 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 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       THIS PARAMETER IS THE ACTUAL FILE DESIGNATOR OF AN
                    HPTOOLSET WORKSPACE USED WITH HPTOOLSET.  THE FORMAL
                    FILE DESIGNATOR CREATED BY THE COMPILER IS COBWKSP.

NOTE


THE FORMAL FILE DESIGNATORS USED IN THIS COMMAND (COBTEXT, 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 COBOLIIPREP COMMAND COMPILES AND PREPARES A
     COMPATIBILITY MODE COBOLII PROGRAM INTO A PROGRAM FILE ON
     DISK.  IF YOU DO NOT SPECIFY TEXTFILE, COBOLII EXPECTS YOUR
     INPUT FROM YOUR STANDARD INPUT DEVICE.  IF YOU DO NOT
     SPECIFY LISTFILE, COBOLII SENDS THE LISTING OUTPUT TO YOUR
     CURRENT LIST DEVICE.

     THE USL FILE CREATED DURING COMPILATION IS A SYSTEM-DEFINED
     TEMPORARY FILE, $OLDPASS, WHICH IS PASSED DIRECTLY TO THE
     MPE SEGMENTER.  THE SEGMENTER OVERWRITES THE USL FILE AND
     WRITES THE PREPARED PROGRAM TO $OLDPASS, IF PROGFILE IS
     OMITTED, WHICH CAN THEN BE EXECUTED.

     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 AND PREPARE A COBOLII PROGRAM ENTERED FROM YOUR
     STANDARD INPUT DEVICE WITH THE LISTING PRINTED ON THE
     STANDARD LIST DEVICE, ENTER

     COBOLIIPREP

     TO COMPILE AND PREPARE A COBOLII 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

     COBOLIIPREP SFILE,MYPROG

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

Back to Main Index