EMS Manual

Standard Events
EMS Manual—426909-005
9-20
Common-Standard Tokens That Subsystems
Provide
Common-Standard Tokens That Subsystems Provide
These tokens are defined by HP but provided by subsystems and applications when
they create the event message. These tokens are required in all event messages.
Unconditional token types are identified with a “U;” conditional token types are
identified with a “C.”
Subsys ID
(SSID)
ZSPI-TKN-SSID (type structure,U)
A structured token with these fields:
Z-OWNER subsys owner (8-character string)
Z-NUMBER subsys number (16-bit signed integer)
Z-VERSION subsys version ID (16-bit unsigned integer)
SSID identifies the subsystem or application that defines, owns and reports
the event. It must be unique within a NonStop Kernel network.
The value of SSID should be subsys-VAL-SSID, where subsys is the 4-letter
acronym assigned to the subsystem or application by the company that owns
the subsystem. For HP, it always begins with “Z” followed by the 3-character
abbreviated subsystem ID. For customers and third-parties, it can be anything
but must not begin with “Z.” For example, ZPWY-VAL-SSID is the SSID
definition for the HP Pathway subsystem.
The field Z-OWNER, known as subsystem owner, identifies the name of the
company or organization that provides the subsystem or application. For
subsystems and applications written by HP, this field must be “TANDEM.” For
subsystems and applications written by third parties and customers, this field
must be registered with HP to guarantee that it is unique throughout a network
of NonStop systems. For registration instructions, see Section 10, Generating
Standard Events.
The field Z-NUMBER, known as subsystem number, identifies the subsystem
or application within the set of subsystems and applications provided by the
owner of the subsystem.
The field Z-VERSION, known as subsystem version ID, identifies the software
release version update of the subsystem. The value of this field should
increase from one release to the next. For subsystems and applications
provided by HP, this value should match the three-character release ID (one
character and two digits) in the product RVU of the subsystem. For example, if
the product RVU for an subsystems for the NonStop server (EMS in this case)
is T9632C21^11APR90^..., C21 must also be the value of this field. The left
byte is the ASCII character C, and the right byte is the unsigned integer value
of 21.