変更の開始

PING 表関数

オンライン編集

PING 表関数は、リモート・システムへの接続をテストします。

この機能は、PING または Verify TCP/IP Connection (VFYTCPCNN) CL コマンドに似ています。

許可: 以下の注を参照してください。

構文図を読むビジュアル構文図をスキップ PING (リモート・システム => remote-system,リモートIPアドレス => リモート IP アドレス,宛先バージョン・フォーマット => アドレス・バージョン・フォーマット,送信されたパケットの数 => 送信パケット数 (number-packets-to-send),送信先のパッケージの長さ => 送信するパケットの長さ,WAIT_TIME => wait-time,ローカル IP アドレス (LOCAL_IP_ADDRESS) => ローカル IP アドレス )
スキーマは SYSTOOLS です。
リモート・システム
ping 操作の実行に使用されるリモート・システムの名前を含む文字ストリング。 次の特殊値を含めることができます。
*INTNETADR
remote-ip-address パラメーターは、リモート・システムを識別します。
このパラメーターを省略した場合、デフォルト値は *INTNETADR であり、 remote-ip-address の値を指定する必要があります。
リモート IP アドレス (remote-ip-address)
リモート IP アドレスを指定する文字ストリング。 有効な IP バージョン 4 または IP バージョン 6 アドレスのいずれかが受け入れられます。
remote-system に *INTNETADR 以外の値が含まれている場合、このパラメーターは無視されます。
アドレス・バージョン・フォーマット
remote-system に指定されたホスト名の解決方法を指定する文字ストリング。 これは、 remote-ip-address が指定されている場合に使用されるアドレス・フォーマットでもあります。
*CALC
ホスト名解決方式は、 remote-systemに入力されたホスト名に基づいて決定されます。 これはデフォルト値。
*IP4
IPバージョン4ホスト名解決方法を使用します。
*IP6
IPバージョン6ホスト名解決方法を使用します。
number-packets-to-send (送信パケット数)
リモート・システムに送信されるパケットの数を指定する整数値。 有効な値は 1 から 999 です。 デフォルトは 5 です。
送信するパケットの長さ
リモート・システムに送信されるパケットの長さ (バイト単位) を指定する整数値。 有効な値は 8 から 65500 です。 デフォルトは 256 です。
待ち時間
パケット転送が失敗したことを宣言する前に戻り (エコー) パケットを待機する秒数を指定する整数値。 有効な値は 1 から 120 です。 デフォルトは、1 です。
ローカル IP アドレス (local-ip-address)
アウトバウンド・パケットが使用するインターフェースのローカル・インターネット・アドレスを指定する文字ストリング。 有効な IP バージョン 4 または IP バージョン 6 アドレスのいずれかが受け入れられます。 *ANY は, 任意のインターフェースのローカル IP アドレスを使用できることを示します。 デフォルトは *ANY です。
この関数の結果は、以下の表に示された形式の単一の行を含むテーブルです。 列はすべて NULL 可能です。
表 1. PING 表関数
列名 データ・タイプ 説明
RESULT VARCHAR(7) PING 要求の結果。
FAILURE
少なくとも 1 つのパケットが応答しなかったか、コマンドでエラーが発生しました。
SUCCESS
応答されたすべてのパケット。
成功パーセント INTEGER 成功したパケット応答の割合。
PACKETS_SENT INTEGER 送信されたパケットの合計数。
応答が返されました INTEGER 送信されたパケットについて受信された応答の総数。
ラウンド・トリップ平均 INTEGER 応答の平均時間 (ミリ秒単位)。
最小のラウンド・トリップ INTEGER 応答の最短時間 (ミリ秒単位)。
ラウンド・トリップ最大 INTEGER 応答の最長時間 (ミリ秒単位)。
REMOTE_HOST_NAME VARCHAR(255) PING 要求のターゲットであったホストの名前。
リモートIPアドレス VARCHAR(45) REMOTE_HOST_NAME の IP アドレス。

ノート

この関数は、状況情報を収集するためにジョブ・ログ内のメッセージを調べる方法の例として SYSTOOLS スキーマで提供されています。 他の Db2® for i 提供ツールと同様に、SQL ソースを抽出して、類似のヘルパー関数を作成するためのモデルとして使用したり、ユーザー指定のスキーマ内にカスタマイズしたバージョンを作成するために使用したりすることができます。

SYSTOOLS で提供されるサービスには、サービスの実装に使用されるインターフェースによって決定される許可要件があります。 権限要件を理解するには、サービスの SQL を抽出し、実装を調べます。

例

  • 名前によってリモート・システムへの接続を検査します。
    SELECT * FROM TABLE(SYSTOOLS.PING('REMOTESYS'));
  • IP アドレスによってリモート・システムへの接続を検査します。
    SELECT * FROM TABLE(SYSTOOLS.PING(REMOTE_IP_ADDRESS => '9.1.2.3'));
変更の終わり