modifyState

Request

<modifyState>
   <volumeName/>
   <volumeState/>
   <mountPoint/>
</modifyState>

Reply

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

Elements

volumeName

Specifies the name of the volume for which to modify the state.

volumeState

Specifies the state to which the volume should be set (see NSS Volume States and Traditional Volume States).

(Optional) mountPoint

Specifies the mount point for the volume (to support the Linux platform).

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 on a volume is as follows:

<nssRequest>
   <volume>
      <modifyState>
         <volumeName>NSS1</volumeName>
         <volumeState>deactive</volumeState>
         <mountPoint>/media/nss/volname</mountPoint>
      </modifyState>
   </volume>
</nssRequest>

A nssReply packet to the modify device command follows:

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

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