HP 3000 Manuals

Directives by Category [ COBOL/HP-UX Operating Guide for the Series 700 and 800 ] MPE/iX 5.0 Documentation


COBOL/HP-UX Operating Guide for the Series 700 and 800

Directives by Category 

The categories of Compiler/Generator directives are as follows:

   *   Allowing language features

   *   Choosing run-time behavior

   *   Compiler control

   *   Compiling for debugging

   *   Format of your data files

   *   Object code, size and optimization

   *   Reserved directives

In the following lists, an asterisk (*) by a directive means you need an
add-on product before you can use it.  If you use it without the
appropriate add-on product, no error message is given, but the directive
does not have the desired effect.

Allowing Language Features 

These directives change the language features your compiler will accept.

Add Features 

CICS *                       Allow CICS
CICS-CPY *                   Insert COPY "CICS-CPY"
CONSTANT                     Define constant
FCDREG                       Registers for files
PREPROCESS *                 Source from preprocessor
REWRITE-LS                   REWRITE on LINE SEQ
SEQCHK                       Check line numbers

Dialect 

ANS85                        ANSI'85
COBOL370                     IBM COBOL/370
COMS85                       ANSI'85 Communications Module
DBCHECK                      Check for Double-Byte Characters
DBCS                         Double-Byte Characters Support
DG                           Data General
DOSVS                        IBM DOS/VS COBOL
FLAG                         Flag for dialect
FLAGCD                       Flag conflicting directives
FLAGSTD                      Flag ANSI'85 level
IBM-MS                       IBM COBOL VI, Microsoft COBOL V1.0
JAPANESE                     MF Japanese support
MF                           Micro Focus dialect level
MS                           Microsoft V1 or V2
OSVS                         IBM OS/VS COBOL
PC1                          IBM COBOL VI, Microsoft COBOL V1.0
RM                           Ryan-McFarland
SAA                          IBM Systems Application Architecture
VSC2                         IBM VS COBOL II
XOPEN                        X/Open

Explicit Reserved Word Control 

ADDSYN                       Add synonym
MAKESYN                      Make synonymous
OVERRIDE                     Change meaning
REMOVE                       Make unreserved

Features Affecting Speed 

ALTER                        Allow ALTER
NESTCALL                     Allow nested programs
QUAL                         Allow qualification
QUALPROC                     Allow qualified procedure-names
SEG                          Allow Segmentation

Mainframe Compatibility 

CONVERTPTR                   REDEFINEable pointers
DBCSSOSI                     DBCS Shift-in, -out characters
LIBRARIAN                    Allow -INC
MAPNAME                      Allow ENTRY points
PANVALET                     Allow ++INCLUDE
PROGID-COMMENT               Allow Comment in PROG-ID
RDW                          Variable-length records

Choosing Run-Time Behavior 

These directives change the definition of language features and so change
the logic of your program.  Some directives listed under Dialects in the
section "Allowing Language Features"  also affect behavior.

ACCEPTREFRESH                ACCEPT statement
ARITHMETIC                   Control intermediate arithmetic results.
ASSIGN                       EXTERNAL or DYNAMIC
ASSIGN-PRINTER               Printer output
CHARSET *                    ASCII or EBCDIC
CHECKDIV                     Allow divide by zero
CURRENCY-SIGN                Currency sign
CURRENT-DATE                 DDMMYY or MMDDYY
DEFAULTBYTE                  Initialize Data Division
DEFAULTCALLS                 CALL convention
DETECTLOCK                   Detect record locks
HOST-NUMCOMPARE              Numeric comparisons
INITCALL                     Execute a module
LOCKTYPE                     Read locked records
NATIVE                       Collating sequence
NLS                          National Language Support
PRINT-EXT                    Printing extension
STICKY-LINKAGE               Keep parameters linked
TERMPAGE                     Pad out report page
TRACE                        Turn on READY TRACE
ZEROLENGTHFALSE              Zero length tests
ZWB                          Zero when blank numeric comparisons

Behavior Affecting Program Speed or Size 

ALIGN                        Determine data alignment
BOUND                        Bound checking of subscripts
BOUNDOPT                     Optimize usage display subscripts
LINKCHECK                    Check Linkage Section items omitted

Compatibility with Other Vendors' COBOL Language 

You may need these for compatibility with other COBOL implementations.

ALPHASTART                   Numbering in ALPHABET
DBSPACE                      DBCS space
OPTIONAL-FILE                I-O files optional
PERFORM-TYPE                 Returns from PERFORM
RETRYLOCK                    Retry locked record
STICKY-PERFORM               Behavior of PERFORM
SYMBSTART                    Numbering in SYMBOLIC
TRUNC                        Truncation of binary data items

Compatibility with Older Micro Focus Products 

You may need these for use with older Micro Focus COBOL products.

AUTOLOCK                     Default locking
COMP                         Computational subset
COMP-5                       COMP-5 behavior
DE-EDIT                      Numeric-edited behavior
EXTINDEX                     Indexes
EXTERNAL FILESHARE           Default locking
MFLEVEL                      Reserved word compatibility
OLDBLANKLINE                 Effect of BLANK LINE
OLDINDEX                     Indexes = subscripts
OLDNEXTSENTENCE              Effect of NEXT SENTENCE
OLDREADINTO                  Effect of READ INTO
WRITELOCK                    Default locking

Compatibility with Mainframes 

APOST                        Quotation mark = '
CASE                         Case of program-name
DYNAM                        Ignore CANCEL
FP-ROUNDING                  Floating-point effects
IBMCOMP                      Word-storage mode
MAPNAME                      IBM program-names
OLDCOPY                      ANSI'68 COPY
ODOSLIDE                     Variable length table
QUOTE                        Quotation mark = "
SIGN                         Included signs

Cross Platform Compatibility 

You may need these if you move your Micro Focus COBOL applications from
one platform, environment or operating system to another.  See also
Compatibility with Older Micro Focus Products, and "Format of Your Data
Files" .

01SHUFFLE                    Segment boundaries
CHIP                         Chip architecture
COPYEXT                      COPY-file extensions
FOLDCOPYNAME                 Fold COPY-file names
FLAG-CHIP                    Flag chip problems
INTLEVEL *                   Portability level
LITVAL-SIZE                  BY VALUE size
OSEXT                        Source file-name extension
RTNCODE-SIZE                 RETURN-CODE size
SPZERO                       Space = zero in numeric data items
TRUNCCOPY                    Truncate names

Compiler Control 

Error and Flag Messages 

BRIEF                        No message texts
EDITOR                       Create error file for an editor
ERRLIST                      Print messages only
ERRQ                         Pause on error
FLAG                         Flag outside the dialect
FLAGAS                       Show flags as errors, warnings or
                             information
FLAGCD                       Conflicting directives
FLAGQ                        Pause on flag
FLAGSTD                      Flag above ANSI'85 level
HIDEMESSAGE                  Set message to hide
INFORETURN                   Informational message return value
QUERY                        Pause if COPY-file missing
WARNING                      Level of message to output

Listing 

COPYLIST                     List COPY-files
DATE                         Date for listings
FORM                         Page length
LIST                         File for source listing
LISTWIDTH                    Page width
MFCOMMENT                    Alternate-format comments
PRINT                        File for source listing
REF                          List paragraph's addresses
REFNO                        Compiler number in listings
RESEQ                        Generate line numbers
SEQCHK                       Check line numbers
SETTING                      Print directives
SHOW-DIR                     Print directives files
TIME                         Put time on listings
XREF                         Produce cross-reference listing
ZEROSEQ                      Zeros in line numbers

Other Compile/Link Files 

CANCELLBR *                  Close COPY .lbr file
COPYLBR *                    COPY-library = .lbr file
FOLDCOPYNAME                 COPY file-name upper/lowercase
INT *                        File for intermediate code

Screen 

BELL                         Bleep when stop
CONFIRM                      Display directives
ECHO                         Display errors
ECHOALL                      Display full listing
SUPFF                        Suppress form-feed characters on screen
                             listings

Using Directives 

CONFIRM                      Display directives
DIRECTIVES                   File of directives
SETTING                      Print directives
SHOW-DIR                     Print directives files
USE                          File of directives
VERBOSE                      Send messages to screen

Compiling for Debugging 

These directives make the compiler create files containing extra
information about the program, for input to software used for debugging.

ANIM                         For Animator
COBIDY                       Path for Animator file
EDITOR                       Error-file for Editor
PROFILE                      Create profiler statistics
RNIM                         Animate, don't compile
TRACE                        Turn on READY TRACE
XNIM                         Compile and animate

Add-on Products 

ANALYZE *                    For Analyze
CSI *                        For CSI
STRUCT *                     For Structure Animator

Format of Your Data Files 

These directives change the format in which data is stored in your data
files.

CALLFH *                     External file handler
DATACOMPRESS                 Data compression
FILETYPE                     Data file format
IDXFORMAT                    Indexed file structure
KEYCOMPRESS                  Key compression
RECMODE                      Fixed or variable length
SEQUENTIAL                   Variants of SEQ organization

Object Code, Size and Optimization 

These directives change the object code produced without changing the
logic of your program.

File handling 

CALLFH *                     External file handler
WRITETHROUGH *               Unbuffered writes

Size and Speed 

CICSOPT *                    Optimize BLL cells
LOGICOPT                     Ignore RETURN-CODE
SEG                          Segmentation

For additional directives affecting optimization, see also Features 
Affecting Speed in the section "Allowing Language Features"  and
Behavior Affecting Program Speed or Size in the section "Choosing
Run-Time Behavior" .

Reserved Directives 

These directives are reserved or are maintained for compatibility with
earlier products and have no effect.  Do not use them.

ADV                          No effect
FILECASE                     Internal use

These directives are reserved for use in other environments.  They have
no effect in Micro Focus UNIX environments.

BROWSE                       Other environments
GANIM                        Other environments
MFSCCS                       Other environments
SQL                          Other environments
SQLACCESS                    Other environments
SQLBIND                      Other environments
SQLBLOCK                     Other environments
SQLDB                        Other environments
SQLDB2                       Other environments
SQLFORMAT                    Other environments
SQLINIT                      Other environments
SQLPASS                      Other environments
SQLPRE                       Other environments
SQLPROT                      Other environments

Add-on Products 

ENSUITE *                    Interface to other products
WB *                         Interface to other products



MPE/iX 5.0 Documentation