If You're Using...Next

Chapter 1: Introduction

This book is intended to help users of:

to migrate applications to this product (Server Express). This book guides you through the code and build changes that you might need to make to migrate existing applications.

You should read the Getting Started book before reading this or any other documentation provided with this product.

The rest of this chapter briefly describes how the approach to creating an application with this product differs from your previous product. The remaining chapters are reference chapters where you can look-up particular features and find outline advice on migrating them.

Product differences that do not require you to make any changes are not, in general, mentioned in this book; these include new features of the product which do not require any specific migration considerations. You should ensure that you read the Getting Started book for an overview of the new features of this product.

1.1 Where You're Coming From

Migrating from previous products can lead to problems when recompiling source code or executing programs, or in understanding the differences in theinterface and behavior. You should bear the following in in mind when migrating.

1.1.1 From Object COBOL V4.1 for UNIX

In Server Express, all the facilities that you are used to - notably source-level debugging, or animation - can be used on an all executable file types (that is, on. .int, and .gnt files, system executables, and the new callable shared object files).

1.1.2 From COBOL V4.0 for UNIX

In addition to the changes that were introduced in Object COBOL V4.1 for UNIX, Server Express enables you to create, debug and execute applications that use Object-Oriented COBOL syntax extensions.

1.1.3 From other products

You can migrate applications from older versions of Micro Focus COBOL for UNIX. The V3.x COBOL systems have the same migration issues as detailed in the previous sections. If you want to migrate applications from COBOL V1.3 for UNIX there is still a very high degree of source code compatibility (see below), but the architecture of the product, applications and user-interfaces have changed.

If you are migrating applications from Micro Focus NetExpress, you will notice a high degree of common technology, specifically the support of threaded applications, HTML syntax support and many other new features. However, Server Express use character-based interefaces, therefore the user interfaces for most development tools is markedly different.

1.2 Code Compatibility

The following section describe how source code created using earlier versions of COBOL for UNIX is handled by Server Express.

1.2.1 Source code

COBOL source code developed in previous products should compile cleanly with Server Express. You need to be aware of certain changes in the behavior of Compiler directives and cob flags, which are referred to later in this book.

1.2.2 Debugging

It is not possible to debug an application compiled with an earlier version of Micro Focus COBOL. You need to recompile the application.

1.2.3 Executable code formats

Although source code written for previous products (see above) should compile cleanly on this product., the .gnt files, .o files and system executable files produced by these systems are not compatible with Server Express. You need to rebuild your application.

.int files should be compatible unless they contain object-oriented code.

1.3 Data files

Data files created using earlier versions of Micro Focus COBOL for UNIX are supported by this product.

1.4 Undefined Results

The value returned by some COBOL operations is specified in the Language Reference as undefined; for example, dividing by zero, or using data that does not conform to a picture clause. If you were to examine the values actually returned by these operations, you would find that they differ according to the executable file format and the COBOL system on which the program was compiled. For example, a divide-by-zero operation might return a different value in an intermediate code program to that returned in a generated code program.

You should ensure that the results or logic of your program do not depend on the results of operations specified as giving undefined results. For example, as the result of a divide-by-zero operation is unpredictable, you should always use the ON SIZE ERROR phrase if you want a specific action or procedure to be performed depending on this result.

1.5 Performance Considerations

This product is geared to improving the efficiency of the applications it creates, and should provide a noticeable improvement in execution speed over applications built with previous products. As no two applications are the same, it is difficult to give precise details of what performance improvements you can expect.

Run-time Considerations:
Compilation Considerations:


Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.
If You're Using...Next