viewc, viewc32 - view compiler for TUXEDO System/T views
viewc [-n] [-d viewdir] [-C] viewfile [viewfile ...] viewc32 [-n] [-d viewdir] [-C] viewfile [viewfile ...]
viewc is a view compiler program. It takes a source viewfile and produces 1) a binary file, which is interpreted at runtime to effect the actual mapping of data between FML buffers and C structures, 2) one or more header files, and 3) optionally COBOL copy files. When viewc is executed a C compiler must be available.
viewc32 is used for 32-bit FML. It uses the FIELDTBLS32 and FLDTBLDIR32 environment variables.
The viewfile is a file containing source view descriptions. More than one viewfile can be specified on the viewc command line as long as the same VIEW name is not used in more than one viewfile.
By default, all views in the viewfile are compiled and two or more files are created: a view object file (suffixed with .V) and a C header file (suffixed with .h). The name of the object file is viewfile.V in the current directory unless an alternate directory is specified through the -d option. C header files are created in the current directory.
If the -C option is specified, then one COBOL copy file is created for each VIEW defined in the viewfile. These copy files are created in the current directory.
At viewc compile time, the compiler matches each fieldid and field name specified in the viewfile with information obtained from the field table file, and stores mapping information in an object file for later use. Therefore, it is essential to set and export the environment variables FIELDTBLS and FLDTBLDIR to point to the related field table file. For more information on FIELDTBLS and FLDTBLDIR please refer to the TUXEDO FML Guide and the TUXEDO Programmer's Guide.
If the viewc compiler can not match a field name with its fieldid because either the environment variables are not set properly or the field table file does not contain the field name, a warning message "Field not found" is displayed.
With the -n option, it is possible to create a view description file for a C structure that is not mapped to an FML buffer. The TUXEDO Programmer's Guide tells how to create and use such an independent view description file.
The following options are interpreted by viewc:
The output view file is a binary file that is machine and compiler dependent. That is, it will not work to generate a view on one machine with a specific compiler and use it on another machine type or with a compiler that generates structure offsets differently (e.g., different padding or packing).
When a view file description file is compiled on DOS or OS/2, the name of the object file has a .VV suffix instead of a .V suffix since the file names are not case dependent. The following additional options are recognized.
Fintro(3fml), BEA TUXEDO FML Programmer's Guide, BEA TUXEDO Programmer's Guide