TR3271 Management Programming Manual

ELEMENTS OF SPI MESSAGES FOR THE SUBSYSTEM
Naming Rules and Guidelines for Applications
NAMING RULES AND GUIDELINES FOR APPLICATIONS
All items in definition files are assigned symbolic names as
well as numbers. Use the symbolic names to prevent transcription
errors and to improve readability. Tandem uses names beginning
with the letter Z for all definitions and all component fields of
structures in its definition files. To avoid present and future
conflicts with names defined by Tandem, do not begin any name you
define in your application with uppercase or lowercase Z.
COMMON SYNTAX ELEMENTS FOR THE SUBSYSTEMS
The remainder of this section contains subsystem-specific infor-
mation about elements of commands, responses, and event messages.
For more complete information about these elements as they relate
to data-communications subsystems, refer to the Communications
Management Programming Manual .
Command Numbers
Command numbers specify a command to the TR3271 subsystem or a
response to a management application. The management application
uses a symbolic name to express the command number to the
TR3271 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 TR3271 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.
Your management application does not normally 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 only needs to use the symbolic name
of the form ZCOM-CMD- name , which is the value of the token ZSPI-
TKN-COMMAND, in the SSPUT SPI procedure.
3-4