Argument

 

parmeter_block

   OpenVMS usage:TBK_API_PARAM
   type:         structure
   access:       modify
   mechanism:    by reference

   The values for TBK_API_PARAM (defined in TBKDEF) are defined as:

   Field              Size      Description

   TBK$W_LENGTH       Word      Input by value, structure length,
                                must be TBK$K_LENGTH
   TBK$B_TYPE         Byte      Input, MBZ
   TBK$B_VERSION      Byte      Input by value, must be TBK$K_
                                VERSION
   TBK$L_RESERVEDA    Longword  Reserved for future use, MBZ
   TBK$Q_FAULTING_PC  Quadword  Input by value, call stack frame PC
   TBK$PQ_FILENAME_   64-bit    Optional output by reference
   DESC               pointer   (Integrity servers only), pointer
                                (if not requested, MBZ) to a fixed-
                                length string text descriptor.
                                The descriptor must be set up
                                with preallocated adequate buffer
                                space. The descriptor is filled
                                with the image file name. This can
                                be a dynamic descriptor (rather
                                than fixed-length), but only if the
                                caller is in user mode.
   TBK$PQ_            64-bit    Optional output, pointer (if
   LIBRARY_MODULE_    pointer   not requested, MBZ) to a fixed-
   DESC                         length string text descriptor. The
                                descriptor must be set up with pre-
                                allocated adequate buffer space.
                                The descriptor is filled in with
                                library module name if the image
                                filename (see previous field) is
                                a text library file. This can be
                                a dynamic descriptor (rather than
                                fixed length) but only if the caller
                                is in user mode.
   TBK$PQ_            64-bit    Optional output, pointer (if not
   RECORD_NUMBER      pointer   requested, MBZ) to a longword to be
                                filled with the relevant image file
                                record number.
   TBK$PQ_IMAGE_DESC  64-bit    Optional output, pointer (if
                      pointer   not requested, MBZ) to a fixed-
                                length string text descriptor.
                                The descriptor must be set up with
                                preallocated adequate buffer space.
                                The descriptor is filled in with the
                                image name. This can be a dynamic
                                descriptor (rather than fixed
                                length), but only if the caller
                                is in user mode.
   TBK$PQ_MODULE_     64-bit    Optional output, pointer (if
   DESC               pointer   not requested, MBZ) to a fixed-
                                length string text descriptor.
                                The descriptor must be set up with
                                preallocated adequate buffer space.
                                The descriptor is filled in with the
                                module name.
   TBK$PQ_ROUTINE_    64-bit    Optional output, pointer (if
   DESC               pointer   not requested, MBZ) to a fixed-
                                length string text descriptor.
                                The descriptor must be set up with
                                preallocated adequate buffer space.
                                The descriptor is filled in with the
                                routine name.
   TBK$PQ_            64-bit    Optional output, pointer (if not
   LISTING_LINENO     pointer   requested, MBZ) to longword to be
                                filled in with the line number (as
                                show in the modules LIS file).
   TBK$PQ_REL_PC      64-bit    Optional output, pointer (if not
                      pointer   requested, MBZ) to quadword to be
                                filled in with the relative PC. This
                                can be an image or module relative
                                PC.
   TBK$PQ_ MALLOC_    64-bit    Optional input, pointer (if not
   RTN                pointer   supplied, MBZ) address to a user-
                                supplied malloc routine. Must be
                                supplied when called from supervisor
                                or executive mode (kernel mode is
                                not supported).
   TBK$PQ_ FREE_RTN   64-bit    Optional input, pointer (if not
                      pointer   supplied, MBZ) address to a user-
                                supplied free routine. Must be
                                supplied when called from supervisor
                                or executive mode (kernel mode not
                                supported).
   TBK$PQ_            64-bit    Optional input and output,
   SYMBOLIZE_FLAGS    pointer   pointer (if not supplied, MBZ)
                                to TBK_SYMBOLIZE_FLAGS (quadword,
                                see below). Used to control
                                symbolization options and to return
                                additional status.
   TBK$Q_RESERVED0    Quadword  Reserved for future use, MBZ.
   TBK$Q_RESERVED1    Quadword  Reserved for future use, MBZ.
   TBK$Q_RESERVED2    Quadword  Reserved for future use, MBZ.
   TBK$V_             0         Adjusts the PC value used for
   EXCEPTION_IS_                symbolization for target frames
   FAULT                        that suffered a fault exception.
                      All re-   Reserved, Must be initialized to
                      maining   zero.
                      bits