SNAX/HLS Management Programming Manual

7 Commands and Responses
104708 Tandem Computers Incorporated 7–1
This section defines the syntax and semantics for all the commands and responses
supported by the SNAX/HLS subsystem. Some tokens occur in multiple commands
or responses. These common tokens are described in Section 6, “Common
Definitions.”
The commands described in this section allow applications to do the following:
Alter the attributes of the SNAX/HLS process
Obtain the values of attributes of the SNAX/HLS process or of a session
Abort sessions
Obtain the status of an object or a group of objects
Obtain statistics for the SNAX/HLS process
Switch the primary and backup processes
Send text to an application
Control tracing
Obtain information about opens
This manual uses data definition language (DDL) to represent all definitions. For
more information on DDL, see the appendix “Overview of DDL for SPI” in the
Distributed Systems Management (DSM) Programming Manual.
SNAX/HLS controls command security. Security is applied only to the ABORT and
SWITCH commands, as discussed in the command descriptions and also in Section 5,
“SPI Programming Considerations for SNAX/HLS.”
Command Buffer Sizes Command buffers whose sizes do not exceed the value ZHLS–VAL–MAXBUFLEN are
accepted by SNAX/HLS. An attempt to send longer buffers might result in the
rejection of the request. Response buffers should be at least ZHLS–VAL–BUFLEN bytes
long, or minimum responses cannot be accommodated.
General Comments 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–PROCESS and ZCOM–TKN–SUB contains ZCOM–VAL–SUB–ONLY, the
process object is the addressed object and the sessions subordinate to the process are
the target objects. In the case of a ZCOM–TKN–SUB value of ZCOM–VAL–SUB–ALL,
the addressed process object is a target object, along with all the session objects
subordinate to that process.