|
|
Returns the full NM code path name corresponding to the indicated address.
nmpath (virtaddr [length])
The string returned by NMPATH is one of the following two formats:
Detailed descriptions of each of the above return strings follow:
- file_name
The name of the file containing the procedure.
- module_name
The name of the module containing the procedure.
- parent_procname
The name of the level one procedure containing the nested
procedure at the specified address.
- procname
The name of the procedure.
nmpath:str (virtaddr:ptr [length:u16=$50])
- 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.
$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.
None
|