OSI/TS Management Programming Manual

Message Elements for the OSI/TS Subsystem
SPI Programming Considerations for OSI/TS
056786 Tandem Computers Incorporated 3–5
ZCOM-OBJ- name , where name identifies the object type. (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 subdevice object type is
represented by the name ZCOM-OBJ-SU. 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/TS 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 names of its possible values are also of the
form ZCOM-OBJ- name .
The null object type is not a true object type but a placeholder, meaning that no
particular object type is specified. For OSI/TS, the GETVERSION and LISTOBJECTS
commands allow you to specify null (ZCOM-OBJ-NULL) in place of an actual object
type.
Object Names Many OSI/TS 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/TS subsystem, the form of an
object name depends on the object type. The “Object Types and Object Names”
subsection of Section 4 describes the name formats for objects of each type.
Some of the commands accept object-name templates (wild-card names), which
designate a set of objects to be operated on by the command. Valid object-name
templates contain the asterisk (*) or the question mark (?) wild-card characters. The
commands that accept object-name templates are listed below in Table 3-1. Wild cards
operate on the TSP process-name .
Table 3-1. Wild-card Support for OSI/TS Programmatic Commands
Supported Commands
ABORT SU LISTOBJECTS SU
ALLOWOPENS SU LISTOPENS SU
ALTER SU RESETSTATS SERVICE
DELETE SU RESETSTATS SU
FORBIDOPENS SU START SU
INFO ROUTE STATISTICS SERVICE
INFO SERVICE STATISTICS SU
INFO SU STATUS SU
LISTOBJECTS SERVICE STOP SU
How wild cards are supported for each object type is described in Section 4.