System Debug Reference Manual (32650-90888)

Chapter 10 423
System Debug Standard Functions
func nmpath
Formal Declaration
nmpath:str ( virtaddr :ptr [ length :u16=$50])
Parameters
virtaddr The address for which the symbolic procedure path name 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 path name string to be returned. If the path
name does not fully fit into the space specified, it is truncated and
terminated with an asterisk (*) to indicate the truncation.
Examples
$nmdebug > wl nmpath( processstudent )
GRADES.DEMO.TELESUP/processstudent
$nmdebug > wl nmpath( processstudent+30 )
GRADES.DEMO.TELESUP/processstudent+$30
$nmdebug > wl nmpath( processstudent+30, #30 )
GRADES.DEMO.TELESUP/processst*
The above examples show how NMPATH is used to print out the full path for the procedure
processstudent. Notice in the last example that a maximum length of 30 characters is
specified, so the full path is truncated and terminated with an asterisk.
$nmdebug > wl nmpath ( average )
XL.DEMO.TELESUP/average
$nmdebug > wl nmpath( P_NEW_HEAP )
XL.PUB.SYS/p_heap:P_NEW_HEAP
$nmdebug > wl nmpath( FOPEN )
NL.PUB.SYS/FOPEN
$nmdebug > wl nmpath (nmaddr( "highscore" "nested") + 40 ) )
GRADES.DEMO.TELESUP/processstudent.highscore+$40
$nmdebug > wl nmpath ( nmentry ( nmaddr( "highscore" "nested") + 40 ) )
GRADES.DEMO.TELESUP/processstudent.highscore
The above examples show how NMPATH is used to print out path names for routines in
various libraries and how it may combined with other functions.
Limitations, Restrictions
none