Generate Document Options

The Generate Document options let you determine the automatic code generation behavior you want AcuBench to perform. You can also change the default file extensions for generated files in this interface. When you change a default file extension, that change is also reflected in the Program Properties dialog box. Note that changes to these settings made on the Code Generation tab of the Program Properties dialog box override the default settings made in this Options > Generate Document interface. For information about this dialog box, see AcuBench Program Properties.

Set any desired Generate Document options as follows:

  1. Select the Generate Document category of the Code Generator options.
  2. The list of options under Generated documents are selected by default. These options have the following functions:
    • When Program file is selected, and Regenerate tagged area only is not selected, AcuBench generates code for the program source file, replacing the existing program_name.cbl file. You can change the default file extension (.cbl) in the associated entry field.
    • When both Program file and Regenerate tagged area only are selected, AcuBench generates code in the tagged portions of the program file (.cbl) only. This preserves any code that you may have added outside of the AcuBench tags.
    • When Working storage is selected, AcuBench generates the Working-Storage COPY file (.wrk). You can change the default file extension in the associated entry field.
    • When both Working storage and Exclude variables in program file are selected, AcuBench does not generate Working-Storage items in the .wrk file for variables that are already declared in the program file (.cbl).
    • When Event paragraph is selected, AcuBench generates the Event Paragraph COPY file (.evt). You can change the default file extension in the associated entry field.
    • When both Event paragraph and Exclude paragraphs in program file are selected, AcuBench does not generate paragraphs that are already included in the program file. The workbench assumes that a paragraph in the program file with the same name as a paragraph that could be generated in the .evt file suppresses the paragraph that could be generated.
    • When Screen section is selected, the workbench generates a Screen Section COPY file (.scr). You can change the default file extension in the associated entry field.
    • When Report section is selected, the workbench generates a Report COPY file (.rpt). You can change the default file extension in the associated entry field.
    • When AcuBenchProcedure division is selected, generates a Procedure Division COPY file (.prd). You can change the default file extension in the associated entry field.
    • When Menu paragraph is selected, AcuBench generates a Menu Paragraph COPY file (.mnu). You can change the default file extension in the associated entry field.
    • When Linkage section is selected, AcuBench generates a Linkage Section COPY file (.lks). You can change the default file extension in the associated entry field.
  3. For the two Attributes of generated files options:
    • Select Program file as read-only to cause the source program file (.cbl) to be created as a read-only file.
    • Select Copy book as read-only to cause all generated COPY files to be created as read-only files. This is the recommended behavior.
  4. Screen Control Focus option: Set a value for the ACCEPT-CONTROL variable (from 0 to 4) in the ACCEPT-CONTROL value entry field. The default value is 1. If you do not want an ACCEPT-CONTROL statement generated at all, select (none). For information about the purpose of ACCEPT-CONTROL, see General Rule 4 of the topic Special-Names Paragraph.
  5. Generated document format options: Select the Merge to one program file radio button if you want all of your AcuBench-generated code, including COPY files, written to a single program file. Note that AcuBench can handle approximately 200,000 total lines. If your files total more than this amount, the merged file may fail to produce.

    Set the Split to multiple copy files radio button if you want AcuBench to maintain your COPY files in separate files.

  6. Attributes of Data Set code generation option: Select Link file close to open if you want AcuBench to automatically generate a Close I/O paragraph for a data set when the Open option is already set. This code generation option is especially helpful if you are updating your Version 5.x AcuBench project to Version 6.x or later.