EMS Manual

Standard Events
EMS Manual—426909-005
9-26
Object Other State Change Event Tokens
Object Other State Change Event Tokens
An Object Other State Change event must be reported for a subsystem or application
object whenever the object enters a state, other than object available or unavailable,
with these qualities:

Requires operator intervention before its state can change

Persists in the same state long enough for the operator to notice
The subsystem or application (or its manager process) that controls the object must
report this event as soon as the condition is detected. The subsystem or application
must also provide the cause, effect, and recovery text of this event to the operator.
Do not use this event to report:

Operator attention needed for production requests like mounting a tape. Use the
Operator Attention Needed event.

That an object became unavailable or that an object became available. Use the
Object Unavailable and Object Available events, respectively.
The event subject is the object with one of the previous state changes. If multiple
objects have the same state change, these objects can be represented by lists or
group names.
For more information about the use of this event, see Requirements for Standard
Events on page 9-3 and Object State Monitoring Functions on page 9-4.
These event-specific tokens must be provided in addition to the common-standard
tokens. Unconditional token types are identified with a “U.” These tokens are described
in Object Available Event Tokens.
Object Unavailable Event Tokens
An Object Unavailable event is to be generated for a subsystem or application object
whenever:

The object becomes unavailable.

The operator cannot restart the unavailable object.
The subsystem or application (or its manager process) that controls the object must
report this event. Subsystems and applications should not generate events for objects
that are not under their control. This event should be reported as soon as the
unavailability condition of the object is detected. The subsystem or application must
also provide the cause, effect, and recovery text of this event to the operator.
Current State
ZEMS-TKN-STATE-CURRENT (ZSPI-TYP-ENUM,U)
Previous State
ZEMS-TKN-STATE-PREVIOUS (ZSPI-TYP-ENUM,U)
Change Reason
ZEMS-TKN-CHANGE-REASON (ZSPI-TYP-ENUM,U)