HP 3000 Manuals

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