SNAX/APC Management Programming Manual

Object Referencing
Elements of SPI Messages for SNAX/APC
3–12 111813 Tandem Computers Incorporated
Object Referencing A requester can use the SEL-SUMSTATE modifier and the SUB modifier to indicate to
which objects a given command is to be applied.
These modifiers can be used simultaneously. It is the responsibility of the requester to
make sure that the objects can be referenced by the command. For example, an
attempt to issue an ALTER PROC command produces errors if the SUB modifier
causes the command to be applied to sessions.
Uppercase and lowercase letters can be used interchangeably when referencing
objects. Note, however, that object names generated by SNAX/APC in responses or
event messages are all uppercase.
The SEL–SUMSTATE Modifier
SNAX/APC supports the use of the ZCOM–TKN–SEL–SUMSTATE modifier in all
commands. This modifier allows the requester to include or exclude the application of
a command to objects, based on the summary states of those objects. Descriptions of
the summary states for SNAX/APC objects are included in the following subsection.
If the ZCOM–TKN–SUB modifier is included in a command with the
ZCOM-TKN-SEL-SUMSTATE modifier, the objects selected are based upon the value
of ZCOM–TKN–SUB and the target object of the command. For example, if a
command is addressed to a set of sessions identified by the object name template and
the command includes the token ZCOM–TKN–SEL–SUMSTATE with the value
ZCOM-VAL-SUMSTATE-STARTED, the command is applied to only those sessions
that are started and whose names match the template.