Returns the file name corresponding to the indicated NM (code) address.
Syntax |
 |
nmfile (virtaddr [length])
|
Formal Declaration |
|
nmfile:str (virtaddr:ptr [length:u16=$20])
|
Parameters |
|
- virtaddr
The virtual address (of NM code) for which the file name is to be returned.
Virtaddrcan be a short pointer, a long pointer, or a full
logical code pointer.
- length
The maximum length of the file name string to be returned. If the
name does not fully fit into the space specified, it is
truncated and followed by an asterisk (*) to indicate
the truncation.
Examples |
|
$nmdebug > loadinfo
nm PROG GRADES.DEMO.TELESUP SID=$4d5
parm=0 info=""
nm GRP XL.DEMO.TELESUP SID=$4d8
nm USER XL.PUB.SYS SID=$10d
nm SYS NL.PUB.SYS SID=$a
cm SYS SL.PUB.SYS
|
Show the files loaded by the current process.
$nmdebug > wl nmfile( average )
XL.DEMO.TELESUP
$nmdebug > wl nmfile ( FOPEN )
NL.PUB.SYS
$nmdebug > wl nmfile ( P_NEW_HEAP )
XL.PUB.SYS
$nmdebug > wl nmfile( processstudent )
GRADES.DEMO.TELESUP
$nmdebug > wl nmfile( processstudent 7 )
GRADES*
|
The above examples show how the NMFILE function, given various addresses
(all specified as symbolic procedure names), returns the name of the
loaded file that contains each address.
Limitations, Restrictions |
|
Only addresses corresponding to the process's loaded file set
(program file and libraries) succeed.
