Distributed Name Service (DNS) Management Programming Manual

ADD SSMGR Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–29
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the subsystem manager added
by the command. This token is present in every response record. ZDNS-TKN-
OBJNAME is described in Section 4 under the heading “Simple Tokens.”
ZSPI-TKN-RETCODE
is the standard SPI return token described in the Distributed Systems Management
(DSM) Programming Manual. This token is present in every response record. If its
value is zero (ZDNS-ERR-NOERR), this token indicates that the name is
successfully added. If ZSPI-TKN-RETCODE is not zero, the name is not added.
Where a non-zero return code is present, the response buffer may contain one or
more error lists. Even if the return code is zero, the response may still contain
error lists that describe warnings.
ZSPI-TKN-ERRLIST
is a standard SPI error list, as described in the Distributed Systems Management
(DSM) Programming Manual. The list ends with the token ZSPI-TKN-ENDLIST.
Operational Notes
If the requester does not have DNS write authority, the command is rejected with
ZDNS-ERR-SECURITY.
If more than 128 occurrences of ZDNS-MAP-ADD-SSMGR-SS are supplied, the
command is rejected with ZDNS-ERR-ILL-NUM-SUBSYSTEMS.
If two or more ZDNS-MAP-ADD-SSMGR-SS parameters specify the same
subsystem, ZDNS-ERR-DUP-SUBSYSTEM is returned in an error list as a warning.
The DNSCOM command “ADD SSMANAGER \CORP.$PM, SUBSYSTEMS
PATHWAY, DOMAIN ALL-NCNS” passes ZDNS-MAP-ADD-SSMGR and
ZDNS-MAP-ADD-SSMGR-SS as follows:
ZDNS-MAP-ADD-SSMGR
ZNAME = "\CORP $PM "
ZDOMAIN = "ALL-NCNS "
ZDNS-MAP-ADD-SSMGR-SS[1]
ZSS = "PATHWAY "