<DMConfigurationScript DTDVersion="30">
  .
  <Info . . . >
  .
  <Action . . . >
  .
  <Status . . . >
  .
</DMConfigurationScript>

  <Info>
  .
  <DiskInfo . . . >
  .
  <ASPInfo . . . >
  .
  <ASPNameInfo . . . >
  .
  <TowerInfo . . . >
  .
  <IOPInfo . . . >
  .
</Info>

<DiskInfo Format="All |
                  Compression |
                  Parity |
                  Mirroring |
                  Physical |
                  Logical |
                  Basic">
  <Disk . . . >
  <ASP . . . >
  <Tower . . . >
  .
  <IOP . . . >
  .
  or
  <DiskFilter . . . >
</DiskInfo>

<ASPInfo Format="All">
  <ASP . . . >
  .
  or
  <ASPFilter . . . >
</ASPInfo>

<ASPNameInfo Format="All">
  .
  <ASPName . . . >
  .
</ASPNameInfo>

<TowerInfo Format="All">
  <Tower . . . >
  .
  or
  <TowerFilter . . . >
</TowerInfo>

<IOPInfo Format="All">
  <IOP . . . >
  .
  or
  <IOPFilter . . . >
</IOPInfo>

<CRGInfo Format="All | DeviceDescriptions | Basic">
  .
  <CRG Name="string"/>
  .
  or
  <CRGFilter . . . >
</CRGInfo>

<FindValidDisks ASPNumber="integer" | ASPName="string" RemoteMirrorCopy="Yes | No">
  .
  <ASP Number="integer">
  .
  <Disk Name="string"/>
  .
  </ASP>
  .
</FindValidDisks>

The valid disks are returned and a Rank is provided for each one (See the Rank attribute for Disk). Note that this is an Info request, and as such no changes will be performed on the system. Any proposed configuration change is assumed to be valid. That is, the change should not have already been made, and it should have been checked by using this request.

The ASP in question is provided as the ASPNumber or ASPName attribute for FindValidDisks. If the ASP is an IASP and has not been created yet, we use ASPName, otherwise we use ASPNumber. The subtags provide information about a proposed configuration change.

For example: Let's assume we are creating a new IASP, and want to discover valid disks to add to it. We would issue the following request:

              <FindValidDisks ASPName="DP033">
              </FindValidDisks>

              <FindValidDisks ASPName="DP033">
                <Disk Name="DD004"
                      Rank="106"/>
                <Disk Name="DD005"
                      Rank="202"/>
                <Disk Name="DD006"
                      Rank="357"/>
              </FindValidDisks>

Next, let's say we want to add disks to a previously established ASP given that we will choose to add DD004 and DD005 to ASP DP033. The request would be:

              <FindValidDisks ASPNumber="5">
                <ASP Name="DP033">
                  <Disk Name="DD004"/>
                  <Disk Name="DD005"/>
                </ASP>
              </FindValidDisks>

              <FindValidDisks ASPNumber="5">
                <Disk Name="DD006"
                      Rank="53"/>
              </FindValidDisks>

If the ASP to be created will have a RemoteMirrorRole of MirroredCopy, then the RemoteMirrorCopy attribute should have a value of Yes. If one of the ASPs we've already checked is included in the list, then the RemoteMirrorRole attribute of the ASP tag should have a value of MirroredCopy.

<DiskFilter Value="All |
                   Unconfigured |
                   Protected |
                   Unprotected |
                   StartParityCapable |
                   IncludeParityCapable |
                   Mirrored |
                   Configured |
                   Failed"/>

<ASPFilter Value="All |
                  Protected |
                  Unprotected"/>

<TowerFilter Value="All"/>

<IOPFilter Value="All |
                  ParityCapable |
                  Failed"/>

<CRGFilter Value="All"/>

<Action Handle="string" ActionStatus="Successful|Failed">
  <OpenSession/>
  .
  Actions to Perform
  .
  <CloseSession/>
</Action>

<OpenSession/>

<CloseSession/>

<CancelAction Type="All|
                    Current"/>

<ContinueAction/>

<AddDisk Balance="Yes | No">
  .
  <ASP Number="integer">
  .
  <Disk Name="string"/>
  .
  </ASP>
  .
</AddDisk>

If an IASP has not yet been created, the Name attribute is supplied for the ASP instead of the Number attribute.

When creating a new remote mirrored copy, the ASP Number must be supplied (rather than the ASP Name), and you must also set the RemoteMirrorRole attribute to MirroredCopy. Various remote mirroring attributes must also be included. These are: RemoteMirrorErrorRecoveryPolicy, RemoteMirrorErrorRecoveryTimeout, RemoteMirrorPerformanceMode, and RemoteMirrorRequireEncryption (Remote mirroring is only available where DTDVersion = 20)

<AssignDisk>
  .
  <DiskPair Name1="string" Name2="string"/>
  .
</AssignDisk>

<AutoOverflowRecovery Type="Enable | Disable">
  .
  <ASP Number="integer">
  </ASP>
  .
</AutoOverflowRecovery>

<ChangeMirrorSyncOnIPL IPLWaitsForSync="Yes | No"/>

<ChangeParityOptimization Optimization="Performance |
                                        Capacity |
                                        Balance |
                                        Availability"
                              ParityType="RAID-5 | RAID-6"/>

Availability (DTDVersion = 20)

<ChangeRemoteMirroringAttributes>
  .
  <ASP Number="integer"
       RemoteMirrorErrorRecoveryPolicy="integer"
       RemoteMirrorErrorRecoveryTimeout="integer"
       RemoteMirrorPerformanceMode="integer"
       RemoteMirrorResumePriority="integer"
       RemoteMirrorRequireEncryption="Yes | No"
       RemoteMirrorTrackingSpace="integer"/>
  .
</ChangeRemoteMirroringAttributes>

<ClearDisk>
  .
  <Disk Name="string"/>
  .
</ClearDisk>

<ConfigureLoadSource EnableRemoteMirroring="Yes | No"/>

<ConvertUDFSASP>
  .
  <ASP Number="integer"
       LinkType="Primary | Secondary"
       Primary="integer">
  </ASP>
  .
</ConvertUDFSASP>

<CopyDisk>
  .
  <DiskPair Name1="string" Name2="string"/>
  .
</CopyDisk>

<CorrectParityMismatch>
  .
  <Disk Name="string"/>
  .
</CorrectParityMismatch>

<CreateSystemGroup/>

<DeconfigureRemoteMirroring>
  .
  <ASP Number="integer"/>
  .
</DeconfigureRemoteMirroring>

<DeleteASP>
  .
  <ASP Number="integer">
  </ASP>
  .
</DeleteASP>

<DeleteData>
  .
  <ASP Number="integer">
  </ASP>
  .
</DeleteData>

<DetachMirrorCopy>
  .
  <ASP Number="integer"/>
  .
</DetachMirrorCopy>

<ExcludeParityDisk>
  .
  <Disk Name="string"/>
  .
</ExcludeParityDisk>

<FormatDisk>
  .
  <Disk Name="string"/>
  .
</FormatDisk>

<IncludeParityDisk>
  .
  <Disk Name="string"/>
  .
</IncludeParityDisk>

<MoveDisk>
  .
  <ASP Number="integer">
  .
  <Disk Name="string"/>
  .
  </ASP>
  .
</MoveDisk>

   <MoveDisk>
       <ASP Number="2">
           <Disk Name="DD003"/>
       </ASP>
   </MoveDisk>

<PowerOffDisk>
  .
  <Disk Name="string"/>
  .
</PowerOffDisk>

<PowerOnDisk>
  .
  <Disk Name="string"/>
  .
  or
  <Location TowerName="string" DevicePosition="string"/>
  .
</PowerOnDisk>

<Location TowerName="string" DevicePosition="integer"/>

<ReattachMirrorCopy>
  .
  <ASP Number="integer"/>
  .
</ReattachMirrorCopy>

<RebuildParity>
  .
  <Disk Name="string"/>
  .
</RebuildParity>

<RecoverCompression>
  .
  <Disk Name="string"/>
  .
</RecoverCompression>

<RecoverIASPConfig>
  .
  <ASP Number="integer">
  </ASP>
  .
</RecoverIASPConfig>

<RecoverUnknownLodeStone>
  .
  <ASP Number="integer">
  </ASP>
  .
</RecoverUnknownLodeStone>

<RelinkSecondaryASP PrimaryASPNumber="integer">
  <ASP Number="integer">
  </ASP>
</RelinkSecondaryASP>

<RemoveDisk>
  .
  <Disk Name="string"/>
  .
</RemoveDisk>

<RenameDisk>
  .
  <Disk Name="string" NewName="string"/>
  .
</RenameDisk>

<ReplaceMirroredUnit>
  .
  <DiskPair Name1="string" Name2="string"/>
  .
</ReplaceMirroredUnit>

<ResumeMirroring>
  .
  <Disk Name="string"/>
  .
</ResumeMirroring>

<ResumeRemoteMirroring>
  .
  <ASP Number="integer"/>
  .
</ResumeRemoteMirroring>

<RetrieveDiskLog>
  .
  <Disk Name="string"/>
  .
</RetrieveDiskLog>

<ResyncParity>
  .
  <ParitySet DiskInSetName="string"/>
  .
</ResyncParity>

<ScanDisk>
  .
  <Disk Name="string"/>
  .
</ScanDisk>

<SetThreshold>
  .
  <ASP Number="integer" Threshold="integer">
  </ASP>
  .
</SetThreshold>

<StartCompression>
  .
  <Disk Name="string"/>
  .
</StartCompression>

<StartMirroring>
  .
  <ASP Number="integer">
  </ASP>
  .
</StartMirroring>

<StartParity>
  .
  <Disk Name="string"/>
  .
</StartParity>

<StopCompression>
  .
  <Disk Name="string"/>
  .
</StopCompression>

<StopMirroring>
  .
  <ASP Number="integer">
  </ASP>
  .
</StopMirroring>

<StopParity ParitySet="integer"/>

<StopParity>
  .
  <ParitySet DiskInSetName="string"/>
  .
</StopParity>

NOTE: You should not use the ParitySet attribute for DTDVersions greater than or equal to 10, as the parity set numbers are not guaranteed to stay the same.

<SuspendMirroring>
  .
  <Disk Name="string"/>
  .
</SuspendMirroring>

<SuspendRemoteMirroring Tracking="yes | no">
  .
  <ASP Number="integer"/>
  .
</SuspendRemoteMirroring>

<SwitchTower Type="Private | Switchable">
  .
  <Tower Name="string">
  </Tower>
  .
</SwitchTower>

<ValidateConfiguration Type="Basic | Full">
  .
  .
</ValidateConfiguration>

<Status Handle="string">
  .
  <ActionProfile . . . >
  .
</Status>

<ActionProfile ActionID="integer"
               ActionType="string"
               PercentDone="integer"
               Stage="integer"
               ActionState="Waiting|Running|Failed|Successful|
                              Canceled|Purged|Paused">
  .
  <Message . . . >
  .
</ActionProfile>

<Tower Number="integer">
  .
  <IOP . . . >
  .
  <ASP . . . >
  .
  <Disk . . . >
  .
</Tower>

<IOP Number="integer">
  .
  <Disk . . . >
  .
</IOP>

Availability (DTDVersion = 20)

<ASP Number="integer">
  .
  <Disk . . . >
  .
</ASP>

0 = InSync (Absolutely in Sync)
1 = Usable
2 = Unusable
3 = Not Owned

(DTDVersion = 20)

0 = Wait, then suspend

(DTDVersion = 20)

(DTDVersion = 20)

0 = Synchronous
1 = Asynchronous on target (source waits until operation reaches target)

(DTDVersion = 20)

10 = High
20 = Medium
30 = Low
98 = ASP Not Owned by System

DTDVersion = 20)

0 = Unknown
1 = ASP Not Owned by System
2 = ProductionCopy
3 = MirroredCopy
4 = MirroredCopyDetached

(DTDVersion = 20)

0 = Active
1 = ResumePending
2 = Resuming
4 = Suspended
5 = ASP Not Owned by System

(DTDVersion = 20)

(DTDVersion = 30)

0 = Full
1 = Partial
2 = Both

(DTDVersion = 30)

1001 = Not Geographically Mirrored
1002 = Geographically Mirrored but do not own IAsp
>=0 Percent

(DTDVersion = 30)

0 = Available (Varied On)
1 = Active (Only half varied on)
2 = Pending (Vary on has been issued)
3 = Unavailable (Varied Off)
10 = Overflowed
11 = Owner Unknown (May belong to another system)
12 = Primary Missing (Only for Secondary ASP's. Indicates whether it's Primary exists)
13 = Inconsistent Link (Only for Secondary ASP's. Indicates if the link to the Primary is bad (ConvertUDFS needs to be rerun))

(DTDVersion = 10 & 20)

1001 = Not Geographically Mirrored
1002 = Geographically Mirrored but do not own IAsp
>=0 Percent

(DTDVersion = 30)

0 = Not Applicable
1 = Active
2 = Not Active

(DTDVersion = 30)

<ASPName ResourceName="string">
  .
  <DeviceDescription . . . >
  .
</ASPName>

<DeviceDescription Name="string"/>

<Disk Name="string"/>

InAvailabilityParity (Already in a parity set that is optimized for availability), StartAvailabilityCapable (Eligible to be included in a non-existing parity set that will be optimized for availability when it is created) (DTDVersion = 20)

(0-99 are the best disks for the ASP)
2 = ASP and Disk are non-switchable.
53 = ASP and Disk are switchable.

(100-199 are valid disks, but not the best)
102 = ASP and Disk are non-switchable, but Disk can be made switchable.
104 = ASP is non-switchable. Disk is switchable, but it's switchable entity already has Disks in a non-switchable ASP.
106 = ASP is non-switchable. Disk is switchable, but there are no configured disks in it's switchable entity.
121 = ASP may be switchable. Disk is switchable.
151 = ASP and Disk are switchable. The disks' switchable entity is in the same Cluster Resource Group (CRG)
153 = ASP is switchable. Disk is switchable, but it's switchable entity has no disks in any ASP in the ASP's CRG.

(200-299 are unlikely disks, and should not be used unless absolutely necessary)
202 = ASP is non-switchable. Disk is switchable and it's switchable entity already has disks in a switchable ASP.
221 = ASP is switchable. Disk is switchable and it's switchable entity already has disks in a switchable ASP.
231 = ASP's switchablitity is unknown.

(300-399 are invalid disks, and may not be used in the ASP)
302 = ASP is non-switchable. Disk is switchable and it's switchable entity already has disks in a switchable ASP.
351 = ASP is switchable. Disk is switchable but it's switchable entity already has disks in a non-switchable ASP.
353 = ASP is switchable. Disk is switchable but cannot be accessed.
355 = ASP is switchable. Disk is switchable but it's switchable entity has disks in a different CRG.
357 = ASP is switchable. Disk is non-switchable.

<DiskPair Name1="string" Name2="string"/>

<ParitySet DiskInSetName="string"/>

<CRG Name="string"
     IsPrimaryNode="Yes | No"
     IsSitePrimaryNode ="Yes | No"
     SiteName="string"/>
  .
  <DeviceDescription . . . >
  <ResourceName . . . >
  .

<ResourceName Name="string"/>

<Message MessageID="Hex Value"
         MessageType="Error | Warning | Info">
  .
  <MessageData . . . >
  .
</Message>

<MessageData Type="string" Value="string"/>

DM Error hex 0000 XXXX
DASD Storage Management Error hex 0001 XXXX
ValidateConfiguration Error hex 0002 XXXX
Clustering Error hex 0003 XXXX

The errors that are returned will be stripped of their leading 0's

DM Errors include all errors not indicated by DASD Storage Management or ValidateConfiguration errors and include parameter validation errors, and DM unexpected exceptions.

If the problem persists, contact your technical support provider

• Wait for independent disk pool resource recovery to run. Then retry the request. Independent disk pool resource recovery runs automatically, but all nodes in the cluster must be active.
• Reduce the number of disk pools being created and try the request again.
• Delete an existing independent disk pool to free up an independent disk pool number. Retry the request.
• Remove a node from the device domain group and try the request again.