modifyState

Request

<modifyState>
   <poolName/>
   <poolState/>
   <ignoreShareState/>
</modifyState>

Reply

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

Elements

poolName

Specifies the name of an existing NSS storage pool for which the state is modified.

poolState

Specifies the desired target state to which the pool should be set:

• active
• deactive

ignoreShareState

(Optional) Specifies that a pool can be activated when the clustering software is not present. Usually, the server checks to validate that the clustering software is loaded and operational before allowing pools to be activated on a device that is marked shareable for clustering. Use this switch in rare circumstances where you can ensure that the pool is not in use on another node and that it is not started or used elsewhere. If a shared pool is accidentally activated on two nodes, the pool becomes corrupted.

result

Specifies an error value or 0 (for no error).

description

Specifies a text description of the result.

Example

A nssRequest packet to modify the state of a pool is as follows:

<nssRequest>
   <pool>
      <modifyState>
         <poolName>MYPOOL</poolName>
         <poolState>deactive</poolState>
      </modifyState>
   </pool>
</nssRequest>

A nssReply packet to the modify device command follows:

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

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