oneFormItemCopybook
When you are generating a COBOL program, the oneFormItemCopybook build descriptor option indicates whether the generated program accesses the values of form-field properties by way of COBOL SET statements.
Values
- NO (the default value)
- EGL generates a COBOL copybook into the definition of each form field, in the Data Section of the COBOL program. Access is direct, not requiring use of COBOL SET statements.
- YES
- EGL places a single copybook in the Linkage Section, and access is by COBOL SET statements.
Accepting the default value maximizes performance, and this should be done when possible. However, if your program uses many forms or if the forms contain many fields, EGL generates a large number of COBOL variable names; in this case, the COBOL compiler symbol table can become so large that compilation fails.
If you need to avoid the compilation problem just described, set oneFormItemCopybook to YES. With this setting, the EGL-generated code will invoke a COBOL SET statement whenever a form-field property value is accessed.
On z/OS®, if you are setting oneFormItemCopybook to yes,
you need to compile the COBOL code with one of these:
- IBM® Enterprise COBOL for z/OS® v3.2; or
- IBM® COBOL for OS390 or VM, version 2.2 or later, because earlier versions of this product do not support the appropriate form of the COBOL SET statement.