Using cblutil

The cblutil utility lets you embed resources, which are defined as pieces of static data, directly into an object file. For the purposes of the helper application, these resources can be applications, bitmaps, wave files, configuration files, and extended file descriptors (".xfd" files). The program treats the resource as if it were a disk file, but the resource is not actually a separate file in the target environment.

Using "cblutil -lib", you can specify any type of file as an input file. If an input file is a COBOL object, cblutil includes it in the resulting library as a COBOL object. If an input file is another library, each component of the library is individually added to the resulting library. Any other file is included as a resource.

To use the cblutil utility program, type "cblutil -lib" followed by the desired options, main program name, and all the modules you want included, separated by a space. Be sure to add the main or initial program to the library first, because the runtime executes the first program it encounters in the library.

Syntax

cblutil -lib [options] main_program modules 
Note: Since the helper application identifies content with the ".acu" extension, the output library file must have the ".acu" extension. For this reason, be sure to use the "-o" option to specify the name of the output file when using "cblutil -lib". In the example above, "mylib.acu" is the specified output file.

Example

cblutil -lib -v -o mylib.acu prog1.obj prog2.obj logo.bmp cblconfi data1.xfd data2.xfd
Note: Since the helper application identifies content with the ".acu" extension, the output library file must have the ".acu" extension. For this reason, be sure to use the "-o" option to specify the name of the output file when using "cblutil -lib". In the example above, "mylib.acu" is the specified output file.