SPI Common Extensions Manual

Commands and Responses
SPI Common Extensions Manual—427508-001
5-28
DELETE
DELETE
ZCOM-CMD-DELETE (sensitive)
The DELETE command removes an object from the subsystem set of defined objects.
Configured objects must be deleted using this command. Nonconfigured objects can
be deleted although this normally happens when they are stopped or aborted.
The CMD-POWER modifier is required to delete an object that is not reporting the
STOPPED summary state.
ZCOM-TKN-CMD-POWER
is a command modifier that affects how forcefully a command acts on an object.
The possible values are:
DELETE Command Tokens
ZSPI-TKN-MANAGER token-type ZSPI-TYP-FNAME32
or
ZCOM-TKN-XMGR token-type ZSPI-TYP-STRING
ZCOM-MAP-REQID
or
ZCOM-TKN-REQID-desc
ZCOM-TKN-OBJNAME token-type ZSPI-TYP-STRING
ZCOM-TKN-SUB token-type ZSPI-TYP-ENUM
ZCOM-TKN-SEL-SUMSTATE token-type ZSPI-TYP-INT-PAIR
ZCOM-TKN-CMD-TIMEOUT token-type ZSPI-TYP-TIMESTAMP
ZCOM-TKN-CMD-POWER token-type ZSPI-TYP-ENUM
ZSPI-TKN-RESPONSE-TYPE token-type ZSPI-TYP-ENUM
ZSPI-TKN-ALLOW-TYPE token-type ZSPI-TYP-ALLOW-TYPE
ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING
ZSPI-TKN-CONTEXT token-type ZSPI-TYP-BYTESTRING
ZCOM-VAL-CMD-
POWER-NORMAL
requires an object to be in the STOPPED summary state before
being deleted.
ZCOM-VAL-CMD-
POWER-ORDERLY
can be used to delete an object that is not reporting the
STOPPED summary state. It is equivalent to this sequence:
1. ZCOM-CMD-STOP, ZCOM-VAL-CMD-POWER-NORMAL
The object can be stopped only if there are no links to it. If
there are links to it, the DELETE command is rejected. If the
object is already in the STOPPED summary state, no error
message is returned.
2. ZCOM-CMD-DELETE, ZCOM-VAL-CMD-POWER-NORMAL
The object is reporting the STOPPED summary state and
can be deleted.