DMConfigurationScript Specification, Version 60


Table of contents

DMConfigurationScript introduction

About the DMConfigurationScript specification
   Security
   Message IDs

DMConfigurationScript Tag

Info
   DiskInfo
   ASPInfo
   ASPNameInfo
   TowerInfo
   IOPInfo
   CRGInfo
   FindValidDisks
   Filter
      DiskFilter
      ASPFilter
      TowerFilter
      IOPFilter
      CRGFilter

Action
   OpenSession
   CloseSession
   CancelAction
   ContinueAction
   AddDisk
   AssignDisk
   AutoOverflowRecovery
   ChangeMirrorSyncOnIPL
   ChangeParityOptimization
   ChangeRemoteMirroringAttributes
   ClearDisk
   ConfigureLoadSource
   ConvertUDFSASP
   CopyDisk
   CorrectParityMismatch
   CreateSystemGroup
   DeconfigureRemoteMirroring
   DeleteASP
   DetachMirrorCopy
   DeleteData
   ExcludeParityDisk
   FormatDisk
   IncludeParityDisk
   MoveDisk
   PowerOffDisk
   PowerOnDisk
      Location
   ReattachMirrorCopy
   RebuildParity
   RecoverCompression
   RecoverIASPConfig
   RecoverUnknownLodeStone
   RelinkSecondaryASP
   RemoveDisk
   RemoveDiskFullPaging
   CancelRemoveDisk
   PauseRemoveDisk
   ResumeRemoveDisk
   RenameDisk
   ReplaceMirroredUnit
   ResumeMirroring
   ResumeRemoteMirroring
   ResyncParity
   RetrieveDiskLog
   ScanDisk
   SetThreshold
   StartCompression
   StartMirroring
   StartParity
   StopCompression
   StopMirroring
   StopParity
   SuspendMirroring
   SuspendRemoteMirroring
   SwitchTower
   ValidateConfiguration

Status
   ActionProfile

General Subtags
   Tower
   IOP
   ASP
   ASPName
   DeviceDescription
   Disk
   DiskPair
   ParitySet
   CRG
   ResourceName
   Message
      MessageData
      MessageID

About the dmconfigurationscript specification

Following is the specification for DMConfigurationScript. It defines the tags used for the client to talk to the host and tags used by the host to return information to the client. In order to complete this communication, many sub tags have been defined. These include Info which only gives information about the DM configuration, Action which changes the DM configuration, and Status, which gives information about actions the client requested to be performed.


Security

The three DST authorities for Disk Units are:

All Info requests (with the exception of FindValidDisks) require a minimum of Disk units - read only authority. These functions are: DiskInfo, ASPInfo, TowerInfo, IOPInfo, and CRGInfo. All other Info and Status requests require a minimum of Disk units - operations authority.

All Actions require a minimum of Disk units - operations authority.

AssignDisk, CopyDisk, DeconfigureRemoteMirroring, DeleteASP, DeleteData, DetachMirrorCopy, ReattachMirrorCopy, RecoverUnknownLodeStone, RecoverIASPConfig, RelinkSecondaryASP, ResumeRemoteMirroring, and SuspendRemoteMirroring require Disk units - administration authority.


Message IDs

All tags have associated MessageIDs. For example, AddDisk may contain MessageID 0x00000901. A description of these MessageIDs can be found at the end of this document. Any subtag may contain any of it's parents MessageIDs. That is, if DMConfigurationScript generates MessageID 0x00000008, then all subtags may also generate MessageID 0x00000008.