HP 3000 Manuals

MPE Debug/Stack Dump Reference Manual

STACKDUMP 
Intrinsic 

Dumps selected parts of stack to a file.

SYNTAX 

                 BA        I      L     DA      O-V
     STACKDUMP(filename,idnumber,flags,selec);
          or
                   BA      I        L     DA       O-V
     STACKDUMP'(filename,idnumber,flags,selec);

PARAMETERS 

filename         byte array (optional)

                 Contains the file name of the file where the information
                 is to be dumped.  When filename contains the formal
                 designator of the file, the file will be opened and
                 closed by the STACKDUMP intrinsic.  If the secondary
                 entry point (STACKDUMP') is used to enter this
                 intrinsic, MPE assumes that filename(0) contains the
                 file number of a file which has been successfully opened
                 prior to the call to STACKDUMP. In this case, the file
                 is not closed before returning to the user program.
                 When a file number is passed via the STACKDUMP'
                 secondary entry point, the record length must be between
                 32 and 256 words and write access must be allowed to the
                 file.  Default:  Dump is sent to the standard list 
                 device.

idnumber         integer (optional) 

                 An integer which is displayed in the header of the dump
                 to identify the printout.  Default:  Identifying integer 
                 is not displayed.

flags            logical (optional) 

                 A logical value used to specify the following options:
                   Bit 15 = 1 Suppress ASCII dump.
                   Bit 14 = 1 Suppress trace back of stack markers.

                 Default:  Bits 14 and 15 = 00.  A corresponding ASCII 
                 dump is provided for all values dumped in octal, and a 
                 trace back of stack markers is displayed. 

selec            double array (optional) 

                 Specifies which stack areas are to be dumped.  The
                 format of the array is shown in Figure 2-1.  The array
                 has no predetermined length; the first double word
                 containing the values 0/-1 indicates the end of the
                 array.  An entry for which the count is 0 is understood
                 to "skip" (i.e., go to next double word element in
                 list).

                 Default:         If missing, or if the first double word 
                                  contains 0/-1(indicating end of array),
                                  then no dump (except for the header) 
                                  occurs, unless flags bit 14 = 0, in 
                                  which case the trace back of stack 
                                  markers is displayed.

CONDITION CODES 

CCE              Request granted.

CCG              Request denied.  Bounds violation occurred and the dump
                 was not completed.  Record size was not between 32 and
                 256 words.

CCL              Request denied.  File system error occurred from
                 opening, writing, or closing of the file.  The file
                 error number is returned to idnumber.  See the MPE 
                 Intrinsics Reference Manual for a discussion of file
                 errors.


          Figure 2-1.  Stack Dump Modes and selec Array Format 

MPE/iX 5.0 Documentation