getDeviceInfo2

Returns information about the passed in object ID, which can be a physical device or a RAID device (RAID 0, RAID 1, RAID 5).

Request

<getDeviceInfo2> 
   <objectID/> 
</getDeviceInfo2>

Reply

<getDeviceInfo2>  
   <name/>        
   <objectID/>    
   <type/>       
   <size/>        
   <freeSize/>  
   <majorVersion/>
   <minorVersion/> 
   <partitions>
      <partition>
        <partitionID/>
         <partitionType/>
         <mountPoint/>
         <hasSYS/>
         <bootable/>
      </partition>
   </partitions>
   <hasDOS/>
   <multiPath/>
   <shared/>
   <removable/>
   <deviceRAID>
      <raidType/>
      <elementSize/>
      <elementCount/>
      <stripeSize/>
      <restripeFlag/>
      <restripeEnabled/>
      <segmentInfo>
         <numSegments/>
         <segment>
            <mirrorPercent/>
            <deviceName/>
            <segmentName/>
            <deviceID/>
            <segmentID/>
         </segment>
      </segmentInfo>
   </deviceRAID>
   <mirrored/>
   <deviceMirror>
      <mirrorGroupStatus/>
      <mirrorGroupPercent/>
      <numMirrors/>
      <remirrorEnabled/>
      <mirrorInfo>
         <segment>
            <mirrorPercent/>
            <deviceName/>
            <segmentName/>
            <deviceID/>
            <segmentID/>
         </segment>
      </mirrorInfo>
   </deviceMirror>
   <result value=” “>
      <description/>
   </result>
</getDeviceInfo2>

Elements

objectID

(Required) On input for NetWare, specifies the device ID received from Media Manager. On output for NetWare, specifies the device ID received from Media Manager. On Linux, specifies the device object name.

name

NetWare only. Specifies the name of the device assigned by Media Manager.

type

(Optional) Specifies the RAID type of the device assigned by Media Manager.

size

Specifies the total size of the object in bytes.

freeSize

Specifies the object's available size in bytes.

majorVersion

Linux only. Specifies the major number of the device.

minorVersion

Linux only. Specifies the minor number of the device.

partition

Repeats for each partition on the device.

partitionID

On NetWare, specifies the partition ID number received from Media Manager. On Linux, specifies the partition object name.

partitionType

(Required) Specifies the type of the partition. The following types are for Linux:

0x00 freespace
0x82 Linux Swap
0x83 general Linux

mountPoint

Linux only. Specifies the partition's mount point.

hasSYS

(Optional) Specifies that the partition contains the SYS pool.

bootable

Linux only. Specifies that the partition contains the boot partition.

hasDOS

NetWare only. Specifies that this is a DOS partition. On Linux, this information can be retrieved from the partition type.

multiPath

(Optional) Specifies that the device has multipath.

shared

(Optional) Specifies that the device is shared.

removable

(Optional) NetWare only. Specifies that the deivce is removable.

raidType

Specifies the RAID type: 0, 1, or 5.

elementSize

Specifies the size in bytes.

elementCount

(Required) If deviceRAID is used, specifies the number of segments that are present. If raidType is 5 and elementCount equals the numSegments, one segment can be deleted.

stripeSize

Specifies the size in bytes.

restripeEnabled

Linux only. Specifies if the restripe is enabled.

numSegments

Specifies the number of segments in the RAID. If raidType is 1 (mirroring) and numSegments is greater than one, segments can be deleted (down to one remaining segment).

segment

Repeats for each segment (partition) that makes up the RAID device.

deviceName

NetWare only. Specifies the device name assigned by Media Manager. If there's a missing segment in a mirror device, no information is returned for deviceName and deviceID.

segmentName

NetWare only. Specifies the partition name assigned by Media Manager.

deviceID

On NetWare, specifies the segment's (or mirror segment's) device ID number received by Media Manager. On Linux, specifies the segment's (or mirror segment's) device name. If there's a missing segment in a mirror device, no information is returned for deviceName and deviceID.

deviceRAID

(Optional) If exists, specifies the device is a RAID device.

mirrored

(Optional) For RAID 1 devices only.

deviceMirror

(Optional) For RAID 1 devices only. If there's a missing segment in a mirror device, the missing segment name is returned as missing_raid1_1.

remirrorEnabled

Linux only. Specifies if re-mirroring is enabled.

mirrorActive

Linux only. Specifies if the mirror segment is active:

1 in synchronization
0 not in synchronization

mirrorStatus

Linux only. Specifies the status of the mirror segment:

1 in synchronization
0 not in synchronization