SPI Common Extensions Manual

Extended SPI Concepts

SPI Common Extensions Manual—427508-001

2-10

Summary States

A summary state is a single value with which an object reports its condition or state.

Objects report summary states in response to the STATUS command. Further,

commands can be applied to objects selectively based on the summary states of the

objects.

Also, a special summary state is defined for use in AGGREGATE command

responses. This summary state, ZCOM-VAL-SUMSTATE-TOTAL, is assigned to the

ZOBJSTATE field of the ZCOM-MAP-AGGR-STATE-CNT structure to indicate that the

associated object count is a total of all objects regardless of summary state (see

AGGREGATE on page 5-16).

Table 2-2. Summary States That Objects Can Report

Summary State

ZCOM-VAL-SUMSTATE-… General Condition Reported

ABORTING The object is responding to an ABORT command or some

type of malfunction.

DEFINED The object exists, but none of the preceding summary states

have any meaning for it.

DIAGNOSING The object is in a subsystem-defined test mode.

SERVICING There are two substates:

•

SPECIAL—The object is being serviced or used by a

privileged process and is inaccessible to user processes.

•

TEST—The object is reserved for exclusive testing.

STARTED The object is operational. Links to or from the object can be or

have been established, and no restrictions govern information

flow to the object.

STARTING The object is in the process of starting.

STOPPED The object is configured but not operational. There are no

links to or from the object, and no new links can be

established. (A nonconfigured object cannot report this state

because the process of stopping it causes it to be deleted.)

STOPPING The object is in transition to the STOPPED state. No new

links to or from the object are allowed. Existing links are in the

process of being deleted.

SUSPENDED Information flow to and from the object is restricted in some

sense. Typically, it is prevented. The object completes any

outstanding work defined by the subsystem.

SUSPENDING The object is in transition to the SUSPENDED state.

UNKNOWN The object’s state cannot be determined because the object is

inaccessible.