6.5.2　パラメーター

-path

HDLMが管理しているパスを操作することを指定します。

onlineオペレーションの対象物はパスだけなので，この指定は省略できます。

-cha，-pathid，または-hbaportwwnパラメーターで，稼働状態にするパスを指定できます。これらのパラメーターを省略した場合は，すべての閉塞状態のパスを稼働状態にします。稼働状態にできないパスがあった場合，処理を継続するかどうかを確認するメッセージが表示されます。稼働状態にできなかったパスを閉塞状態のままにして処理を継続する場合は「y」を，処理を中断する場合は「n」を入力してください。

-cha -pathid パス管理PATH_ID

CHAポート単位でパスを稼働状態にする場合に指定します。-pathidパラメーターで指定したパスが経由しているCHAポートを通る，すべてのパスを稼働状態にします。物理ストレージシステムの物理CHAポート単位でパスが稼働状態になります。

viewオペレーションで表示される，現在のパス管理PATH_IDを指定します。viewオペレーションについては，「6.7　view 情報を表示する」を参照してください。パス管理PATH_IDの，左側の桁から0詰めされている0は省略できます（000001と1は同値です）。ただし，パス管理PATH_ID「000000」を指定する場合は，「000000」または「0」を指定してください。

パス管理PATH_IDは，ホストの再起動時に新しく割り当てられます。必ずviewオペレーションを実行して，稼働状態にするパスの現在のパス管理PATH_IDを確認してから，onlineオペレーションを実行してください。

使用例

コマンド実行の確認をして，CHAポート「0A」を通るすべてのパスを稼働状態にする場合（パス管理PATH_ID「000002」がCHAポート「0A」を通っているとき）

PROMPT>dlnkmgr online -cha -pathid 000002
KAPL01057-I 指定されたCHA portを通る全てのパスをOnlineにします。よろしいですか？ [y/n] :y 
KAPL01061-I 2本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
PROMPT>

-pathid パス管理PATH_ID

単一のパスを稼働状態にする場合に指定します。

viewオペレーションで表示される，現在のパス管理PATH_IDを指定します。viewオペレーションについては，「6.7　view 情報を表示する」を参照してください。パス管理PATH_IDの，左側の桁から0詰めされている0は省略できます（000001と1は同値です）。ただし，パス管理PATH_ID「000000」を指定する場合は，「000000」または「0」を指定してください。

パス管理PATH_IDは，ホストの再起動時に新しく割り当てられます。必ずviewオペレーションを実行して，稼働状態にするパスの現在のパス管理PATH_IDを確認してから，onlineオペレーションを実行してください。

-hbaportwwn HBAポートWWN

HBAポートWWNで指定したHBAポートに接続されている，すべてのパスを稼働状態にする場合に指定します。指定できるパラメーター値は1つだけです。

HBAポートWWNには，HBAPortWWNを指定します。英字の大文字，小文字は区別されません。

HBAPortWWNおよびPathNameは，次に示すviewオペレーションを実行すると表示されます。

dlnkmgr view -path -hbaportwwn

viewオペレーションを実行してHBAポートWWNおよびパス名を表示する方法については，「6.7.2　パラメーター」の「(3)　パス情報を表示する場合」を参照してください。

使用例

コマンド実行の確認をして，HBAポートWWN「10000000C93213BA」を通るパスを稼働状態にする場合

PROMPT>dlnkmgr online -path -hbaportwwn 10000000C93213BA
KAPL01104-I 指定されたHBAポートを通る全てのパスをOnlineにします。よろしいですか？ [y/n]:y
KAPL01061-I 6本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
PROMPT>

-s

コマンド実行の確認メッセージを表示しないで実行します。シェルスクリプトやバッチファイルでコマンドを実行する場合など，確認メッセージへの入力を省略したいときに指定します。

使用例

コマンド実行の確認をしないで，パス管理PATH_ID「000002」のパスを稼働状態にする場合

PROMPT>dlnkmgr online -pathid 2 -s
KAPL01061-I 1本のパスをOnlineにしました。失敗したパス = 0本。オペレーション名 = online
PROMPT>

-help

onlineオペレーションの形式が表示されます。

使用例

PROMPT>dlnkmgr online -help
online:
  Format
    dlnkmgr [Host-Connection-Options] online [-path] [-s]
    dlnkmgr [Host-Connection-Options] online [-path]
                              -cha -pathid AutoPATH_ID [-s]
    dlnkmgr [Host-Connection-Options] online [-path] -pathid AutoPATH_ID [-s]
    dlnkmgr [Host-Connection-Options] online [-path]
                              -hbaportwwn HBA_Port_WWN [-s]
   Host-Connection-Options:
     [ -s SERVER      | --server=SERVER ]
     [ -u USERNAME    | --username=USERNAME ]
     [ -p PASSWORD    | --password=PASSWORD ]

  Valid value
    AutoPATH_ID     { 000000 - 999999 }(Decimal)
KAPL01001-I HDLMコマンドが正常終了しました。オペレーション名 = online, 終了時刻 = yyyy/mm/dd  hh:mm:ss
PROMPT>

参考

HDLMコマンドのviewオペレーションとOSのコマンドを組み合わせて実行すると，特定のCHAポートで，パスの情報を絞り込んで表示できます。viewオペレーションについては，「6.7　view 情報を表示する」を参照してください。

CHAポート単位でパスを稼働状態にする前に，次のコマンドを実行して，稼働状態にするパスの情報を確認することをお勧めします。

例

VSP One B20のCHAポート「1B」を通るすべてのパスを確認する場合

dlnkmgr view -path -stname | find "VSP_One_Block" | find "1B"

指定したCHAポートを通るパスの情報だけが表示されます。