func nmproc [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
func nmproc
Returns the NM procedure name and offset corresponding to the specified
virtual address.
Syntax
nmproc (virtaddr [length])
The string returned by NMPROC is one of the following two formats:
parent_procname.procedure_name+base offset
or
procedure_name+base offset
Detailed descriptions of each of the above return strings follow:
parent_procname The name of the level one procedure containing the
nested procedure at the specified address.
procedure_name The name of the procedure. If the name is longer
than length characters, it is truncated with an
asterisk (*).
base The output base used to represent offset.
$ Hexadecimal
% Octal
# Decimal
offset If the offset is nonzero, then it is returned,
appended to the procedure name. The offset is
formatted based on the current fill, justification,
and output base values.
Formal Declaration
nmproc:str (virtaddr:ptr [length:u16=$40])
Parameters
virtaddr The address for which the symbolic procedure name/offset
is to be returned.
Virtaddr can be a short pointer, a long pointer, or a
full logical code pointer.
length The maximum length of the procedure name and offset
string to be returned. If the name does not fully fit
into the space specified, the procedure name is
truncated and is followed by an asterisk (*) to indicate
the truncation.
Examples
$nmdebug > wl FOPEN
SYS $a.3f8140
$nmdebug > wl nmproc( a.3f8140 )
OPEN
$nmdebug > wl FOPEN+40
SYS $a.3f8180
$nmdebug > wl nmproc( a.3f8180 )
FOPEN+$40
$nmdebug > wl nmproc( pc )
PROGRAM+4c
Limitations, Restrictions
none
MPE/iX 5.0 Documentation