TCP/IP Management Programming Manual

Elements of SPI Messages
HP NonStop TCP/IP Management Programming Manual—529636-001
3-4
Common Syntax Elements for the Subsystem
by HP, do not begin any name you define in your application with uppercase or
lowercase Z.
Common Syntax Elements for the Subsystem
The remainder of this section contains subsystem-specific information about syntax
elements of commands, responses, and event messages. These elements are in token
form and are referred to by their symbolic names. An advantage of using the symbolic
name is that you are not required to know the address or position of the element within
the buffer.
For more complete information about these elements as they relate to data
communications subsystems, see the SPI Common Extensions Manual.
Command Numbers
Command numbers specify a command to the TCP/IP subsystem or a response to a
management application. The management application uses a symbolic name to
express the command number to the TCP/IP subsystem, and the subsystem uses the
symbolic name to identify the corresponding response. The symbolic name is of the
form ZCOM-CMD-name, where name identifies the command. For example,
ZCOM-CMD-ADD identifies the ADD command in all data communications
subsystems, including the TCP/IP subsystem.
The command number specified by the management application is stored in the
header of the command message. The subsystem and management application can
read the command number from the header using the token ZSPI-TKN-COMMAND in
the SSGET SPI procedure.
Management applications should not use the token ZSPI-TKN-COMMAND to place the
command number into the message header, since the command number to be
specified is already known. Instead, to place the command number into the message
header, your management application should use the command's symbolic name,
ZCOM-CMD-name (which is the value of the token ZSPI-TKN-COMMAND), in the
SSPUT SPI procedure.
Although all data communications subsystems must use symbolic names of the form
ZCOM-CMD-name, each subsystem defines which commands it supports. The TCP/IP
subsystem supports these commands:
These commands are described in Section 6, Commands and Responses.
ABORT INFO STATISTICS
ADD LISTOBJECTS STATUS
ALTER LISTOPENS STOP
DELETE RESETSTATS TRACE
GETVERSION START