CATALOG TCPIP/TCPIP4/TCPIP6 NODE コマンド

許可

必要な接続

なし。 ディレクトリー操作は、ローカル・ディレクトリーだけに影響します。

コマンド構文

>>-CATALOG--+-------+--+-TCPIP NODE--+--nodename---------------->
            '-ADMIN-'  +-TCPIP4 NODE-+             
                       '-TCPIP6 NODE-'             

>--REMOTE--+-hostname-----+--SERVER--+-service-name-+----------->
           +-IPv4 address-+          '-port number--'   
           '-IPv6 address-'                             

>--+----------------+--+--------------------------------+------->
   +-SECURITY SOCKS-+  '-REMOTE_INSTANCE--instance-name-'   
   '-SECURITY SSL---'                                       

>--+---------------------+--+-------------------------------+--->
   '-SYSTEM--system-name-'  '-OSTYPE--operating-system-type-'   

>--+------------------------+----------------------------------><
   '-WITH--"comment-string"-'   

コマンド・パラメーター

ADMIN

TCP/IP Administration Server ノードをカタログすることを指定します。 SECURITY SOCKS パラメーターを指定する場合、このパラメーターは指定できません。

TCPIP NODE nodename

TCPIP、TCPIP4、または TCPIP6 データベース・パーティション・サーバーのノード名は、カタログするデータベースが入っているマシンに設定できるローカル・ニックネームを表します。 IPv4 IP アドレスを指定する場合は TCPIP4 のみ指定し、IPv6 IP アドレスを指定する場合は TCPIP6 のみ指定してください。 nodename の最大長は 8 文字です。

REMOTE hostname | IPv4 address | IPv6 address

ターゲット・データベースが存在するノードのホスト名または IP アドレス。 IP address としては、IPv4 のアドレスも IPv6 のアドレスも使用できます。 ホスト名は、TCP/IP ネットワークで認識されるデータベース・パーティション・サーバーの名前です。 ホスト名の最大長は 255 文字です。

SERVER service-name | port number

サーバー・データベース・マネージャー・インスタンスのサービス名またはポート番号を指定します。 最大長は 14 文字です。このパラメーターには、大文字と小文字の区別があります。

サービス名を指定する場合、 クライアントの services ファイルは、 そのサービス名をポート番号にマップするのに使用されます。 サービス名は、サーバーのデータベース・マネージャー構成ファイルで指定します。 サーバーの services ファイルは、 このサービス名をポート番号にマップするのに使用されます。 クライアントとサーバーのポート番号は一致していなければなりません。

サーバーのデータベース・マネージャー構成ファイルでサービス名の代わりにポート番号を指定することもできますが、 お勧めできません。 ポート番号を指定した場合、ローカルの services ファイルに、サービス名を指定する必要はありません。

ADMIN ノードの場合、このパラメーターは指定できません。 一方、ADMIN 以外のノードの場合、これは必須です。 ADMIN ノードでの値は、常に 523 です。

SECURITY SOCKS

ノードが SOCKS 対応であることを指定します。 このパラメーターは、IPv4 でのみサポートされます。 CATALOG TCPIP NODE が使用されており、かつ SECURITY SOCKS が指定された場合、Db2 データベース製品では接続確立のために IPv4 が使用されます。 ADMIN パラメーターを指定する場合、このパラメーターは指定できません。

以下の環境変数は必須で、SOCKS を有効にするよう設定しなければなりません。

SOCKS_NS

SOCKS サーバーのホスト・アドレスを解決するためのドメイン・ネーム・サーバーです。 これはホスト名または IPv4 アドレスでなければなりません。

SOCKS_SERVER

SOCKS サーバーの完全修飾ホスト名または IPv4 アドレス。 SOCKS 化した IBM® Data Server Client が完全修飾ホスト名を解決できない場合、IPv4 アドレスが入力されたと想定します。

以下の条件の少なくとも 1 つが真である必要があります。

• SOCKS サーバーは、ドメイン・ネーム・サーバー経由で到達可能。
• hosts ファイルの中に、ホスト名のリストがある。 このファイルのロケーションは、TCP/IP ドキュメンテーションに説明されています。
• IPv4 アドレスが指定されている。

このコマンドを db2start の後に出す場合、 このコマンドを有効にするためには TERMINATE コマンドを出す必要があります。

SECURITY SSL

ノードが SSL 対応であることを指定します。SECURITY SSL 節は、ADMIN パラメーターも指定する場合には指定できません。

REMOTE_INSTANCE instance-name

データベースが存在し、アタッチまたは接続を確立するサーバー・インスタンスの名前を指定します。

SYSTEM system-name

サーバー・マシンを識別するために使用する Db2 システム名を指定します。 これは、物理マシン、サーバー・システム、またはワークステーションの名前です。

OSTYPE operating-system-type

サーバー・マシンのオペレーティング・システムのタイプを指定します。 有効な値は、AIX、WIN、HPUX、SUN、OS390、OS400、VM、VSE、および LINUX です。

WITH comment-string

データベース・ディレクトリー内のデータベース項目について記述します。 そのデータベースについての記述を補足する、任意の注釈を入力することができます。 最大長は 30 文字です。 復帰文字や改行文字は許可されません。 注釈テキストは、単一引用符または二重引用符で囲む必要があります。

使用上の注意

データベース・マネージャーは、最初のノードがカタログされたとき (つまり、CATALOG...NODE コマンドが最初に発行されたとき) にノード・ディレクトリーを作成します。 Windows クライアントでは、 そのクライアントをインストールしたインスタンス・サブディレクトリーに、 ノード・ディレクトリーを保管して維持します。 また、AIX クライアントでは、 Db2 インストール・ディレクトリーにノード・ディレクトリーを作成します。

ローカル・ノード・ディレクトリーの内容をリストする場合は、LIST NODE DIRECTORY コマンドを使用してください。

ディレクトリーのキャッシュが有効な場合、データベース、ノード、および DCS ディレクトリー・ファイルはメモリーにキャッシュされます。 アプリケーションのディレクトリー・キャッシュは、最初のディレクトリー検索時に作成されます。 キャッシュはアプリケーションがディレクトリー・ファイルのいずれかを修正したときにのみ最新にされるため、 他のアプリケーションが行ったディレクトリーの変更は、 アプリケーションを再始動するまで有効にならないことがあります。

CLP のディレクトリー・キャッシュを最新表示するには、TERMINATE コマンドを使用します。 Db2 の共有キャッシュを最新表示するには、 データベース・マネージャーを停止させてから (db2stop)、 再始動させます (db2start)。 別のアプリケーション用のディレクトリー・キャッシュを最新にするには、 そのアプリケーションを停止させてから再始動させてください。

Db2 データベース・マネージャーに IPv6 を listen させるには、最初にオペレーティング・システムとサーバーを IPv6 用に構成する必要があります。 システム管理者に相談して、この構成が IPv6 TCPIP ノードのカタログの前に行われるようにしてください。 AIX 6.1 でこれを行う方法については、IPv4 構成の IPv6 へのアップグレードを参照してください。