renameVolume

Renames either a NSS logical volume or a traditional NetWare volume.

Request

<renameVolume>
   <volumeName/>
   <newVolumeName/>
   <newNDSName/>
   <dontRenameNDSObject/>
   <updateVLDB/>
</renameVolume>

Reply

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

Elements

volumeName: Specifies the name that the volume is known by on the server.
newVolumeName: Specifies the new name that the volume is known by.
newNDSName: (Required unless dontRenameNDSObject is specified) Specifies the new name to which the eDirectory volume object is renamed. If NULL is specified, the new name of the eDirectory volume object is generated by prepending the server name and an underscore to the value of the volumeName element.
dontRenameNDSObject: (Optional) Specifies not to rename the eDirectory object. If specified, the newNDSName and context elements are ignored.
updateVLDB: (Optional) 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 the 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 rename a volume is as follows:

<nssRequest>
   <volume>
      <renameVolume>
         <volumeName>MYVOL</volumeName>
         <newVolumeName>NSS1</newVolumeName>
         <newNDSName>
      </renameVolume>
   </volume>
</nssRequest>

A nssReply packet to the rename volume command follows:

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

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