PreviousNew Features in Server Express 2.0 Compiler Directives and DialectsNext

Chapter 5: COBOL System Library Routines

This chapter lists differences in the COBOL system library routines compared to Object COBOL Development System and earlier Micro Focus COBOL for UNIX systems.

5.1 Description of Routines

Routines are listed alphabetically in the following sections. If a routine is not mentioned, we believe no change is needed.

5.1.1 CBL_COPY_FILE

If you specify to the CBL_COPY_FILE library routine a target file that exists as a read-only file, the routine returns the file status 9/37.

5.1.2 CBL_GET_KBD_STATUS and CBL_READ_KBD_CHAR

If the CBL_GET_KBD_STATUS and CBL_READ_KBD_CHAR library routines are used before enhanced ACCEPT/ DISPLAY syntax is used, the behavior is undefined (that is, behavior might be different when used on different platforms or on different product releases).

To ensure consistent behavior, use the enhanced ACCEPT/DISPLAY syntax first. For example, add the following to the top of your main program:

DISPLAY SPACES UPON CRT

See the chapter Low-level Routines for Character Interfaces in your Programmer's Guide to Creating User Interfaces for more information on these routines.

See the Adis chapter of the Programmer's Guide to Creating User Interfaces book for more details.

5.1.3 CBL_YIELD_RUN_UNIT

In versions of COBOL for UNIX before Server Express, the function CBL_YIELD_RUN_UNIT did not do anything. In Server Express it will yield to other run units. On some environments this can result in a one-second pause.

For a description of the CBL_YIELD_RUN_UNIT routine, see the chapter Library Routines in your Programmer's Guide to Writing Programs.

5.1.4 cobprt()

The cobprt() routine has been removed from this product as obsolete. A number of alternative options for accessing printer functions exist. These are documented in the Language Reference.

5.1.5 cobprtscrn()

The cobprtscrn() routine has been removed from this product as obsolete. A number of alternative options for accessing printer functions exist. These are documented in the Language Reference.

5.1.6 cobprtstring()

The cobprtstring() routine has been removed from this product as obsolete. A number of alternative options for accessing printer functions exist. These are documented in the Language Reference.

5.1.7 cobsavenv()

The cobsavenv() routine has been replaced by the cobsetjmp() routine. We recommend changing the interface of calls to cobsavenv() to use cobsetjmp(). This new interface is documented in the chapter Mixed-language Programming in your Programmer's Guide to Writing Programs.

5.1.8 usercall.c

This method of calling C from COBOL using usercall.c has been removed from this product as obsolete. A more effective method is to use the CALL “C_func” functionality, as documented in the chapter Mixed-language Programming of your Programmer's Guide to Writing Programs.

5.2 The mkrts Utility

The utility mkrts is a shell script that helps you relink a run-time system; it is no longer required. In almost all cases where mkrts might have been required in previous products, a more effective alternative now exists. Specifically, the introduction of callable shared objects in this product means that you no longer have to link your application (including any mixed-language modules and run-time support routines) into a static executable for onward shipment. Instead, shipping an application together with a copy of the Application Server provides a more efficient application, and makes creating and shipping applications simpler. For further information about packaging applications and using callable shared objects, you should refer to your Server Express User's Guide.


Copyright © 2000 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.

PreviousNew Features in Server Express 2.0 Compiler Directives and DialectsNext