OSI/AS Management Programming Manual

Data Communications Standard Definitions
Common Definitions
4–6 056785 Tandem Computers Incorporated
Object Types and Object
Names
This section describes the syntax rules for object-specs . An object-spec is a
combination of an object-type and an object-name . The syntax for each
programmatic command contains the variable object-spec .
ZCOM-TKN-OBJNAME
identifies, by name, an object or a wild card representing a set of objects on which
the command is to be performed. For all OSI/AS commands except
LISTOBJECTS, it is the name of a single object; LISTOBJECTS accepts either a
single object name or an object-name template (wild card name) that specifies a set
of objects. This token is required in all OSI/AS commands except GETVERSION
and LISTOBJECTS. Most OSI/AS commands allow multiple occurrences of this
token, so that a single command can operate on several objects.
All object names are stored in an SPI buffer as values of type ZSPI-TYP-STRING.
In responses, one ZCOM-TKN-OBJNAME token is returned for each object about
which the command is to return information.
ZCOM-TKN-OBJTYPE
is a token returned in responses to identify the object type of one or more ZCOM-
TKN-OBJNAME tokens.
The following paragraphs describe the OSI/AS object types—that is, the values that
can be assigned to the ZSPI-TKN-OBJECT-TYPE and ZCOM-TKN-OBJTYPE tokens for
OSI/AS—and the form of the object names for each object type.
ZCOM-OBJ-ENTRY
ZCOM-OBJ-ENTRY identifies an entry in the Management Information Base (MIB).
ENTRY objects are of four different types, distinguished by their names. Names of
ENTRY objects have the following form:
$ osi-mgr-name .# entry-type.entry-name
# entry-type
is #APPL, #NSAP, #SNPA, or #TSEL, denoting an application, NSAP, SNPA, or
TSEL ENTRY object.
entry-name
depends on the type of ENTRY object, as follows:
An application (APPL) entry-name is an application name—a string of up to 64
alphanumeric characters that identifies an OSI application in the MIB. Valid
characters in an application entry-name are the alphanumeric, dash (-), underscore
(_), and circumflex (^) characters. The case of alphabetic characters in an APPL
entry-name is not significant; the OSI manager process upshifts all characters in the
names.