Programmer's Guide to Writing Programs

Index

Table of Contents

!  A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z 

!

No entries

A

ACCEPT and EBCDIC  6.7.1
ACCEPT FROM ENVIRONMENT-VALUE  2.4
Adis portability  5.6
adisctrl database and NLS  6.2
Advanced language features  Ch2
ALIGN Compiler directive  1.1.3.2
ALIGN Compiler Directive  8.2.4
Alphanumeric data, efficiency of manipulation  1.1.2.2
Alt key portability  5.8.7
ALTER Compiler directive  1.1.3.1
ALTER statement  1.1.2.6 , 3.2.2
AND logic operator  1.1.2.5 , 2.5.1 , 15.3
Animator
        and wide mode  9.3.6
        maximum programs loaded  3.1.3
        reinitializing terminal  9.3.6
ANSI, COMP usage  1.1.1
Application Configuration System  Ch11
        See also Configuration file
        and Menu Handler  11.3.4
        call interface  11.4
        closing configuration file  11.4.2
        error messages  11.4.2
        parameters  11.4.1
        processing method  11.4.2
Application subsystem routines  15.1.1
Applications, mixed language programs  Ch8
ARGUMENT-NUMBER function-name  13.5
ARGUMENT-VALUE function-name  13.5
Arithmetic statement efficiency  1.1.2.1
ASCII
        collating example  6.7.3
        collating sequences  6.7.3
ASCII/EBCDIC
        converting  6.7
        converting using _CODESET  6.7.4
Attribute routines, set PC attribute table  15.3
Attributes
        portability  5.8.2
        setting for application  11.3.2.1
Attributes tag, configuration file  11.3.2.1

B

BASIS and Integrated Preprocessor  14.3.3
Bit manipulation programming  2.5
Boolean operators
        Calling  2.5.1
        using  2.5
BOUND Compiler directive  1.1.3.1
BOUNDOPT Compiler directive  1.1.2.3
BY REFERENCE phrase  8.1.1.2
BY VALUE phrase  8.1.1.2 , 8.2.2
Byte packing  15.1.2

C

C, interfacing with COBOL  9.3
C functions
        cobcall  9.3.1
        cobcancel  9.3.1
        cobexit  9.3.2
        cobfunc  9.3.1
        cobgetfuncaddr  9.3.1
        cobinit  9.3.2
        coblongjmp  9.3.8
        cobsetjmp()  9.3.8
        cobthreadtidy  9.3.3
        cobtidy  9.3.2 , 9.3.2
C screen handling
        cobaddch  9.3.5
        cobaddstr  9.3.5
        cobaddstrc  9.3.5
        cobclear  9.3.5
        cobcols  9.3.5
        cobgetch  9.3.5
        cobgetenv  9.3.4
        cobkeypad  9.3.6
        coblines  9.3.5
        cobmove  9.3.5
        cobprintf  9.3.5
        cobputenv  9.3.4
        cobrescanenv  9.3.4
        cobscroll  9.3.5
        cobtermmode  9.3.6
        SYSTEM  9.3.7
C signal handling
        cobpostsighandler  9.3.9
        cobremovesighandler  9.3.9
C-language header  10.1
CALL  1.4.1
        efficiency  1.1.2.7
        parameters  8.2.1
        requirements  1.4.1.1
Call convention  8.2.1
        efficiency  1.1.2.7
Call interface, compatibility  8.1.1
CALL prototype syntax  10.1
Calling, programs  1.8
Calling C functions  9.1
CANCEL  1.4.1
Cancelling non-COBOL programs  9.1.2
Case conversion
        CBL_TOLOWER routine  15.3
        CBL_TOUPPER routine  15.3
        in National Language Support  6.5 , 6.5.5
Case sensitivity and portability  5.8.4
CBL_ALLOC_MEM  15.3
        efficiency  1.1.2.8
CBL_AND  15.3
CBL_CLOSE_VFILE  15.3
CBL_CULL_RUN_UNITS  15.3
CBL_EQ  15.3
CBL_ERROR_PROC  15.3
CBL_EXEC_RUN_UNIT  15.3
CBL_EXIT_PROC  15.3
CBL_FREE_MEM  15.3
CBL_GET_OS_INFO  15.3
CBL_GET_SHMEM_PTR  15.3
CBL_IMP  15.3
CBL_NOT  15.3
CBL_OPEN_VFILE  15.3
CBL_OR  15.3
CBL_PUT_SHMEM_PTR  15.3
CBL_READ_VFILE  15.3
CBL_SCR_SET_PC_ATTRIBUTES  15.3
CBL_SUBSYSTEM  15.3
CBL_TOLOWER  15.3
CBL_TOUPPER  15.3
CBL_WRITE_VFILE  15.3
CBL_XOR  15.3
CBL_YIELD_RUN_UNIT  15.3
Character sets
        converting  6.7.4
        extended character set and portability  5.8.6
CHARSET Compiler directive  6.7.1
Child run-unit  12.2
CHIP Compiler directive  5.6
Class condition tests in National Language Support  6.5.2
Closedown procedure registration  15.3
cobaddch routine  9.3.5
cobaddstr routine  9.3.5
cobaddstrc routine  9.3.5
cobcall function  9.3.1
cobcancel function  9.3.1
cobchtype  9.3.5
cobclear routine  9.3.5
cobcols routine  9.3.5
cobexit function  9.3.2
cobfunc function  9.3.1
cobgetch routine  9.3.5
cobgetenv routine  9.3.4
cobgetfuncaddr function  9.3.1
cobinit function  9.3.2
cobkeypad routine  9.3.6
COBLANG environment variable  6.5
Coblines routine  9.3.5
coblongjmp function  9.3.8
COBLPFORM environment variable  13.5
cobmove routine  9.3.5
COBOL
        call conventions  8.2.1
        calling C functions  9.1
        interfacing environment  Ch8
        interfacing with C  9.3
COBOL language, advanced features  Ch2
COBOL protection violations  4.2.2
COBOL syntax
        not implemented  3.2.1
        used for interfacing  8.2
COBOL system, System
COBOL type definition  10.1
cobpostsighandler routine  9.3.9
COBPRINTER environment variable  13.5
cobprintf routine  9.3.5
cobputenv routine  9.3.4
cobremovesighandler  9.3.9
cobrescanenv routine  9.3.4
cobscreen.h header file  9.3.5
cobscroll routine  9.3.5
cobsetjmp() function  9.3.8
COBTERMINFO environment variable, and wide mode  9.3.6
cobtermmode routine  9.3.6
cobthreadtidy function  9.3.3
cobtidy function  9.3.2 , 9.3.2
Codecomp utility  6.7.5
Codepage environment in National Language Support  6.3
_CODESET program, configuring  6.7.5
Collating sequence for ASCII and EBCDIC  6.7.3
Colorizing applications  11.3.2.1
Column, number in wide mode  9.3.6
COMMAND-LINE function-name  13.5
Communication
        between programs  1.4.1
        between run-units  12.2.1
COMP Compiler directive  1.1.3.1
COMP usage  1.1.1
COMP-3  1.1.1
COMP-5
        efficiency  1.1.1
        representation  8.2.3
        speed  1.1.1
COMP-X
        efficiency  1.1.1
        representation  8.2.3 , 8.2.3
        speed  1.1.1
Comparisons
        EQUALS  1.1.2.4
        GREATER  1.1.2.4
        LESS  1.1.2.4
        NOT EQUAL  1.1.2.4
Compiler directives
        ALIGN  1.1.3.2
        CHIP  5.6
        efficiency  1.1.3
        ENDP  14.2
        FLAG-CHIP  5.6
        INTLEVEL  5.1
        MF  5.4.1
        NLS  6.4
        portability  5.7
        PREPROCESS  14.2
        RETRYLOCK  5.6
        size optimization  1.1.3.2
        speed optimization  1.1.3.1
        XREF  14.1.1
Compiling, native object code  Ch8
Concurrency support  Ch12
Conditional statement efficiency  1.1.2.4
Conditions  1.1.2.4
Configuration file
        attributes tag  11.3.2.1
        color  11.3.2.1
        comment indicators  11.3.3
        comments  11.3.3
        error messages  11.4.2
        examples  11.3.4
        location  11.2.1
        mfcobolrc  11.2.2
        mftools  11.4.1
        mftools.cfg  11.2.1
        structure  11.3
        tag  11.3
        tag indicators  11.3.1
        tag names  11.3.2
Configuration System, Application Configuration System
Configuring applications, Application Configuration System
CONSOLE  13.5
COPY limits  3.1.2
Core heap size  3.1.5
Correcting protection violations  4.4
CORRESPONDING phrase  1.1.2.1
Coru  12.2
Create named values  15.3
Ctrl key portability  5.8.7
Currency sign and National Language Support  6.3 , 6.5
Currency sign and NLS  6.5.8

D

Data item maximum size  3.1.2
Data types
        COMP-5  8.2.3
        COMP-X  8.2.3
        efficiency  1.1.1
        storage representation  8.2.3
DBCS
        support  6.1.2
        transparency  6.1.2.1
Debugging, applications containing protection violations  4.5
Decimal point  1.1.2.1
DEFAULTCALLS Compiler directive  1.1.2.7
DISPLAY statement  6.7.1 , 6.7.2
DISPLAY UPON ENVIRONMENT-NAME  2.4
DISPLAY UPON ENVIRONMENT-VALUE  2.4
DISPLAY usage  1.1.1
Double-Byte Character Set support  6.1.2

E

EBCDIC
        collating example  6.7.3
        collating sequences  6.7.3
        converting to ASCII  6.7
        converting to ASCII using _CODESET  6.7.4
Editing NLS programs  6.5.7
Efficiency  1.1
Embedded directives and portability  5.8.10
ENDP Compiler directive  14.2
ENTRY  3.2.3
Entry point  1.6 , 3.2.3
Environment variables
        COBLANG  6.5
        LANG  6.5
        setting  2.4
ENVIRONMENT-NAME function-name  2.4 , 13.5
ENVIRONMENT-VALUE function-name  2.4 , 13.5
EQ logic operator  2.5.1
Equivalence logic operator  15.3
Error messages
        Application Configuration System  11.4.2
        Integrated Preprocessor  14.3.2.2
Error procedure registration  15.3
Error procedure routines  15.1.4
ERRORLEVEL  8.2.5
Example, configuration file  11.3.4
eXclusive-OR logic operator  15.3
EXIT  1.4.1
Exit procedure registration  15.3
Exit procedure routines  15.1.4
External data efficiency  1.1.2.8
External File Mapper, environment variables  2.4

F

Files, portability  5.9.1
FLAG-CHIP Compiler directive  5.6
Flicker, with Animator  9.3.6
Floating-point
        external data item  1.3.3
        implementation (32-bit and 64-bit)  1.3
        inaccuracies  1.3.4
        literal  1.3.3
FORMFEED function-name  13.5
Free dynamically allocated memory  15.3

G

General protection violation  4.2.1
General protection violations  4.2.1
Generated code portability  5.3
GO TO statement, efficiency  1.1.2.6

H

H2cpy  Ch10
        command-line options  10.2.1
        invoking  10.2
Handling large programs  1.4
Handling return codes  8.2.5
Header-to-COPY  Ch10
Headers preprocessor  10.2.3
Heap routines
        close heap  15.3
        open heap  15.3
        read heap  15.3
        write heap  15.3

I

IF statement
        collating considerations  6.7.3
        efficiency  1.1.2.4
IMP logic operator  2.5.1 , 15.3
Inheritance  1.10
Initialization data  1.1.2.1
Instance, recursion  2.1.1
Integrated Preprocessor  Ch14
        interfacing with Compiler  14.3.1
        invoking  14.2
        parameters  14.3.1.1
        response codes  14.3.2
        stack  14.3.4
        writing  14.3
Integration tools  Ch11
Inter-program communication  1.4.1
        CALL  1.4.1
Intercommunication between run-units  12.2.1
Interfacing  Ch9
        COBOL syntax  8.2
        environment  Ch8 , 8.2
Intermediate code
        creating portable  5.4
        vs native code  5.3
Internationalization Support  Ch6
INTLEVEL Compiler directive  5.1
intrins.cbl sample program  2.3
Intrinsic functions
        coding  2.3
        in National Language Support  6.5.8
Invoking, H2cpy  10.2

J

No entries

K

No entries

L

LANG environment variable  6.5
Language and National Language Support  6.3 , 6.5.9
Language levels and Integrated Preprocessor  14.3.4
Large programs, handling  1.4
Library files and entry points  1.6
Library routines  Ch15
        application subsystem  15.1.1
        CBL_ALLOC_MEM  15.3
        CBL_CLOSE_VFILE  15.3
        CBL_CULL_RUN_UNITS  15.3
        CBL_ERROR_PROC  15.3
        CBL_EXEC_RUN_UNIT  15.3
        CBL_EXIT_PROC  15.3
        CBL_FREE_MEM  15.3
        CBL_GET_OS_INFO  15.3
        CBL_GET_SHMEM_PTR  15.3 , 15.3
        CBL_OPEN_VFILE  15.3
        CBL_READ_VFILE  15.3
        CBL_SCR_SET_PC_ATTRIBUTES  15.3
        CBL_SUBSYSTEM  15.3
        CBL_TOLOWER  15.3
        CBL_TOUPPER  15.3
        CBL_WRITE_VFILE  15.3
        CBL_YIELD_RUN_UNIT  15.3
        error procedure  15.1.4
        exit procedure  15.1.4
        logic operators  2.5
        memory handling  12.3 , 15.1.3
        multiple run-units  12.2 , 12.2.1
        National Language Support  6.5.1 , 6.6
        NLS  6.5.4
        operating system information  15.1.6
        portability  15.1.7
        run-units  12.3 , 15.1.3
        text  6.5.5 , 15.1.8
        virtual heap  15.1.9
Library routines (call-by-name)
        portability  5.4.1 , 5.6
Limits, COBOL system  Ch3
Linkage Section  1.1.2.8
        efficiency  1.1.2.8
Linking, as source of protection violations  4.4.7
LITVAL-SIZE Compiler directive  8.2.2
Local-Storage Section  2.1.1 , 2.1.2 , 3.2.5
Locale and National Language Support  6.3
Logic operators
        AND  15.3
        Calling  2.5.1
        efficiency  1.1.2.5
        EQuivalence  15.3
        eXclusive-OR  15.3
        IMPlies  15.3
        library routines  2.5
        NOT  15.3
        OR  15.3
Lowercase, CBL_TOLOWER  15.3

M

Managing multiple run-units  12.2
Maximum
        core heap size  3.1.5
        data item size  3.1.2
        EXTERNAL data item size  3.1.2
        nesting  3.1.3
        number of names  3.1.2
        number size  3.2.7
        OCCURS (screen section)  3.1.2
        parameters in USING  3.1.2
        program size  3.1.2 , 3.1.2
        programs loaded  3.1.3
        record size  3.1.2
        table dimensions  3.1.2
Memory
        CBL_ALLOC_MEM  15.3
        CBL_FREE_MEM  15.3
        free dynamically allocated  15.3
        library routines  12.3 , 15.1.3
Menu Handler and Application Configuration System  11.3.4
MF Compiler directive  5.4.1
mfcobolrc configuration file  11.2.2
Mfconfig program, Application Configuration System
mftools.cfg configuration file  11.2.1 , 11.4.1
Mixed-language programming  Ch8 , Ch9
Multiple run-units
        concurrency  12.1
        dynamically allocated memory  12.2.1
        intercommunication  12.2.1
        management  12.2
        named values  12.2.1

N

Named values
        allocate memory  15.3
        create/update  15.3
        read  15.3
National Language Support
        adisctrl database  6.2
        case conversion  6.5 , 6.5.5
        class condition tests  6.5.2
        codepage environment  6.3
        collating sequence  6.5.6
        currency symbol  6.3 , 6.5 , 6.5.8
        editing programs  6.5.7
        indexed sequential file  6.5.3
        intrinsic functions  6.5.8
        language environment  6.3 , 6.5.9
        library routines  6.5.1 , 6.5.4 , 6.6
        locale  6.3
        %NLS%  6.5.3
        territory environment  6.3
        using  6.2
NATIVE Checker directive collating considerations  6.7.3
Native object code  Ch8
NESTCALL Compiler directive  1.1.2.7 , 1.1.3.1
Nesting limits  3.1.3
NLS, National Language Support
NLS Compiler directive  6.4
Non-COBOL programs, canceling  1.5.2
NOT logic operator  2.5.1 , 15.3
Numbers, maximum size  3.2.7
Numeric items and National Language Support  6.5
Numeric overflow checking  1.1.3.1

O

OCCURS, maximum in screen section  3.1.2
OCCURS DEPENDING ON clause, efficiency  1.1.2.3
ON SIZE ERROR phrase  1.1.2.1
        optimization  1.1.2.1
Operating system
        CBL_GET_OS_INFO  15.3
        portability features  5.8.1
Operating system information routines  15.1.6
Optimizing
        for small program  1.1.3.2
        for speed at run time  1.1.3.1
OR logic operator  1.1.2.5 , 2.5.1 , 15.3
Ordering parameters  8.1.1.1
Originator run-unit  12.2

P

Pack byte  15.3
Packing bytes  15.1.2
Parameter, mismatch as source of protection violations  4.4.2
Parameters  8.2.1
        alignment  8.2.4
        efficiency  1.1.2.8
        format  8.1.1.2
        methods of passing  8.1.1.2
        ordering  8.1.1.1
        passed by value  8.2.2
        passing by reference  8.1.1.2
        passing by value  8.1.1.2
        received by value  8.2.2
Parent run-unit  12.2
PERFORM
        efficiency  1.1.2.6
        nesting  3.2.6
Performance  1.1
Pointer
        as source of protection violations  4.4.5
        illegal  4.4.5
Portability
        ACCEPT and DISPLAY  5.6
        alt/ctrl keys  5.8.7
        case sensitivity  5.8.4
        COBOL syntax  5.5
        Compiler directives  5.7
        embedding directives  5.8.10
        extended character sets  5.8.6
        file  5.9.1
        guidelines  5.8
        issues  Ch5
        library routines (call-by-name)  5.6
        operating system features  5.8.1
        path specification  5.8.5
        requirements  5.2
        restrictions  5.6
        RM COBOL  5.6
        RM file status  5.6
        ROLLBACK statement  5.8.11
        screen I/O  5.8.3
        $SET statement  5.8.10
        source code  5.9
        Undefined results  5.8.8
        USAGE COMP-5  5.8.9
        user attribute byte  5.8.2
Portability routines  15.1.7
Precompilers  Ch14
PREPROCESS Compiler directive  14.2
Preprocessor, Integrated Preprocessor
Printer channels  13.5
PRINTER function-name  13.5
Program
        cancelling non-COBOL programs  9.1.2
        codecomp  6.7.5
        maximum size  3.1.2 , 3.1.2
        mixed language  Ch9
Program calling conventions  1.8
Program management in the run-time system  1.9
Program names
        in the run-time system  1.8.1
        resolving  1.8.1
PROGRAM-ID paragraph  1.10.1
Programming
        mixed language  Ch9
        restrictions  1.4 , 3.2.2
Programs
        maximum animated  3.1.3
        maximum loaded  3.1.3
Protection violation  Ch4
        behavior  4.3.2
        COBOL  4.2.2
        correcting  4.4
        correcting illegal pointer values  4.4.5
        correcting illegal reference modification  4.4.4
        correcting in non-COBOL code  4.4.1
        correcting linker errors  4.4.7
        correcting out-of-range subscripts  4.4.6
        correcting parameter mismatches in CALLs  4.4.2
        correcting stack overflow  4.4.3
        debugging techniques  4.5
        described  4.2
        effects  4.3
        error handling  4.3.1
        general  4.2.1
Public symbols, PROGRAM-ID  1.4.1.2

Q

No entries

R

Read named value  15.3
Record, maximum size  3.1.2
Recursion  2.1.1
        entry point  2.1.2
        instance  2.1.1
        writing routines  2.1
REF Compiler directive  1.1.1
Reference modification
        as source of protection violations  4.4.4
        versus STRING statement  2.2
REMAINDER phrase  1.1.2.1
REPLACE verb and Integrated Preprocessor  14.3.3
Representation of data types  8.2.3
Requirements, CALL  1.4.1.1
Restrictions, programming  3.2
RETRYLOCK Compiler directive  5.6
Return code  8.2.5
RETURN-CODE  8.2.1 , 8.2.1 , 8.2.5
        efficiency  1.1.2.7
RETURNING phrase  8.2.1 , 8.2.5
RM file status portability  5.6
ROLLBACK statement portability  5.8.11
ROUNDED phrase  1.1.2.1 , 1.1.2.1
Routines, Library routines
RTNCODE-SIZE Compiler directive  8.2.5
Run-time, errors  1.5.2.1
Run-time system, program management in the run-time system  1.9
Run-unit
        child  12.2
        coru  12.2
        library routines  12.3 , 15.1.3
        management  12.2
        originator  12.2
        parent  12.2
Run-unit routines
        allocate dynamic memory  15.3
        clear  15.3
        create run-unit  15.3
        create/update named value  15.3
        free dynamic memory  15.3
        read named value  15.3
        yield time-slice  15.3
Run-units
        See multiple run-units
        intercommunication  12.2.1

S

Sample programs, intrins.cbl  2.3
Screen handling portability  5.8.3
Searching
        in the run-time system  1.10
        multiple directories  1.10.1
Segmentation  1.4
Segmented program  3.2.2
SET ADDRESS statement  8.2.3
$SET statement portability  5.8.10
Setting environment variables using Mfextmap  2.4
Sort, efficiency  1.1.2.9
SORT statement collating considerations  6.7.3
Source code portability  5.9
Stack, ordering parameters on  8.1.1.1
Stack overflow, as source of protection violations  4.4.3
Storage representation of data types  8.2.3
Stride  1.1.1 , 1.1.2.3
String
        CBL_TOLOWER  15.3
        CBL_TOUPPER  15.3
STRING statement, versus reference modification  2.2
Subscript
        as source of protection violations  4.4.6
        maximum number  3.1.2
Subsystem routines, declare/deallocate  15.3
System
        attributes  11.3.2.1.1
        limits  Ch3
        specifications  3.1
SYSTEM routine  9.3.7

T

TAB function-name  13.5
Table handling efficiency  1.1.2.3
TERM environment variable  9.3.6
Terminal
        mode changes  9.3.6
        reinitialization for Animator  9.3.6
Territory environment and National Language Support  6.3
Text routines  15.1.8
        convert to lower case  15.3
        convert to upper case  15.3
tools.lbr  11.4
Trickle  1.1.2.6
TRUNC Compiler directive  1.1.1 , 1.1.3.1

U

Undefined results, portability  5.8.8
Unpack byte  15.3
Update named values  15.3
Upper case, convert a string to  15.3
USAGE COMP-5, portability  5.8.9
USE GLOBAL AFTER, maximum number in program  3.1.2
User attribute byte portability  5.8.2
USING, maximum number of parameters  3.1.2
USING phrase  1.4.1
Utility, Codecomp  6.7.5

V

Virtual heap routines  15.1.9

W

Wide mode
        and Animator  9.3.6
        and COBTERMINFO environment variable  9.3.6
        number of columns  9.3.6
Windowing syntax, portability  5.6
WRITE
        BEFORE/AFTER PAGE  13.5
        BEFORE/AFTER TAB  13.5

X

X"F4" - pack byte  15.3
X"F5" - unpack byte  15.3
X/Open environment variables  2.4
XOR logic operator  1.1.2.5 , 2.5.1 , 15.3
XREF Compiler directive  14.1.1
        integrated preprocessor  14.1.1

Y

Yielding run-unit time-slice  15.3

Z

No entries