Chapter 12 269
Scan tools
sppdsh
Definitions
The following definitions will help user with the operation of sppdsh:
• node id—An identification (ID) that can be either the node IP name or
a node number. To distinguish between one node number and
another, the environmental variable, COMPLEX_NAME, indicates
the complex. No complex can have non-unique node numbers.
• complex name—Identifies a grouping of nodes. The ts_config
utility groups nodes into complexes where each node shares the same
OS and memory space.
• all—A reference to all nodes associated with the only complex on the
diagnostic bus in a single complex configuration.
•
<n<node number> | node id>:<ring>:<path>:<part>:<field>—The
general description of a register or group of registers that are
accessible through scan. Each register is identified by its node, the
scan ring that can access it, the part or device that contains it, the
scan path within the part, and the text-based description of the
register.
• address—A 40-bit value that allows access to the memory, CSR space,
IO space and Core Logic bus space across all possible nodes in a
complex.
• byte_size—The byte_size argument represents the number of bytes to
access at an address. Valid byte_sizes are 1, 2, 4 or 8 but may also be
limited by the type of memory accessed. If the byte_size argument is
not used, the maximum valid size for the argument is used by default.
• value—A representation of the data transferred to a memory address
or scan field.
• parameter—A name that represents configuration data that is
initialized by POST. Parameters may be changed to aid testing or to
deconfigure hardware that is marginal. Table 86 provides a list of
valid parameters.
