Hitachi Command Suite CLI リファレンスガイド

6.3.3 バッチファイルでコマンドをまとめて処理するためのパラメーターの条件

バッチファイル内の複数のコマンドを1つにまとめて処理するためには，連続するコマンド行のパラメーターの値や組み合わせに次の条件があります。必要な条件を満たす場合に，複数のコマンドがまとめて実行されます。

条件-1：前の行と同じ値を指定する
前の行と同じパラメーターと同じパラメーターの値を指定する必要があることを意味します。パラメーターが同じでもその値が異なると，まとめては処理されません。
例えば，一行目のAddExternalArrayGroupコマンドで「model=VSP」と指定されている場合，まとめて処理するときは，二行目にも「model=VSP」と指定します。
また，省略すると既定値が設定されるパラメーターについても前の行の指定の有無に従う必要があります。
例えば，AddExternalArrayGroupコマンドのパラメーターluoptionは，省略すると「luoption=none」が指定されたと見なされます。まとめて処理する場合，一行目で「luoption=none」を省略したときは，二行目でも省略します。同様に，一行目で「luoption=none」と指定したときは，二行目でも指定します。

条件-2：前の行と同じパラメーターを指定する
前の行と同じパラメーターを指定する必要があることを意味します。パラメーターの値が前の行の値と異なる場合でもまとめて処理されます。
例えば，一行目のAddLunコマンドでパラメーターportおよびdomainが指定されている場合，まとめて処理するときは，二行目にもパラメーターportおよびdomainを指定します。一行目に指定されていないパラメーターを追加して，二行目にパラメーターport，domain，およびdevnumを指定した場合，まとめては処理されません。

条件-3：特定の値を指定する
特定の値を指定する必要があることを意味します。まとめて処理できない値を指定した場合は，指定したコマンド行だけで実行されます。

条件-4：パラメーターの指定を省略する
パラメーターの指定を省略する必要があることを意味します。指定すると，コマンドをまとめて処理できません。指定したコマンド行だけでコマンドが実行されます。省略すると，まとめて実行できます。

パラメーターの指定条件を，コマンドごとに以降の表に示します。「指定条件」の列の「条件-n」は，上記で説明している条件に対応しています。

表6-1 AddConfigFileForReplicationコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 groupname
pvolarraytype
pvolhostid
pvolinstancenum
pvolportnum
pvolserialnum
svolarraytype
svolhostid
svolinstancenum
svolportnum
svolserialnum
新規にコピーグループを作成してコピーペアの定義を追加する場合，パラメーターgroupnameを省略してバッチ機能を実行すると，まとめて実行されたコマンド単位で新しいコピーグループ内にコピーペアの定義が追加されます。このとき，コピーグループ名は自動生成されます。

条件-2 pvolportid
pvolportname
svolportid
svolportname
--

条件-3 replicationfunction パラメーターreplicationfunctionにglobal-activedeviceを指定した場合だけ，バッチ機能を実行できます。

制約なし confpvoldevnum
confpvolserialnum
confsvoldevnum
confsvolserialnum
munum
pairoption
pvoldevnum
pvolpoolid
svoldevnum
svolpoolid
--

表6-2 AddExternalArrayGroupコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 luoption
model
numoflus
serialnum
--

制約なし cachemode
capacity
capacitytype
clprnumber
devnum
emulation
externalgrpnum
externallun
externalwwn
inflowcontrol
pathgroupid
portname
1つのバッチファイルにパラメーターdevnumを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。このパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-3 AddHostStorageDomainコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 model
serialnum
--

条件-2 port
portname
--

制約なし additionalparameter
alternatepath
domain
domainiscsiname
domaintype
failover
hostmode
hostmode2
hostmodeoption
middleware
name
nickname
platform
1つのバッチファイルにパラメーターdomainまたはnicknameを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-4 AddLogicalUnitコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 format
model
serialnum
パラメーターformatで指定する値がquickの場合，一部のコンポーネントに負荷が集中し，対象のストレージシステム内で実行されるすべてのホストI/Oの性能が低下するおそれがあります。クイックフォーマット実行時の注意事項については，マニュアル「Hitachi Command Suiteユーザーズガイド」を参照してください。

条件-2 arraygroupname
chassis
groupnum
パラメーターarraygroupname，chassis，およびgroupnumで指定したパリティグループのエミュレーションタイプが，OPEN-V以外の場合は，バッチ機能の実行中にエラーとなり，処理が中断されます。指定するパリティグループのエミュレーションタイプを確認してから，バッチ機能を実行してください。

条件-3 emulation
model

パラメーターemulationで指定する値がOPEN-Vの場合，またはパラメーターの指定を省略した場合に，まとめて実行できます。

パラメーターmodelはVSP 5000シリーズ，VSP G1000，G1500，VSP F1500，VSP Gx00モデル，VSP Fx00モデル，Virtual Storage Platform，Universal Storage Platform V/VM，およびHUS VMに対応する値を指定した場合に，まとめて実行できます。

条件-4 creationoption
fsindex
numoflus
--

制約なし capacity
capacitytype
clprNumber
defaultportcontrollername
defportcntl
devnum
lusubinfo
stripeSizeInKB
1つのバッチファイルにパラメーターdevnumを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。このパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-5 AddLunコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

条件-2 devnum
domain
domainnickname
lusedevnums
port
portname

制約なし lun
name
scsi

表6-6 AddLUSEコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 luseoption
model
serialnum

制約なし devnums

表6-7 AddPArrayGroupToPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
rpuid
serialnum

条件-2 arraygroupname
chassis
groupnum

表6-8 AddPHSDToPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
rpuid
serialnum

条件-2 port
portname

制約なし domain

表6-9 AddPLDEVToPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
rpuid
serialnum

制約なし devnum

表6-10 AddPPortToPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
rpuid
serialnum

条件-2 port
portname

表6-11 AddReplicationコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 copytracksize
ctgid
groupname
pairoption
pvolarraytype
pvolhostid
pvolinstancenum
pvolportnum
pvolserialnum
quorumdiskid
replicationgroupid
svolarraytype
svolhostid
svolinstancenum
svolportnum
svolserialnum
新規にコピーグループを作成してコピーペアを作成する場合，パラメーターgroupnameを省略してバッチ機能を実行すると，まとめて実行されたコマンド単位で新しいコピーグループ内にコピーペアが作成されます。このとき，コピーグループ名は自動生成されます。

条件-2 pvolportid
pvolportname
svolportid
svolportname
--

条件-3 replicationfunction パラメーターreplicationfunctionにglobal-activedeviceを指定した場合だけ，バッチ機能を実行できます。

制約なし confpvoldevnum
confpvolserialnum
confsvoldevnum
confsvolserialnum
fencelevel
munum
pvoldevnum
pvolpoolid
svoldevnum
svolpoolid
--

表6-12 AddVirtualVolumeコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 capacitytype
creationoption
model
serialnum
--

条件-2 clprNumber
poolid
--

条件-4 groupoption
numoflus
--

制約なし arraygroupname
capacity
devnum
fullallocation
threshold
1つのバッチファイルにパラメーターarraygroupnameまたはdevnumを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-13 AddVLDEVToVRPUコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 creationoption
model
overwrite
serialnum
vldevoperation
vrpuid
--

制約なし devnum
vcvs
vdevnum
vemulation
vluse
vssid
1つのバッチファイルにパラメーターvdevnumまたはvssidを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-14 AddVResourcePartitionUnitコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

制約なし vmodel
vfamily
vrpuname
vserialnum

表6-15 AddWWNForHostStorageDomainコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

条件-2 port
portname

制約なし domain
domainnickname
wwn
wwnnickname

表6-16 CancelVLDEVReservationコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum
vrpuid

制約なし devnum

表6-17 DeleteHostStorageDomainコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 deletionoption
model
serialnum

条件-2 domain
domainnickname
port
portname

表6-18 DeleteLunコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 deletionoption
model
serialnum

条件-2 port
portname

制約なし devnum
domain
domainnickname

表6-19 DeleteLUSEコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

制約なし devnum

表6-20 DeletePArrayGroupFromPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

条件-2 arraygroupname
chassis
groupnum

表6-21 DeletePHSDFromPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

条件-2 port
portname

制約なし domain

表6-22 DeletePLDEVFromPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

制約なし devnum

表6-23 DeletePPortFromPRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

条件-2 port
portname

表6-24 DeleteVLDEVFromVRPUコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 deletionoption
model
serialnum
vrpuid

制約なし devnum

表6-25 DeleteVResourcePartitionUnitコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 deletionoption
model
serialnum

制約なし vrpuid

表6-26 GetReplicationStatusコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum

制約なし pvoldevnum
pvolserialnum
svoldevnum
svolserialnum

表6-27 ModifyExternalArrayGroupコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 cachemode
model
serialnum

条件-2 arraygroupname
chassis
groupname

表6-28 ModifyVirtualVolumeコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 assign
model
modificationoption
serialnum
--

制約なし capacity
clprNumber
devnums
fullallocation
poolid
threshold
tieringpolicy
tierrelocation
newpageassignmenttier
relocationpriority
パラメーターdevnumsには，DPボリュームのデバイス番号を複数指定できます。ただし，5個以上指定したい場合，複数のコマンド行に分けて記述してください。1つのコマンド行にDPボリュームのデバイス番号を5個以上指定してバッチ機能を実行した場合，KAIC90084-Eのエラーメッセージでレスポンスの値が「413 Request Entity Too Large」のエラーが発生するおそれがあります。

表6-29 ModifyVLDEVコマンドのパラメーターの指定条件

指定条件パラメーター注意事項

条件-1 model
serialnum
vldevoperation
vrpuid
--

制約なし devnum
vcvs
vdevnum
vemulation
vluse
vssid
1つのバッチファイルにパラメーターvdevnumまたはvssidを指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

表6-30 ReserveVLDEVコマンドのパラメーターの指定条件

指定条件パラメーター

条件-1 model
serialnum
vrpuid

制約なし devnum

指定条件	パラメーター	注意事項
条件-1	`groupname` `pvolarraytype` `pvolhostid` `pvolinstancenum` `pvolportnum` `pvolserialnum` `svolarraytype` `svolhostid` `svolinstancenum` `svolportnum` `svolserialnum`	新規にコピーグループを作成してコピーペアの定義を追加する場合，パラメーター`groupname`を省略してバッチ機能を実行すると，まとめて実行されたコマンド単位で新しいコピーグループ内にコピーペアの定義が追加されます。このとき，コピーグループ名は自動生成されます。
条件-2	`pvolportid` `pvolportname` `svolportid` `svolportname`	--
条件-3	`replicationfunction`	パラメーター`replicationfunction`に`global-activedevice`を指定した場合だけ，バッチ機能を実行できます。
制約なし	`confpvoldevnum` `confpvolserialnum` `confsvoldevnum` `confsvolserialnum` `munum` `pairoption` `pvoldevnum` `pvolpoolid` `svoldevnum` `svolpoolid`	--

指定条件	パラメーター	注意事項
条件-1	`luoption` `model` `numoflus` `serialnum`	--
制約なし	`cachemode` `capacity` `capacitytype` `clprnumber` `devnum` `emulation` `externalgrpnum` `externallun` `externalwwn` `inflowcontrol` `pathgroupid` `portname`	1つのバッチファイルにパラメーター`devnum`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。このパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター	注意事項
条件-1	`model` `serialnum`	--
条件-2	`port` `portname`	--
制約なし	`additionalparameter` `alternatepath` `domain` `domainiscsiname` `domaintype` `failover` `hostmode` `hostmode2` `hostmodeoption` `middleware` `name` `nickname` `platform`	1つのバッチファイルにパラメーター`domain`または`nickname`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター	注意事項
条件-1	`format` `model` `serialnum`	パラメーター`format`で指定する値が`quick`の場合，一部のコンポーネントに負荷が集中し，対象のストレージシステム内で実行されるすべてのホストI/Oの性能が低下するおそれがあります。クイックフォーマット実行時の注意事項については，マニュアル「Hitachi Command Suiteユーザーズガイド」を参照してください。
条件-2	`arraygroupname` `chassis` `groupnum`	パラメーター`arraygroupname`，`chassis`，および`groupnum`で指定したパリティグループのエミュレーションタイプが，`OPEN-V`以外の場合は，バッチ機能の実行中にエラーとなり，処理が中断されます。指定するパリティグループのエミュレーションタイプを確認してから，バッチ機能を実行してください。
条件-3	`emulation` `model`	パラメーター`emulation`で指定する値が`OPEN-V`の場合，またはパラメーターの指定を省略した場合に，まとめて実行できます。パラメーター`model`はVSP 5000シリーズ，VSP G1000，G1500，VSP F1500，VSP Gx00モデル，VSP Fx00モデル，Virtual Storage Platform，Universal Storage Platform V/VM，およびHUS VMに対応する値を指定した場合に，まとめて実行できます。
条件-4	`creationoption` `fsindex` `numoflus`	--
制約なし	`capacity` `capacitytype` `clprNumber` `defaultportcontrollername` `defportcntl` `devnum` `lusubinfo` `stripeSizeInKB`	1つのバッチファイルにパラメーター`devnum`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。このパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター
条件-1	`model` `serialnum`
条件-2	`devnum` `domain` `domainnickname` `lusedevnums` `port` `portname`
制約なし	`lun` `name` `scsi`

指定条件	パラメーター
条件-1	`luseoption` `model` `serialnum`
制約なし	`devnums`

指定条件	パラメーター
条件-1	`model` `rpuid` `serialnum`
条件-2	`arraygroupname` `chassis` `groupnum`

指定条件	パラメーター
条件-1	`model` `rpuid` `serialnum`
条件-2	`port` `portname`
制約なし	`domain`

指定条件	パラメーター
条件-1	`model` `rpuid` `serialnum`
制約なし	`devnum`

指定条件	パラメーター
条件-1	`model` `rpuid` `serialnum`
条件-2	`port` `portname`

指定条件	パラメーター	注意事項
条件-1	`copytracksize` `ctgid` `groupname` `pairoption` `pvolarraytype` `pvolhostid` `pvolinstancenum` `pvolportnum` `pvolserialnum` `quorumdiskid` `replicationgroupid` `svolarraytype` `svolhostid` `svolinstancenum` `svolportnum` `svolserialnum`	新規にコピーグループを作成してコピーペアを作成する場合，パラメーター`groupname`を省略してバッチ機能を実行すると，まとめて実行されたコマンド単位で新しいコピーグループ内にコピーペアが作成されます。このとき，コピーグループ名は自動生成されます。
条件-2	`pvolportid` `pvolportname` `svolportid` `svolportname`	--
条件-3	`replicationfunction`	パラメーター`replicationfunction`に`global-activedevice`を指定した場合だけ，バッチ機能を実行できます。
制約なし	`confpvoldevnum` `confpvolserialnum` `confsvoldevnum` `confsvolserialnum` `fencelevel` `munum` `pvoldevnum` `pvolpoolid` `svoldevnum` `svolpoolid`	--

指定条件	パラメーター	注意事項
条件-1	`capacitytype` `creationoption` `model` `serialnum`	--
条件-2	`clprNumber` `poolid`	--
条件-4	`groupoption` `numoflus`	--
制約なし	`arraygroupname` `capacity` `devnum` `fullallocation` `threshold`	1つのバッチファイルにパラメーター`arraygroupname`または`devnum`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター	注意事項
条件-1	`creationoption` `model` `overwrite` `serialnum` `vldevoperation` `vrpuid`	--
制約なし	`devnum` `vcvs` `vdevnum` `vemulation` `vluse` `vssid`	1つのバッチファイルにパラメーター`vdevnum`または`vssid`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター
条件-1	`model` `serialnum`
制約なし	`vmodel` `vfamily` `vrpuname` `vserialnum`

指定条件	パラメーター
条件-1	`model` `serialnum`
条件-2	`port` `portname`
制約なし	`domain` `domainnickname` `wwn` `wwnnickname`

指定条件	パラメーター
条件-1	`model` `serialnum` `vrpuid`
制約なし	`devnum`

指定条件	パラメーター
条件-1	`deletionoption` `model` `serialnum`
条件-2	`domain` `domainnickname` `port` `portname`

指定条件	パラメーター
条件-1	`deletionoption` `model` `serialnum`
条件-2	`port` `portname`
制約なし	`devnum` `domain` `domainnickname`

指定条件	パラメーター
条件-1	`model` `serialnum`
制約なし	`devnum`

指定条件	パラメーター
条件-1	`model` `serialnum`
条件-2	`arraygroupname` `chassis` `groupnum`

指定条件	パラメーター
条件-1	`model` `serialnum`
条件-2	`port` `portname`
制約なし	`domain`

指定条件	パラメーター
条件-1	`model` `serialnum`
制約なし	`devnum`

指定条件	パラメーター
条件-1	`model` `serialnum`
条件-2	`port` `portname`

指定条件	パラメーター
条件-1	`deletionoption` `model` `serialnum` `vrpuid`
制約なし	`devnum`

指定条件	パラメーター
条件-1	`deletionoption` `model` `serialnum`
制約なし	`vrpuid`

指定条件	パラメーター
条件-1	`model` `serialnum`
制約なし	`pvoldevnum` `pvolserialnum` `svoldevnum` `svolserialnum`

指定条件	パラメーター
条件-1	`cachemode` `model` `serialnum`
条件-2	`arraygroupname` `chassis` `groupname`

指定条件	パラメーター	注意事項
条件-1	`assign` `model` `modificationoption` `serialnum`	--
制約なし	`capacity` `clprNumber` `devnums` `fullallocation` `poolid` `threshold` `tieringpolicy` `tierrelocation` `newpageassignmenttier` `relocationpriority`	パラメーター`devnums`には，DPボリュームのデバイス番号を複数指定できます。ただし，5個以上指定したい場合，複数のコマンド行に分けて記述してください。1つのコマンド行にDPボリュームのデバイス番号を5個以上指定してバッチ機能を実行した場合，`KAIC90084-E`のエラーメッセージでレスポンスの値が「`413 Request Entity Too Large`」のエラーが発生するおそれがあります。

指定条件	パラメーター	注意事項
条件-1	`model` `serialnum` `vldevoperation` `vrpuid`	--
制約なし	`devnum` `vcvs` `vdevnum` `vemulation` `vluse` `vssid`	1つのバッチファイルにパラメーター`vdevnum`または`vssid`を指定したコマンド行と省略した行を混在させる場合，パラメーターを指定したコマンド行を先に記述してください。これらのパラメーターを省略した場合，自動で値が設定されます。このため，パラメーターを省略した行が先に記述されていると，パラメーターを指定したコマンド行を実行するときに指定した値がすでに使用されている旨のエラーが発生するおそれがあります。

指定条件	パラメーター
条件-1	`model` `serialnum` `vrpuid`
制約なし	`devnum`

[目次] [前へ] [次へ]

[マニュアル発行元]