DUMP

Generates a DEBUG dump item that contains all of the program variables, plus an optional user-specified message.

Optionally, a non-default application dump file can be specified. This can allow (for example) a support help desk to request a user to manually do an additional debug dump after a fatal error, to dump all the program's variables and their contents.

Syntax

DUMP {file-specifier} {[‘message’||“message”]}

DUMP {[‘message’||“message”]} {file-specifier}

Syntax elements

file-specifier A user-specified application dump file. If none is specified, the default BASIC-DUMPS file is assumed.

message An optional message to be included in the dump item (omitting the quote marks).

Comments

The DEBUG dump item that is written by this command contains all of the program's variables, regardless of the state of the DUMP.BASIC.VARS custom option.

If the default or specified application dump file does not exist the DUMP command is rejected.