removePool

Deletes an NSS storage pool on the server. Unless instructed not to, removePool also deletes the eDirectory object for the pool. Deleting an NSS storage pool implicitly deletes all NSS logical volumes on the pool. However, is does not delete the eDirectory objects for all of those NSS logical volumes. If you want the volume's eDirectory objects to be properly cleaned up, first delete all of the logical volumes that are contained on the pool before deleting the pool itself. This command is implemented only on NetWare and not on Linux.

Request

<removePool>
   <poolName/>
   <dontRemoveNDSObject/>
   <ignoreShareState/>
</removePool>

Reply

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

Elements

poolName

Specifies the name of the pool to delete.

dontRemoveNDSObject

Specifies not to delete the eDirectory object for the pool.

ignoreShareState

(Optional) Specifies not to check and see if the device is marked shareable for clustering. Usually, the server checks to validate that the clustering software is loaded and operational before allowing pools to be deleted on a device that is marked shareable.

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 pool is as follows:

<nssRequest>
   <pool>
      <removePool>
         <poolName>MYPOOL</poolName>
      </removePool>
   </pool><
 </nssRequest>

A nssReply packet to the remove pool command follows:

<nssReply>
   <pool>
      <removePool>
         <result value="0">
            <description/>success</description>
         </result>
      </removePool>
   </pool>
   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>