ContentsIndexPreviousNext

5.4.4.1 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 plug-in, these resources can be applications, bitmaps, wave files, configuration files, and/or an 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, then 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 plug-in executes the first program it encounters in the library.

Syntax:

     cblutil -lib [options] main_program modules

Example:

     cblutil -lib -v -o mylib.acu prog1.obj prog2.obj logo.bmp cblconfi data1.xfd data2.xfd


Note: Since the plug-in 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.