COBOLII



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)