DISP.DB.DUMPS program
The DISP.DB.DUMPS cataloged DataBasic program displays DataBasic application dump items from either the default BASIC-DUMPS file or a user-specified alternative.
The program allows the items to be individually selected, displayed, printed and deleted as long as the user has the correct file access keys. Multiple items are processed in chronological order. All items are displayed unless filtered by an active select list.
Syntax
DISP.DB.DUMPS {file-specifier} {(options}
DISP.DB.DUMPS ?
Syntax elements
file-specifierSpecifies an alternative application dump file; if absent, the default BASIC-DUMPS file is assumed.
?Displays help information.
Options
AFilter to include ABORT dump items (caused by fatal runtime errors).
DFilter to include DEBUG dump items (generated by the DUMP command).
NInhibit break and interactive interface after each item.
PSend output to the printer.
SFilter to include SOFT dump items (generated by the BASIC.DUMP statement)
WFilter to include WARN dump items (caused by warning runtime errors).
Command class
Cataloged DataBasic program.
Restrictions
The verb is provided only in the SYSMAN account MD; if necessary it can be copied to other accounts. The program is shipped in SYSBP and also requires DISP.DB.DUMPS.ERR.
Note
The DISP.DB.DUMPS and DISP.DB.DUMPS.ERR MD entries can be copied to a different account in order to access a local dump file as used by the DUMP command.
Operation
If an active select list is present then only those dump items are displayed (subject to any specified options); otherwise, the program displays the following fields where applicable:
-
General program information
-
Message or error
-
Contexts/commands
-
Return stack
-
Variables
If a dump item contains any variables then they and their contents are also displayed.
If a variable does not fit in the page then the user is asked if they want to:
-
Stop displaying this variable and the item's other variables.
-
Continue displaying this and the rest of the variables.
-
Stop display of this variable and continue with the rest of the variables.
-
End the display of the variables
-
Quit the program.
If the variable fits on the page but there are more variables left to display then the user is asked if they want to:
-
Continue displaying the rest of the item's variables.
-
End the display of the variables.
-
Quit the program.
Once all of the item and its variables have been displayed or skipped the user is asked if they want to:
-
Delete this dump item.
-
Repeat the display of this dump item.
-
Print the dump item being displayed.
-
Proceed to the next dump item.
-
Quit the program.
The user is required to confirm any deletions.
Examples
WARN dump item
A DB.DUMP.MULTIPLE custom option is provided which, if set, causes the system to create multiple WARN or ABORT dump items even when reporting identical warning or fatal run-time error occurring on the same port, account, user, program and line number.
However, DB.DUMP.MULTIPLE is clear (unset) by default, meaning that multiple dump items are suppressed. Instead, a single WARN or ABORT dump item is created at the first occurrence and thereafter a duplicate count on the item is incremented each time the error recurs.
For example, a WARN dump item with a duplicate count of 249 means that the same error has occurred 250 times.
Type = Warning error message
Timestamp = 24 Sep 2014 10:15:20.2:D
Port = 401
Account = 16.0
User = TESTER
Program Name = DUMP.SUB2
Line# = 7, [6]
Duplicates = 249
Stack = Call DUMP.SUB1 16, [15]
Gosub DUMP.SUB1 8, [7]
Call DUMP.TST 15, [14]
Gosub DUMP.TST 7, [6]
Abort/Warning reason:
[B10] Program DUMP.SUB2 Line 7, [6]: Unassigned variable B; zero used.
Variables:
ARRAY(1,1)= <unassigned>
ARRAY(1,2)= <unassigned>
ARRAY(1,3)= <unassigned>
ARRAY(1,4)= <unassigned>
B = <unassigned>
A = <unassigned>
ITEM = <unassigned>
FRED = <unassigned>
If an error has occurred only once, the Duplicates = line is not displayed.
SOFT dump item
Type = Program BASIC.DUMP statement
Timestamp = 24 Sep 2014 10:15:20.2:E
Port = 401
Account = 16.0
User = TESTER
Program Name = DUMP.SUB2
Line# = 14, [13]
Stack = Gosub DUMP.SUB2 8, [7]
Call DUMP.SUB1 16, [15]
Gosub DUMP.SUB1 8, [7]
Call DUMP.TST 15, [14]
Gosub DUMP.TST 7, [6]
Message = program message
Variables:
ARRAY(1,1)= <unassigned>
ARRAY(1,2)= <unassigned>
ARRAY(1,3)= <unassigned>
ARRAY(1,4)= <unassigned>
B = <unassigned>
A = <unassigned>
ITEM = <unassigned>
FRED = <unassigned>
ABORT dump item
An ABORT dump item with a duplicate count of 1 means that the same error has occurred twice.
Type = Abort error message
Timestamp = 24 Sep 2014 10:15:20.2:F
Port = 401
Account = 16.0
User = LTESTER
Program Name = DUMP.SUB2
Line# = 15, [14]
Duplicates = 1
Stack = Gosub DUMP.SUB2 8, [7]
Call DUMP.SUB1 16, [15]
Gosub DUMP.SUB1 8, [7]
Call DUMP.TST 15, [14]
Gosub DUMP.TST 7, [6]
Abort/Warning reason:
[B12] File has not been opened.
Abort information:
Line : 15, [14]
Program : 16.0 TESTER,BP DUMP.SUB2
Compiled on : 22 Sep 14 at 14:43
Source : TESTER,BP DUMP.SUB2
Last updated : 22 Sep 14
Run Emulation : Reality v15.1
Compiler version: DataBasic 15.1 Version 10.3
Variables:
ARRAY(1,1)= <unassigned>
ARRAY(1,2)= <unassigned>
ARRAY(1,3)= <unassigned>
ARRAY(1,4)= <unassigned>
B = <unassigned>
A = 0
ITEM = <unassigned>
FRED = <unassigned>
If an error has occurred only once, the Duplicates = line is not displayed.
DEBUG dump item
Type = Debugger DUMP command
Timestamp = 24 Sep 2014 10:36:05.2
Port = 407
Account = 16.0
User = TESTER
Program Name = DUMP.SUB2
Line# = 15, [14]
Stack = Gosub DUMP.SUB2 8, [7]
Call DUMP.SUB1 16, [15]
Gosub DUMP.SUB1 8, [7]
Call DUMP.TST 15, [14]
Gosub DUMP.TST 7, [6]
Message = Test 'DUMP' message.
Variables:
ARRAY(1,1)= <unassigned>
ARRAY(1,2)= <unassigned>
ARRAY(1,3)= <unassigned>
ARRAY(1,4)= <unassigned>
B = <unassigned>
A = 0
ITEM = <unassigned>
FRED = <unassigned>