Distributed Name Service (DNS) Management Programming Manual
ALTER COMP Command
Using DNS in Programs: The DNS Commands
5–50 46958 Tandem Computers Incorporated
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 altered. If ZSPI-TKN-RETCODE is not zero, the name is not altered.
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 which 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 the number of ZDNS-MAP-ALTER-COMP-SSOBJ occurrences supplied exceeds
the number of components defined for the type of composite being altered, the
command is rejected with ZDNS-ERR-WRONG-NUM-COMPONENTS.
If ZDNS-MAP-ALTER-COMP-SSOBJ specifies a subsystem-object type or
subsystem that does not match one of the components for the specified composite
type, the command is rejected with ZDNS-ERR-INV-COMPONENT.
If ZDNS-MAP-ALTER-COMP-SSOBJ names a subsystem object whose subsystem-
object type does not agree with the specified subsystem object or subsystem, the
command is rejected with ZDNS-ERR-WRONG-TYPE.
If two ZDNS-DDL-ALTER-COMP-SSOBJ occurrences specify the same subsystem-
object type, the command is rejected with ZDNS-ERR-DUP-COMPONENT.
The DNSCOM command “ALTER ATM44, COMPONENT TERM TERM44
UNDER \WESTB1.$PM” supplies ZDNS-MAP-ALTER-COMP and ZDNS-MAP-
ALTER-COMP-SSOBJ as follows:
ZDNS-MAP-ALTER-COMP
ZNAME = "ATM44 "
ZDEFNODE =
null
ZDOMAIN =
null
ZDNS-MAP-ALTER-COMP-SSOBJ[1]
ZSSTYPE = "TERM "
ZSS = "PATHWAY "
ZSSOBJ = "TERM44 "
ZSSMGR = "\WESTB1 $PM "