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 Web runtime, these resources can be applications, bitmap, JPEG, PNG or TIFF image files, 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 to include, separated by a space. Be sure to add the main or initial program to the library first, because the Web runtime executes the first program it finds in the library.


cblutil -lib [options] main_program modules


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

When using cblutil -lib, you must use the -o option to specify the name of the output file. Because the Web runtime is registered to run files with the .acu extension, the output library file must have the .acu extension. In the example above, mylib.acu is the specified output file.