JBASECOREDUMP

The JBASECOREDUMP function is a diagnostic tool for applications that allows a portion of the application to be dumped to an external file for later analysis.

NOTE: This function is only available in jBASE 4.1 and later.

COMMAND SYNTAX

JBASECOREDUMP(expression1, expression2)

SYNTAX ELEMENTS

For jBASE 4.1 upwards only, the program variables and CALL/GOSUB stack will be dumped. The output is in free style text format. The function is called such:

PRINT " fatal application error, outputting a core dump"

filename = "GLOBUSDUMP_":TIME():"_":DATE():"_":SYSTEM(18)

PRINT "Please send the file ":filename:" to your Temenos support"

dummy = JBASECOREDUMP(filename , 0 )

EXIT(99)

The first parameter shows the name of the operating system file to output the core dump to. You can supply "" instead of a file name and jBASE allocates a filename of:

/JBASECOREDUMP_nnnn_mmmmm

where nnn is the port number and mmmmmm is the process id. The second parameter is not used at present. Future versions will allow extra information to be selectively dumped.

A null string is always returned from the function.

EXAMPLE

jBASE Core dump created at Thu Apr 10 17:12:01 2003

Program test31 , port 0 , process id 21959

CALL/GOSUB stack

Line 0 , Source jmainfunction.b , Level 0

Source changed to ./test31.b

0007 GOSUB 100

202

0012 GOSUB 200

0016 CALL SUB1

Source changed to ./SUB1.b

0004 GOSUB 100

0009 GOSUB 200

All the defined VAR's in the program

COMMON variables

0x8057dd0 : greg1[1,-1] : (V) String :

13 bytes at address 0x8057f60 : This is greg1

0x8057e30 : greg2[1,-1] : (V) String :

13 bytes at address 0x8057fc0 : This is greg2

STANDARD Variables in SUBROUTINE main()

0xbfffed54 : Var1[1,-1] : (V) String :

12 bytes at address 0x8057f00 : This is CAR1

STANDARD Variables in SUBROUTINE SUB1

0xbfffe39c : I : (V) Integer :

0xbfffe3b8 : VM : (V) Uninitialised :

(UNASSIGNED)

0xbfffe3d4 : x1[1,-1] : (V) String :

56 bytes at address 0x8059a60 :

2\3742\3749\374SUB1.b\3752\3741\3744\374SUB1.b\3751\3742\37412\374tes

t31.b\3751\3741\3747\374test31.b

0xbfffe3f0 : rc[1,-1] : (V) String :

0 bytes at address 0x40422b04 :

0xbfffe40c : GGC2 : (V) Integer :

0xbfffe428 : GGC3[1,-1] : (V) String :

56 bytes at address 0x8059e68 :

2\3742\3749\374SUB1.b\3752\3741\3744\374SUB1.b\3751\3742\37412\374tes

t31.b\3751\3741\3747\374test31.b

203

0xbfffe444 : DSCB : (V) File descriptor :

File './fb3'

0xbfffe460 : rec : (V) Uninitialised :

(UNASSIGNED)

0xbfffe47c : USERSTATS : (V) Uninitialised :

(UNASSIGNED)

jBC