SNAX/APC Management Programming Manual

5 Commands and Responses
111813 Tandem Computers Incorporated 5–1
This section defines the syntax and semantics for all the commands and responses
supported by the SNAX/APC subsystem. Some tokens occur in multiple commands
or responses. These common tokens are described in Section 4, “Common
Definitions.”
The commands described in this section allow applications to do the following:
Create SNAX/APC objects
Alter the attributes of SNAX/APC objects
Delete SNAX/APC objects
Obtain the values of attributes of SNAX/APC objects
Abort or stop objects
Obtain the status of an object or a group of objects
Obtain statistics for SNAX/APC objects
Control tracing
This manual uses the Data Definition Language (DDL) to represent all definitions. For
more information on DDL, see the appendix “Overview of DDL for SPI” in the SPI
Programming Manual.
Command Buffer Sizes Command buffers whose sizes do not exceed the value ZAPC–VAL–MAXBUFLEN are
accepted by SNAX/APC. An attempt to send longer buffers might result in the
rejection of the request. Response buffers should be at least ZAPC–VAL–BUFLEN
bytes long, or minimum responses cannot be accommodated.
Addressed and
Target Objects
An addressed object is the object specified in a command; a target object is the object
upon which the command actually operates. The addressed and target objects are
usually the same. Note that when ZCOM–TKN–SUB is used in a command, the
addressed and target objects may not be equivalent.
For example, if the INFO command is issued with an addressed object type of
ZCOM-TKN-LU and ZCOM-TKN-SUB contains ZCOM–VAL–SUB–ONLY, the LU
object is the addressed object and the objects subordinate to the LU are the target
objects. In the case of a ZCOM–TKN–SUB value of ZCOM–VAL–SUB–ALL, the
addressed LU object is a target object, along with all the objects subordinate to that
object.