removeVolume

Deletes either an NSS logical volume or a traditional NetWare volume. When a traditional NetWare volume is deleted, it is immediately deleted from the system. However, when an NSS logical volume is deleted, it remains in the NSS storage pool in a salvageable state until it is either manually purged or until its scheduled auto purge time expires.

Request

<removeVolume>
   <volumeName/>
   <dontRemoveNDSObject/>
   <updateVLDB/>
</removeVolume>

Reply

<removeVolume>
   <result value=" ">
      <description/>
   </result>
</removeVolume>

Elements

volumeName: Specifies the name of the volume to remove.
dontRemoveNDSObject: Specifies that the volume's eDirectory object should not be removed. If this element is not specified, the eDirectory name is removed.
updateVLDB: Specifies that the DFS Volume Location Database (VLDB) is updated by the XML processing code. This element is for backward-compatibility with ConsoleOne, which does not know about this element but does its own VLDB updating. All new code should include this element.
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

A nssRequest packet to remove a volume is as follows:

<nssRequest>
   <volume>
      <removeVolume>
         <volumeName>NSS1</volumeName>
      </removeVolume>
   </volume>
</nssRequest>

A nssReply packet to the remove volume command follows:

<nssReply>
   <volume>
      <removeVolume>
         <result value="0">
            <description/>success</description>
         </result>
      </removeVolume>
   </volume>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>