HP 3000 Manuals

func cmbpindex [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

func cmbpindex 

Returns the CM breakpoint index associated with the indicated CM code
address.

Syntax 

      cmbpindex (cmaddr [pin])

This function accepts the address (either logical or absolute) of an
existing CM breakpoint and returns the logical index number associated
with that breakpoint.  The default action is to look for breakpoints set
by the current PIN. Breakpoint indices for other PINs (including the
global PIN) may be retrieved by utilizing the optional pin parameter.

Formal Declaration 

cmbpindex:u16 (cmaddr:cptr [pin:s16=0])

Parameters 

 cmaddr          Look for this address in the CM breakpoint table.  Both
                 logical and absolute code addresses are supported.

 pin             Look for breakpoints set by this PIN. Default is the
                 caller's PIN (a pin of 0 implies this).  To specify
                 system (global) breakpoints, use a -1 (or 32762) as the
                 PIN.

Examples 

     %cmdebug > bl 
     CM      [1] PROG % 2.3401    TEST'SCREEN+%26
     CM      [2] PROG % 0.347     TEST'FILES+%0
     CM     @[1] SYS  % 161.5274  FOPEN+%0

First, list the existing breakpoints.

     %cmdebug > wl cmbpindex(TEST'FILES) 
     %2

Go find the CM breakpoint index associated with the address TEST'FILES.

     %cmdebug > wl cmbpindex(FOPEN) 
     No breakpoint exists in the breakpoint tables with that address.  (error
     #1080)

     Error evaluating a predefined function.  (error #4240)
       function is"cmbpindex"
         wl cmbpindex(FOPEN)

Now, go find the breakpoint index for the breakpoint at FOPEN. In this
example we get an error.  This is because we did not specify a PIN and
thus searched only for process local breakpoints.  We do not have a
process local breakpoint at FOPEN.

     %cmdebug > wl cmbpindex(FOPEN, -1) 
     %1

Go find the breakpoint index for the breakpoint at FOPEN. This time we
specify a -1 to tell the function to search the list of system
breakpoints.

Limitations, Restrictions 

none



MPE/iX 5.0 Documentation