TCP/IP Management Programming Manual

Elements of SPI Messages

HP NonStop TCP/IP Management Programming Manual—529636-001

3-5

Object Types

Object-type numbers represent the object type (or class) of an object. The value of an

object-type number is subsystem-specific and has a symbolic name. The symbolic

name is of the form ZCOM-OBJ-type, where type identifies the object type. For

example, ZCOM-OBJ-SUBNET identifies the subnet object type in all data

communications subsystems, including the TCP/IP subsystem.

Note that object-type numbers are part of the header of each command and response.

The header token ZSPI-TKN-OBJECT-TYPE contains the object-type number.

However, if there are multiple objects in a response or an object is returned within a

data list, the object-type number is contained in the ZCOM-TKN-OBJTYPE token. The

symbolic name of the value is also of the form ZCOM-OBJ-type, where type

identifies the object type.

The TCP/IP subsystem supports these object types:

•

NULL

•

PROC

•

ROUTE

•

SUBNET

The objects defined by the TCP/IP subsystem are organized in a hierarchy by object

type. The SUBNET and ROUTE object types are peer object types, subordinate to the

PROC object type. The NULL object type is not within the hierarchy and applies to only

two commands: GETVERSION and LISTOBJECTS. The hierarchy is important when

issuing commands to the TCP/IP subsystem for processing. For example, because the

SUBNET and ROUTE object types are subordinate to the PROC object type, any

commands pertaining to a SUBNET or ROUTE object can be issued only when the

PROC object is in the STARTED summary state.

Object Names

An object name identifies a specific object. The object specified by an object name for

the TCP/IP subsystem must be one of three object types, PROC, SUBNET, or ROUTE.

The NULL object type does not have an object name associated with it.

As with any NonStop subsystem, the TCP/IP subsystem must have a NonStop OS

process name. When you assign an object name to a process, you must assign a

unique name. The name must be preceded by a dollar sign ($) and can have a

maximum of four alphanumeric characters, not including the dollar sign. The first

character following the dollar sign must always be a letter. The recommended form is

$ZTCx, where x is an alphanumeric character. An example of a valid object name for a