ACU_DUMP, ACU_DUMP_FILE, ACU_DUMP_WIDTH, ACU_DUMP_TABLE_LIMIT

These configuration variables are used to enable and configure the Abend Diagnostic Report (ADR) facility. For a complete description of the ADR, see Abend Diagnostic Report in the ACUCOBOL-GT User’s Guide.

ACU_DUMP

This variable enables the Abend Diagnostic Report. The default value is 0 (off, false, no). Set ACU_DUMP to 1 (on, true, yes) to turn on the ADR.

ACU_DUMP_FILE

This variable specifies the name of the report file. It allows the following special parameters:

  • If the file name starts with a plus sign ("+"), the report is appended to the specified file. By default, a new report overwrites the specified file.
  • If the name contains the string %p, when the report is generated that string is replaced with the process ID (PID) of the runtime from which the report originates.
  • If the name contains the string %d, that string is replaced with the current date in the form YYYYMMDD where YYYY is the year, MM month and DD day.
  • If the name contains the string %t, that string is replaced with the current time in the form HHMMSSTTT where HH is the hour, MM minute, SS second and TTT milliseconds.
  • If the name contains the string %u, that string is replaced with the username.
  • If the name contains the string %h, that string is replaced with the hostname.

The default value for ACU_DUMP_FILE is acudump.%p.

ACU_DUMP_WIDTH

This variable controls the width of the report and has a default value of 80 characters. The minimum allowed value is 79 and the maximum is 2048. Note that because the report uses dynamically computed columns for its hexadecimal data, making the report very wide can reduce readability by introducing excessive white space.

ACU_DUMP_TABLE_LIMIT

This variable limits how many elements of each table item to list. The default value is 1000. Note that if you increase this value substantially, and if you have tables that allow for large numbers of elements, you may get very large reports.

In the following example, ACU_DUMP_TABLE_LIMIT is set to 5: 

01 MY-TABLE-R                     = (group)
05 TABLE-ENTRY(1)                 =     1          h20202020 31
05 TABLE-ENTRY(2)                 =     2          h20202020 32
05 TABLE-ENTRY(3)                 =     3          h20202020 33
05 TABLE-ENTRY(4)                 =     4          h20202020 34
05 TABLE-ENTRY(5)                 =     5          h20202020 35
Remaining table items suppressed due to ACU-DUMP-TABLE-LIMIT setting
Parent topic: Configuration Variables