OSI/MHS Management Programming Manual

SPI Programming Considerations for OSI/MHS
OSI/MHS Management Programming Manual—424824-001
3-4
Object Types
Programmatic commands for the OSI/MHS subsystem are identified by command
numbers with symbolic names of the form ZCOM-CMD-name, where name identifies
the command. (The separator character varies with the language; hyphens are shown
throughout this and other DSM manuals because hyphens are used in DDL.) For
example, the name used by application programs for the ALTER command is
ZCOM-CMD-ALTER. These names represent the values that can be assigned to the
command number header token, ZSPI-TKN-COMMAND.
These commands and the OSI/MHS subsystem’s responses to them are described in
Section 5, Commands and Responses
.
Object Types
The OSI/MHS subsystem supports the following object types:
All commands and responses contain an object-type token in the header. For the
OSI/MHS subsystem, object types are identified in programs by symbolic names of the
form ZCOM-OBJ-name, where name identifies the object type. For example, the
ENTRY object type is represented by the name ZCOM-OBJ-ENTRY. The object-type
header token, ZSPI-TKN-OBJECT-TYPE, always has one of these values.
A response consists of a number of response records, which are groupings of tokens
giving response information about a particular object. In addition to the object-type
header token, some OSI/MHS response records contain an object-type token that
identifies the type of the object described in the response record. The name of this token
is ZCOM-TKN-OBJTYPE, and the symbolic names of its possible values are also of the
form ZCOM-OBJ-name.
Object Names
Many OSI/MHS commands and responses contain object-name tokens that, when
combined with object-type information, designate which objects are to be or were
affected by the command.
In the management programming interface to the OSI/MHS subsystem, the form of an
object name depends on the object type. Extended SPI Definitions
on page 4-4
describes the name formats for objects of each type.
ALTER RESETSTATS SWITCH
DELETE START TRACE
GETVERSION STATISTICS
APPL DLISTMEMBER MTA
CLASS ENTRY PROCESS
CUG GATEWAY ROUTE
CUGMEMBER GROUP SUBSYS
DLIST MON null