pfm_error_trap()

PFM_$ERROR_TRAP                   Domain/OS                    PFM_$ERROR_TRAP


NAME
     pfm_$error_trap - simulate a fault and save a traceback

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pfm.h>

     void pfm_$error_trap(status_$t &fault_signal)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pfm.ins.pas';

     procedure pfm_$error_trap(in fault_signal: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pfm.ins.ftn'

           integer*4 fault_signal

           call pfm_$error_trap(fault_signal)

DESCRIPTION
     Pfm_$error_trap signals the fault specified by fault_signal to the cal-
     ling process, and saves a traceback of the calling sequence.  It is espe-
     cially useful when debugging a program, or in writing debuggers and moni-
     toring utilities.

     fault_signal
          A fault code.

NOTES
     Pfm_$error_trap does not return when successful.

SEE ALSO
     fault_$intro, pfm_$signal.
Museum
