HPlogo System Debug Reference Manual > Chapter 10 System Debug Standard Functions

func nmfile

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

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.




func nmentry


func nmmod