SNAX/APC Management Programming Manual

SNAX/APC Object Types and Names
Elements of SPI Messages for SNAX/APC
3–2 111813 Tandem Computers Incorporated
SNAX/APC Object
Types and Names
Command messages contain a standard header token, ZCOM-CMD-command, which
contains a command number value that represents a command name. The commands
applicable for a SNAX/APC subsystem are described in Section 5, “Commands and
Responses.”
Another standard header token in the command message indicates the type of object
upon which the command is to operate. When an application creates a command
buffer, one of the required parameters is the object type (ZCOM-OBJ-object-type).
SCP defines many standard object types, of which SNAX/APC uses the following: the
conversation (CONVERSATION), the local logical unit (LU), the process (PROC), the
remote partner LU (PTNR-LU), the group of potential sessions defined between a local
LU and its remote partner LU (PTNR-MODE), the transaction process name (TPN), the
transaction process instance (TPI), and the session (SESS).
The syntax of the object name varies, depending upon the object type. Object names
are similar to Tandem file names. The object names can use uppercase or lowercase
letters; lowercase object names are changed automatically to uppercase by
SNAX/APC.
When an application uses the SSINIT SPI procedure to create a command buffer, it
specifies the type of object upon which the command will act. (If the command is not
directed at a specific object, the object type is NULL. For example, the GETVERSION
and LISTOBJECTS commands use the NULL object type.)
All object types other than NULL require applications to specify an object name to
indicate a specific object. After specifying the object type, the application must specify
the name of the object, using the token ZCOM-TKN-OBJNAME.
Note that the specified or addressed object in a command may not be equivalent to the
target objects. An addressed object is the object specified in a command; a target
object is an object upon which the command actually operates. The addressed and
target objects are usually the same, except when ZCOM-TKN-SUB is used. For
example, if the INFO command is issued with an addressed object type of
ZCOM-OBJ-PTNR-MODE and ZCOM-TKN-SUB contains the value
ZCOM-VAL-SUB-ONLY, the PTNR-MODE object is the addressed object and all the
potential SESS objects subordinate to the PTNR-MODE are the target objects. In the
case of a ZCOM-TKN-SUB value of ZCOM-VAL-SUB-ALL, the addressed
PTNR-MODE object is a target object, along with the SESS objects subordinate to that
PTNR-MODE object.