HP 3000 Manuals

TERM [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

TERM 

Debug only 

Controls the synchronization of several debug processes on a single
terminal.

Syntax 

      TERM
      TERM LIST
      TERM NEXT

Terminal locking allows multiple processes to use a single terminal for
debugging without confusion.

TERM LIST shows information about processes waiting for the terminal
semaphore.

TERM NEXT grants the terminal to the process at the head of the waiting
list.

Exiting, continuing, and stepping from the debugger perform an implicit
TERM NEXT command.

Parameters 

TERM             Lists information about processes waiting to enter the
TERM LIST        debugger for the current session.
TERM NEXT        If we own the terminal semaphore, release it and allow
                 the next process waiting for it to enter the debugger.
                 Our process is then queued at the end of the list for
                 the semaphore.

Related environment variables:  TERM_LOCKING.

Examples 

     $(3b) nmdebug > = 2 + 2 
     $4

     PIN 4c is waiting to enter Debug

     $(3b) nmdebug > term list 
     Current term owner: 3b  Next pin: 1a  # Waiting pins: 2

A processes has just notified us that it is waiting to enter Debug.  We
then list information about the waiting PINS. We see that there are two
PINs waiting and the first PIN in the queue is 1a.

     $(3b) nmdebug > term next 

     PIN 3b is waiting to enter Debug

     $(1a) nmdebug > term list 
     Current term owner: 1a  Next pin: 4c  # Waiting pins: 2

We gave away the semaphore and let the next PIN into Debug (PIN 1a).
This placed us (PIN 3b) at the end of the queue.  We next listed
information about the waiting PINs and see that PIN 4c has moved to the
front of the queue.

Limitations, Restrictions 

Due to the implementation of semaphores, Debug cannot list all of the
PINs in the queue, just the first one and a count.


CAUTION The output format of all System Debug commands is subject to change without notice. Programs that are developed to postprocess System Debug output should not depend on the exact format (spacing, alignment, number of lines, uppercase or lowercase, or spelling) of any System Debug command output.


MPE/iX 5.0 Documentation