func nmfile [ System Debug Reference Manual ] MPE/iX 5.0 Documentation
System Debug Reference Manual
func nmfile
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.
Virtaddr can 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.
MPE/iX 5.0 Documentation