HPlogo System Debug Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 4 System Debug Command Specifications

PIN

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 the process state as last stored in its task control block (TCB). The NM symbol names for the process will not be known.

WARNING! In Debug, switching to another PIN does not cause that process to suspend execution. As a result, subsequent use of certain other Debug commands, such as TRACE, may not work properly, and may even cause the system to crash. In order to prevent the possibility of a system failure, the PIN should first be suspended, as with the Break key or the :BREAKJOB command, before using the PIN command in debug.
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.
Feedback to webmaster