ログと環境変数 Contents Windows の ODBC ログ UNIX® の ODBC ログ ODBC 環境変数 この章では、トラブルシューティングを実行するために使用できるツールについて説明します。 Caution: ログは、トラブルシューティングを実行する必要がある場合のみ有効にします。ログを有効にするとパフォーマンスが大幅に低下するため、通常の操作時は有効にしないでください。 Windows の ODBC ログ Windows で ODBC データ・ソースのログを有効にするには、[ODBC データ ソース アドミニストレーター] を使用して、DSN のログ情報を変更します (使用法の詳細は、“ODBC データ ソース アドミニストレーターによる DSN の作成” を参照してください)。[ODBC データ ソース アドミニストレーター] で、以下の変更を行います。 クライアント・ドライバのログを有効にするには、ログに記録したい DSN の定義を見つけて開き、[ODBC ログ] (または [ログ] や同様の表現) というラベルのボックスにチェックを付けます。 ドライバ・マネージャのログを有効にするには、[トレース] タブをクリックして、[トレースの開始] ボタンをクリックします。[ログ ファイルのパス] フィールドでは、トレース・ファイルの名前と場所を指定します。 Note: 既定のログ・ファイル名は IRISODBC.log で、既定の場所は C:\Users\Public\Logs です。IRISODBCTRACEFILE 環境変数を設定することにより、これらの値を変更できます (この章で後述する “ODBC 環境変数” を参照してください)。 UNIX® の ODBC ログ UNIX® では、以下のように ODBC のログを有効にします。 クライアント・ドライバのログを有効にするには、IRISODBCTRACE 環境変数を使用します (後述する “ODBC 環境変数” の章を参照してください)。さらに ODBC 初期化ファイルも構成します。 ドライバ・マネージャのログを有効にするには、ODBC 初期化ファイルで Trace エントリを設定します (“ODBC データ・ソースとしての InterSystems データベースの使用法 (UNIX®)” の “ODBC 初期化ファイルの構造” を参照してください)。同ファイル内の TraceFile エントリは、作成するログ・ファイルの名前を指定します。 Tip: ログを有効にしてもログ・ファイルが更新されない場合は、ファイルに対する書き込み権限がないか、ログを有効にする前に SO にクライアント・アプリケーションがロードされていたかのいずれかです。後者の場合、クライアント・アプリケーションを停止して再起動し、SO の再ロードおよびログ・フラグの取得をアプリケーションに強制します。 ODBC 環境変数 このセクションでは、InterSystems ODBC クライアント・ドライバを制御する環境変数につて説明します。通常、これらの環境変数は、デバッグまたは各種診断を目的としてのみ使用します。 IRISODBCDEFTIMEOUT この変数により、ログインの既定のタイムアウトの有効時間を指定できます。この変数の単位は秒です。 IRISODBCPID このブーリアン変数により、ログ・ファイル名にプロセス ID 番号を自動的に付けるかどうかを制御します。番号を付ける場合は値を 1 に設定し、付けない場合は 0 に設定します。既定では、番号は付きません。IRISODBCPID が有効であり、ベースのログ・ファイルが IRISODBC.log で、現在使用しているディレクトリに属している場合、ID が 21933 のプロセスは、IRISODBC.log.21933 のログ・ファイルを生成します。IRISODBCPID と IRISODBCTRACEFILE は共にファイル名に影響します。例えば Windows で IRISODBCTRACEFILE を使用してログ・ファイルのベース・ファイル名を (C:/home/mylogs/mylog.txt などに) 設定して IRISODBCPID を有効にすると、ログ・ファイルの名前は C:/home/mylogs/mylog.txt.21965 のような形式になります。 IRISODBCTRACE (UNIX® のみ) このブーリアン変数は、クライアント・ドライバのロギングを制御します。クライアント・ドライバのロギングを有効にする場合は値を 1 に設定し、無効にする場合は 0 に設定します。詳細は、この章で前述した “UNIX® の ODBC ログ” を参照してください。 IRISODBCTRACEFILE この変数は、ログ・ファイルの位置と名前を指定します。これは、一意のディレクトリにログ・ファイルを置き、このファイルに一意の名前を与えるときに便利です。ログ・ファイルの既定名は IRISODBC.log です。既定の場所は、以下のとおりです。 UNIX® の場合、ログは既定で現在のディレクトリに生成されます。 Windows の場合、ログ・ファイルの既定の場所は %PUBLIC%\Logs です。このディレクトリにはすべてのユーザがアクセスでき、ログの作成場所を 1 か所に集約できるメリットがあります。 IRISODBCTRACETHREADS この変数はログにスレッド情報を含めるかどうかを制御します。スレッド情報を含める場合は値を 1 に設定し、含めない場合は 0 に設定します。スレッド化されたアプリケーションをデバッグする必要がある場合は、このような追加のロギングを有効にすると便利な場合があります。ただし、ほとんどの ODBC アプリケーションでは、多くの余分な行がログに追加されます。
