4.1.38 GetStorageArray (subtarget=HostStorageDomain)

GetStorageArray (subtarget=HostStorageDomain)コマンドは,ホストストレージドメインに関する情報を取得します。

パラメーター

表4-41 GetStorageArray (subtarget=HostStorageDomain)コマンドのパラメーター

パラメーター名指定のレベル説明
subtarget必須HostStorageDomainを指定します。
serialnum任意ストレージシステムのシリアル番号
省略した場合,すべてのストレージシステムが対象となります。
model任意ストレージシステムのモデル
省略した場合,すべてのストレージシステムが対象となります。
domain任意ホストストレージドメインのドメインID
省略した場合,すべてのホストストレージドメインが対象となります。このパラメーターを指定する場合,パラメーターmodelおよびserialnumも必ず指定します。このパラメーターは10進数または16進数で指定できます。16進数で指定する場合は,プレフィックスとして0xを付けてください。
実行結果は10進数で出力されます。
このパラメーターを指定する場合,パラメーターportまたはportnameのどちらか一方を必ず指定します。どちらも指定しなかった場合,このパラメーターは無視されます。
domaindomainnicknameを同時に指定しないでください。同時に指定するとエラーとなります。
domainnickname任意ホストストレージドメインのニックネーム
省略した場合,すべてのホストストレージドメインが対象となります。このパラメーターを指定する場合,パラメーターmodelおよびserialnumも必ず指定します。
このパラメーターを指定する場合,パラメーターportまたはportnameのどちらか一方を必ず指定します。どちらも指定しなかった場合,このパラメーターは無視されます。
domaindomainnicknameを同時に指定しないでください。同時に指定するとエラーとなります。
hsdsubinfo任意ホストストレージドメインの特定情報
指定できる値は,WWNPathFreeLUNISCSIName,およびVHostStorageDomainです。複数の値を指定する場合はコンマで区切ります。
VHostStorageDomainは,Virtual Storage Platform(マイクロコードのバージョンが70-03-30-XX/XX以降)またはHUS VM(マイクロコードのバージョンが73-01-3X-XX/XX以降)の場合だけ指定できます。
port任意ホストストレージドメインのポート番号
portおよびportnameを省略した場合,すべてのポートに関する情報が表示されます。このパラメーターを指定する場合,パラメーターmodelおよびserialnumも必ず指定します。
このパラメーターを指定する場合,パラメーターdomainまたはdomainnicknameのどちらか一方を必ず指定します。どちらも指定しなかった場合,このパラメーターは無視されます。
portportnameを同時に指定しないでください。同時に指定するとエラーとなります。
portname任意ホストストレージドメインのポート名
portおよびportnameを省略した場合,すべてのポートに関する情報が表示されます。このパラメーターを指定する場合,パラメーターmodelおよびserialnumも必ず指定します。
このパラメーターを指定する場合,パラメーターdomainまたはdomainnicknameのどちらか一方を必ず指定します。どちらも指定しなかった場合,このパラメーターは無視されます。
portportnameを同時に指定しないでください。同時に指定するとエラーとなります。
startElementNumFilter任意情報を取得するホストストレージドメインの最初の並び番号
特定のストレージシステムでの一部のホストストレージドメインに関する情報を取得する場合に指定します。
ホストストレージドメインの情報を次の順序で並べ,0から始まる並び番号を付けたとき,取得するホストストレージドメインの並びの中で最初の番号を指定します。
ホストストレージドメインの並び替え順序:
  1. ポートIDの昇順
  2. ドメインIDの昇順
このパラメーターを指定する場合,パラメーターnumOfElementsFiltermodel,およびserialnumも必ず指定します。
numOfElementsFilter任意情報を取得するホストストレージドメインの個数
特定のストレージシステムでの一部のホストストレージドメインに関する情報を取得する場合に指定します。情報を取得するホストストレージドメインの個数を指定します。このパラメーターを指定する場合,パラメーターstartElementNumFiltermodel,およびserialnumも必ず指定します。
指定値の推奨の最大値は16384です。

事前に取得するパラメーター値

serialnumおよびmodel
GetStorageArrayコマンドの実行結果から取得してください。実行結果のarrayType値またはdisplayArrayType値をパラメーターmodelに指定してください。serialNumber値をパラメーターserialnumに指定してください。
domainおよびport
GetStorageArray (subtarget=HostStorageDomain)コマンドの実行結果から取得してください。このコマンドを実行するときにはパラメーターmodelとパラメーターserialnumだけを指定し,パラメーターsubtargetにはHostStorageDomainを指定してください。実行結果では,domainID値とportID値がAn instance of HostStorageDomainの下に表示されます。これらのdomainID値とportID値をそれぞれパラメーターdomainとパラメーターportとして指定してください。
portname
GetStorageArray (subtarget=Port)コマンドの実行結果から取得してください。実行結果では,displayNameAn instance of Portの下に表示されます。この値をportnameとして指定してください。
domainnickname
GetStorageArray (subtarget=HostStorageDomain)コマンドの実行結果から取得してください。実行結果では,nicknameAn instance of HostStorageDomainの下に表示されます。この値をdomainnicknameとして指定してください。

コマンド実行例

この例では,ストレージシステム(シリアル番号:10001,モデル:HDS9980V)のホストストレージドメイン(ポート番号:3,ドメインID:1)に関する情報を,GetStorageArray (subtarget=HostStorageDomain)コマンドで取得します。この情報には,ホストストレージドメインのパス,WWN,および未使用LUNに関する情報が含まれます。

HiCommandCLI GetStorageArray -o "D:¥logs¥GetStorageArray_HostStorageDomain.log" subtarget=HostStorageDomain model=HDS9980V serialnum=10001 port=23 domain=1 hsdsubinfo=path,wwn,freelun

コマンド実行結果

RESPONSE:
An instance of StorageArray
 .
 . (Attributes of StorageArray are omitted here)
 .
 List of 1 HostStorageDomain elements:
   An instance of HostStorageDomain
     objectID=HSDOMAIN.HDS9980V.10001.23.1
     portID=23
     portName=CL2-H
     domainID=1
     hostMode=Standard
     displayName=CL1-A-0
     domainType=0
     nickname=1A-G00
     List of 1 WWN elements:
       An instance of WWN
         WWN=88.77.77.77.77.77.00.01
         nickname=Jane
     List of 7 FreeLUN elements:
       An instance of FreeLUN
         lun=9
       An instance of FreeLUN
         lun=10
          .
          . (repeated for other FreeLUN instances)
          .
     List of 1 Path elements:
       An instance of Path
         objectID=PATH.HDS9980V.10001.23.1.10
         devNum=10
         displayDevNum=00:0A
         portID=23
         portName=CL2-H
         domainID=1
         scsiID=15
         LUN=10
         wwnSecurityValidity=true