The TBK$I64_SYMBOLIZE routine attempts to symbolize a PC,
returning as much symbolic representation for that location as
was requested.
Format
TBK$I64_SYMBOLIZE parameter_block
1 – Returns
OpenVMS usage:cond_value
type: longword (unsigned)
access: write only
mechanism: by value
Longword condition value. Most utility routines return a
condition value. Condition values that this routine can return
are listed under Condition Values Returned.
2 – 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