9.1 Copy Files

All source files of the application which imply any reference to the DM have to include the files IDMcobws.cob or IDMcobls.cob provided by the DM. Depending on where these files were installed, the include path for the compiler has to be set.

• IDMcobws.cob

  This file contains all definitions of the Dialog Manager and must be included once into the working storage section of the application. COBOL allocates memory for the defined structures in this file so that the application can access the data inside of it.

  This file has to be copied in a module exactly once in each application.

• IDMcobls.cob

  This file contains all definitions of the Dialog Manager without the values. This file can be included into the linkage storage section of all other COBOL subprograms. This file makes the definitions of the Dialog Manager available without allocating memory.

  You can use this file as often as you want in an application.

• IDMcobls.cob

  This file contains all definitions of the Dialog Manager without values. It can be copied into the linkage storage section of all other COBOL subprograms. With this file you can conserve the Dialog Manager definitions without allocating memory capacity. You can therefore use this file in the application as often as you want.

• IDMcoboc.cob

  This file must be included into those COBOL programs which are using the COBOL callback function of the Dialog Manager. Since this file does not contain value definitions but only a structure definition, this file has to be copied into the linkage storage section.

If, in the application, COBOL functions are included which are called directly by the DM and which have a record as parameter, the COBOL file generated of the DM via the option +writetrampolin has to be copied into the respective module in the linkage storage section, too. It is the only way you can access this structure in the COBOL program.

Apart from these COBOL copy files the following C Include files are necessary to create a runnable COBOL-DM program.

• IDMuser.h

  This file contains all definitions of the DM for the programming language C. It is needed for compiling the C modules which have been generated with the program gencobfx or the option +writetrampolin. This file is included there.

• IDMcobol.h

  This include file is only needed when records are to be transferred to COBOL functions. The module generated with the option +writetrampolin includes this file.