HPlogo System Debug Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 8 System Debug Standard Functions

func nmproc

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Returns the NM procedure name and offset corresponding to the specified virtual address.

Syntax

    nmproc (virtaddr [length])  

The string returned by NMPROC is one of the following two formats:

  • parent_procname.procedure_name+base offset

  • or

  • procedure_name+base offset

Detailed descriptions of each of the above return strings follow:

parent_procname

The name of the level one procedure containing the nested procedure at the specified address.

procedure_name

The name of the procedure. If the name is longer than length characters, it is truncated with an asterisk (*).

base

The output base used to represent offset.

   $    Hexadecimal

   %    Octal

   #    Decimal

offset

If the offset is nonzero, then it is returned, appended to the procedure name. The offset is formatted based on the current fill, justification, and output base values.

Formal Declaration

   nmproc:str (virtaddr:ptr [length:u16=$40]) 

Parameters

virtaddr

The address for which the symbolic procedure name/offset 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 procedure name and offset string to be returned. If the name does not fully fit into the space specified, the procedure name is truncated and is followed by an asterisk (*) to indicate the truncation.

Examples

   $nmdebug > wl FOPEN

   SYS $a.3f8140



   $nmdebug > wl nmproc( a.3f8140 )

   OPEN



   $nmdebug > wl FOPEN+40

   SYS $a.3f8180



   $nmdebug > wl nmproc( a.3f8180 )

   FOPEN+$40



   $nmdebug > wl nmproc( pc )

   PROGRAM+4c

Limitations, Restrictions

none

Feedback to webmaster