*DUMPCRSTACK (GETMODE)

9.0F

*DUMPCRSTACK={string}

The *DUMPCRSTACK control retrieves the current call stack entries. {string} is a previously defined Character String Variable that obtains the stack information.

Note the following:

1. The entries are placed in a single semicolon (;) delimited {string}. Each stack entry is reported as two fields with a comma delimiter. The first field is the instruction pointer (IP) return address and the second field is the PL/B program for that address.

2. The IP value is stored into the return data string with the following format:
   
   'xNNNNN' - NNNNN is a hex value for the IP address.
    

3. If an invalid stack entry is encountered, the invalid address value is reported along with one of the following program name fields:

 

Value	The invalid address is ,,,
!Error0!	equal to zero..
!Error1!	equal to the lowest possible address allocated for the PL/P program.
!Error2!	less than the PL/B program allocated memory space.

 

4. When a WINDOW object is activated as a modal dialog, a stack entry is stored. In this case, the reported address is equal to -2 and the program name is reported as '!Modal!'.

5. If the current stack is empty, the {svar} variable is set to NULL.

6. The EOS flag is TRUE if the {svar} variable is too small and data is truncated.

See Also: List Controls (GETMODE), GETMODE