OSI/AS Management Programming Manual

Message Elements for the OSI/AS Subsystem
SPI Programming Considerations for OSI/AS
056785 Tandem Computers Incorporated 3–5
PROCESS
PROFILE
SERVICE
SU
SUBSYS
All commands and responses contain an object-type token in the header. For the
OSI/AS 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/AS 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/AS 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/AS 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.
Table 3-1. Wild-Card Support for OSI/AS Programmatic Commands (Page 1 of 2)
For This Wild-Card Character...
This Command... Supports Wild-Cards for This Object-Type... ? *
ABORT PROCESS TSP indirect-process-name or
TAPS indirect-process-name
XX
ABORT SU TAPS su-name XX
ACTIVATE PROCESS TSP indirect-process-name or
TAPS indirect-process-name
XX
ALLOWOPENS PROCESS TAPS indirect-process-name XX
DELETE ENTRY OSI manager entry-name XX
DELETE PROCESS NSP indirect-process-name ,
TSP indirect-process-name , or
TAPS indirect-process-name
XX
DELETE PROFILE OSI manager profile-name XX
FORBIDOPENS PROCESS TAPS indirect-process-name XX