Distributed Name Service (DNS) Management Programming Manual

DELETE SSOBJ Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–99
Tokens in Command Buffer
ZDNS-MAP-DEL-SSOBJ
is a required structured token that describes the subsystem object to be deleted. It
has the token number ZDNS-TNM-DEL-SSOBJ and the definition ZDNS-DDL-
DEL-SSOBJ. It contains the following fields:
ZNAME
contains the name of the object to be deleted. Possible errors referring to this
field are:
ZDNS-ERR-INUSE (object is part of a composite)
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-ERR-REQD-FIELD
ZSSMGR
specifies the manager for the object to be deleted. (Leave the field null if the
object doesn’t have a manager.) A possible error referring to this field is:
ZDNS-ERR-INV-NAME
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the subsystem object that is
deleted 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 deleted. If ZSPI-TKN-RETCODE is not zero, the name is not deleted.
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.