6.3 Using Directives
Directives are optional comments that you can place into an FD in your COBOL source code
to control how the data dictionary is built. By controlling how data
dictionaries are built, you can guide the way AcuODBC maps the content of COBOL records
to application data fields.
Among other things, directives enable you to
- specify a column name to be used in place of a COBOL field name.
- map elementary items of a group item together into a single column.
- cause the fields from a specific record in a file to appear in the database
table (rather than just the fields from the largest record).
- give a name to the data dictionary file itself.
Directives are always placed within a COBOL FD. They do not affect Procedure Division I/O statements, and they do not change your COBOL fields in any way. Rather, they guide the building of the
data dictionaries, giving you a measure of control over the way COBOL data is mapped to data fields in your ODBC application.
Remember: Each field in the ODBC-enabled application must correspond to a data item in
your COBOL FD or XFD. To ensure that this is the case, you may need to use the NAME directive to add
fields to the data dictionary.
Data dictionaries may be built directly from your source code with no
directives if the compiler's default mapping rules are sufficient for your situation.
If you would like to override the default mapping behavior, or map a field to a
different name, you would add directives to your COBOL code.
More:
6.3.1 Sample Files and Examples
6.3.2 Syntax
6.3.3 AcuODBC HIDDEN Directive
6.3.4 AcuODBC READ-ONLY Directive
6.3.5 COMMENT Directive
6.3.6 DATE Directive
6.3.7 FILE Directive
6.3.8 NAME Directive
6.3.9 NUMERIC Directive
6.3.10 USE GROUP Directive
6.3.11 WHEN Directive