VMS Help MACRO, /MIGRATION, Compiler Directives, .EXCEPTION ENTRY  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Declares the entry point of an exception service routine to the
    compiler.

    Format

      .EXCEPTION_ENTRY  [,stack_base]

1 - Parameters

 preserve=<>

    Register set that forces the compiler to save and restore across
    the routine call the contents of registers. By default, the
    compiler saves at routine entry and restores at routine exit
    the full 64-bit contents of any register that is modified by a
    routine.

    In the case of an .EXCEPTION_ENTRY routine, exception dispatching
    saves R2 through R7 on the stack (along with the PC and PSL) and
    the values of these registers are restored by the REI instruction
    executed by the routine itself. Other registers, if used, are
    saved in code generated by the compiler, and all other registers
    are saved if the routine issues a CALL or JSB instruction.

 stack_base

    Register into which the stack pointer (SP) value is moved at
    routine entry. At exception entry points, exception dispatching
    pushes onto the stack registers R2 through R7, the PC, and the
    PSL. Note that the Alpha counterpart for the VAX register known
    as the PSL is the processor status (PS) register. The value
    returned to the register specified in the stack_base helps an
    exception service routine locate the values of these registers.

    You can use the macro $INTSTKDEF in SYS$LIBRARY:LIB.MLB to define
    symbols for the area on the stack where R2-R7, the PC, and the
    PSL are stored. The symbols are:

    o  INTSTK$Q_R2

    o  INTSTK$Q_R3

    o  INTSTK$Q_R4

    o  INTSTK$Q_R5

    o  INTSTK$Q_R6

    o  INTSTK$Q_R7

    o  INTSTK$Q_PC

    o  INTSTK$Q_PS

    You can then use these symbols in the exception routine, as
    offsets to the stack_base value. By using the appropriate
    symbolic offset with the stack_base value, the exception routine
    can access the saved contents of any of these registers. For
    example, the exception routine could examine the PSL to see what
    access mode was in effect when the exception was taken.

2 - Description

    The .EXCEPTION_ENTRY directive indicates the entry point of an
    exception service routine. At routine entry, R3 must contain the
    address of the procedure descriptor. The routine must exit with
    an REI instruction.

    You should declare with the .EXCEPTION_ENTRY directive all of the
    following interrupt service routines:

    o  Interval clock

    o  Interprocessor interrupt

    o  System/processor correctable error

    o  Power failure

    o  System/processor machine abort

    o  Software interrupt