HP 3000 Manuals

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


System Debug Reference Manual

PIN 

Privileged Mode 

Switches the process-specific pointers and registers to allow the
examination of process related information.

Syntax 

      PIN [pin] [ANYSTATE]

Parameters 

 pin             The process identification number (PIN). If omitted, the
                 current process that was active at dump time is used.
                 If no process was active at dump time, a PIN of zero is
                 used (A PIN of 0 refers to the dispatcher).

ANYSTATE         If the keyword ANYSTATE is specified, the current state
                 of the process for pin is not verified before the
                 process switch occurs.  If this keyword is absent, the
                 current state of the process for pin must be "alive" for
                 the command to succeed.

Examples 

     $nmdat > pin 8 

Switches the process pointers and the registers to PIN 8.

Limitations, Restrictions 

The current implementation of this command for Debug is to take a
snapshot of the task control block (TCB) for the indicated process to
ascertain its state.  Be warned that Debug does not impede the process in
any way.  The process could execute at any time or even terminate.

When Debug switches to a PIN other than the user's PIN, the NM symbol
names for that process are unknown.


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