System Debug Reference Manual (32650-90888)

242 Chapter6
System Debug Command Specifications M-X
PROCLIST
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.
PROCLIST
Lists the specified NM symbols in the specified NM executable library.
Syntax
PROCLIST [ pattern ] [ lstfile ] [ lookup_id ] [ detail ] [ outputfile ]
The values printed by this command are the values found in the symbol table that is
searched. This command does not perform any form of symbol location fixups. The
addresses printed for most data symbols must be relocated relative to DP to be useful.
Parameters
pattern The symbol names(s) that are to be listed. The pattern match is performed
on the symbol
name only. That is:
parent_name.symbol_name For nested procedures.
symbol_name For all other symbols.