nzstate コマンド

現在のシステム状態を表示する場合、または特定のシステム状態に移行するのを待機する場合は、nzstate コマンドを使用します。

構文

nzstate コマンドは次の構文を使用します。

nzstate [-h|-rev|-hc] subcmd [subcmd options]]

入力

nzstate コマンドは次の入力を取ります。

表 1. nzstate の入力
入力	説明
nzstate listStates	システム状態および説明を表示します。
nzstate show `オプション`	現在の状態を表示します。引数なしでコマンドを入力する場合には、これがデフォルトとなります。
nzstate waitFor `オプション`	システムの状態が指定した状態になるまで待機します。 -ing で終わる名前の状態を待機することはできません。

オプション

nzstate コマンドは次のオプションを取ります。

表 2. nzstate オプション
コマンド	オプション	説明
nzstate listStates		オプションを取りません。
nzstate show	-u `ユーザー`	データベース・ユーザー名 [NZ_USER] を指定します。
	-pw `password`	ユーザー・パスワード [NZ_PASSWORD] を指定します。
	-ホスト `名称`	ホスト名または IP アドレス [NZ_HOST] を指定します。
	-タイムアウト `秒`	タイムアウト・エラーで終了するまでのコマンドの実行待機時間を秒単位で指定します。デフォルトは 300 です。
	-簡明	現在の状態を表す記号のみを表示します。
	-verbose	予想した状態が現在の状態と異なる場合には表示します。
	-理由	システムが Down 状態になっている理由の詳細を表示します。
nzstate waitFor	-タイプ `状態タイプ`	指定した状態が発生するまで待機します。 listStates サブコマンドを使用して、状態タイプを表示します。
	-u `ユーザー`	データベース・ユーザー名 [NZ_USER] を指定します。
	-pw `password`	ユーザー・パスワード [NZ_PASSWORD] を指定します。
	-ホスト `名称`	ホスト名または IP アドレス [NZ_HOST] を指定します。
	-タイムアウト `秒`	タイムアウト・エラーで終了するまでのコマンドの実行待機時間を秒単位で指定します。デフォルトは 300 です。

説明

nzstateコマンドは、以下のことを行います。

必要な特権: nzstate listStatesコマンドを実行するのに特別な権限は必要ない。状態を表示または待機するには、データベース・ユーザー・アカウントを指定する必要があります。
共通タスク: nzstate コマンドを使用して、現在の状態を表示します。

使用法

以下に使用例を示します。

状態をリストする

nzstate listStates
State Symbol Description
------------ ------------------------------------------------------------
initialized  used by a system component when first starting
paused       already running queries will complete but new ones are queued
pausedNow    like paused, except running queries are aborted
offline      no queries are queued, only maintenance is allowed
offlineNow   like offline, except user jobs are stopped immediately
online       system is running normally
stopped      system software is not running
down         system was not able to initialize successfully

現在の状態を表示する

nzstate show -u user -pw password -host nzhost -verbose

状態が移行するかコマンド・タイマーが満了するまでオフライン状態を待機する
```
nzstate waitFor -u user -pw password -host nzhost -type offline
```

Down 状態になっているシステムに関する詳細を表示する

nzstate -reason
The system is DOWN because failing over SPUs results in invalid 
topology