modifyDevice

Modifies the "shared" state of the device. The shared state is a manually set flag that should be set by the user on all devices that participate as shared devices in a cluster. The software has no mechanism for automatically detecting which devices the user desires to have participate in a cluster. Once a device is flagged as "shared," other XML commands allow partitions, NSS storage pools, and NSS logical volumes to be created only if the proper clustering software is installed and running.

Request

<modifyDevice>
   <deviceID/>
   <shared state=" "/>
</modifyDevice>

Reply

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

Elements

deviceID: On NetWare, specifies the device ID received from Media Manager. On Linux, specifies the device object name.
shared: Specifies if the device should be marked as shareable for clustering.
description: Specifies a text description of the returned result.

Attributes

state: Specifies a lowercase yes or no.
value: Specifies an error value or 0 (for no error).

Example

A nssRequest packet to set the "shared" state on a device is as follows:

<nssRequest>
   <device>
      <modifyDevice>
         <deviceID>3</deviceID>
         <shared state="yes">
      </modifyDevice>
   </device>
</nssRequest>

A nssReply packet to the modify device command follows:

<nssReply>
   <device>
      <modifyDevice>
         <result value="0">
            <description/>success</description>
         <result>
      </modifyDevice>
   </device>

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