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