PROGRAMDUMP Options

<programdump option> 

──┬─ ARRAY ────────────┬───────────────────────────────────────────────┤
  ├─ ARRAYS ───────────┤
  ├─ PRESENTARRAY ─────┤
  ├─ PRESENTARRAYS ────┤
  ├─ BASE ─────────────┤
  ├─ CODE ─────────────┤
  ├─ DBS ──────────────┤
  ├─ FILE ─────────────┤
  ├─ FILES ────────────┤
  ├─ LIBRARIES ────────┤
  ├─ PRIVATELIBRARIES ─┤
  ├─ CRITICALBLOCK ────┤
  └─ ALL ──────────────┘

The information included in the dump depends on the options specified. If no program dump options are specified, the stack is dumped according to the specifications in the task attribute OPTION of the program. The following table describes the results of specifying each program dump option:

Option

Result

ARRAY or ARRAYS

Causes the contents of all arrays declared in the program to be dumped.

PRESENTARRAY or PRESENTARRAYS

Causes only the arrays in the present state (at the time the program dump is taken) to be dumped. If the ARRAY or ARRAYS program dump option is set along with the PRESENTARRAY or PRESENTARRAYS program dump option, all arrays will be dumped.

BASE

Causes the base of the stack to be dumped. The operating system uses a portion of each stack to contain various words needed to control, identify, and log the program. If the TODISK option is also specified, the base of the stack and the program information block (PIB) are always dumped for any stack dumped.

CODE

Causes segment dictionary information to be included in the dump. The actual code is dumped only for segments that have been referenced by the program when the program dump occurs. Value arrays in the segment dictionary are dumped when both the CODE option and either the ARRAY or ARRAYS option are specified.

DBS

Causes the output of database stacks to be dumped.

FILE or FILES

Causes information about each file declared in the program to be dumped. For each file, each word of the file information block (FIB) is separately named and, in some cases, analyzed.

LIBRARIES

Causes the stacks of all libraries that are being used by the program to be dumped.

PRIVATELIBRARIES

Causes the stacks of all private libraries that are being used by the program to be dumped.

CRITICALBLOCK

Causes the stack that contains the critical block visible to the calling stack to be dumped. Dumping starts at the offset specified by the critical block reference in the Process Information Block of the calling stack.

ALL

Equivalent to specifying all the other options. The ALL option has no effect on the program dump destination. If the TODISK or TOPRINTER destination options are needed, they must be explicitly mentioned.

If the arithmetic expression option is used, the value in the arithmetic expression corresponds to the bit values in the OPTION word. The value of the expression is interpreted as follows:

Value

Meaning

[ 7:1] = 1

The base of the user stack is dumped.

[ 8:1] = 1

Array contents are dumped.

[ 9:1] = 1

The segment dictionary is dumped.

[10:1] = 1

Files are dumped.

[11:1] = 1

Present array contents are dumped.

[15:1] = 1

Database stacks are dumped.

[19:1] = 1

Stacks for libraries that the program is linked to are dumped.

[20:1] = 1

Stacks for private libraries are dumped.

[23:1] = 1

Destination of the dump is the disk.

[24:1] = 1

Destination of the dump is the printer.

[25:1] = 1

The stack containing the critical block is dumped.
Prev  Up  Next
PROGRAMDUMP Statement  Home  Programdump Destination Options