5.15.1 IBM 3270 または 5250 セッションのトレースの実行

IBM 3270 または 5250 セッションの問題を解決中に、技術サポートが 1 つまたは複数のトレースの取得を要求する場合があります。ホストデータ、コマンド、および HLLAPI の 3 種類のトレースが可能です。

トレースファイルの種類	説明
ホストデータトレース (*.hst)	端末、プリンタ、セッション、およびホスト間で渡された情報をキャプチャします。この種類のトレースは、ホスト接続が作動中だが、端末またはプリンタセッションが要求どおりに動作しない場合に便利です。ホストトレースは、ホストへの接続が確立できない場合は役に立ちません。
コマンドトレース (*.cmd)	Reflection 内のアクションをキャプチャします。ボタンのクリックやテキストの入力などの各アクションが、個別のコマンドを表します。コマンドトレースは、OLE オートメーションを使用するスクリプト、マクロ、またはプログラムで、コマンドが正しいかどうかを判断する場合に便利です。コマンドトレースは、スクリプトを記述する時に、使用するコマンドを決定するのにも使用できます。テキストエディタを使用して、コマンドトレースを表示し、タスクの実行に必要なコマンドを決定します。
HLLAPI トレース	HLLAPI がアプリケーションを呼び出し、コードを返すところを含めて確認することができます。(HLLAPI は端末タスクを自動化するために IBM より指定される API です。)

トレースファイルの種類

説明

ホストデータトレース (*.hst)

端末、プリンタ、セッション、およびホスト間で渡された情報をキャプチャします。この種類のトレースは、ホスト接続が作動中だが、端末またはプリンタセッションが要求どおりに動作しない場合に便利です。ホストトレースは、ホストへの接続が確立できない場合は役に立ちません。

コマンドトレース (*.cmd)

Reflection 内のアクションをキャプチャします。ボタンのクリックやテキストの入力などの各アクションが、個別のコマンドを表します。コマンドトレースは、OLE オートメーションを使用するスクリプト、マクロ、またはプログラムで、コマンドが正しいかどうかを判断する場合に便利です。

コマンドトレースは、スクリプトを記述する時に、使用するコマンドを決定するのにも使用できます。テキストエディタを使用して、コマンドトレースを表示し、タスクの実行に必要なコマンドを決定します。

HLLAPI トレース

HLLAPI がアプリケーションを呼び出し、コードを返すところを含めて確認することができます。(HLLAPI は端末タスクを自動化するために IBM より指定される API です。)

ホストデータトレースまたはコマンドトレースを生成するには

セッションを開くか、新しいセッションを作成します。

[トレースの開始] ダイアログボックスを開きます。

手順は、ユーザインタフェースモードによって異なります。

ユーザインタフェースモード	手順
Reflection リボン	[ツール] > リボンの [トレース] グループから [トレースの開始] をクリックします。
Reflection ブラウザ	[Reflection] メニューから、[ツール] - [トレース] - [トレースの開始] を選択します。
TouchUx	レンチのアイコンをタップし、[トレース] から [トレースの開始] を選択します。

[トレースの開始] ダイアログボックスで、トレースするファイルの名前を指定します。サポートの技術者に問い合わせたことがある場合は、サービス要求番号をトレースファイルの名前として使用します。

トレースの種類

使用する拡張子

ホストデータ

.HST

コマンド

.CMD
[保存] をクリックします。

[トレースを開始しました...] と Reflection のステータスバーに表示されて、トレースがアクティブであることを示します。
問題となる操作を再現し、実行トレースに記録します。

トレースの種類	使用する拡張子
ホストデータ	.HST
コマンド	.CMD

トレースを終了します。

手順は、ユーザインタフェースモードによって異なります。

ユーザインタフェースモード	手順
Reflection リボン	[ツール] リボンの [トレース] グループから [トレースの終了] をクリックします。
Reflection ブラウザ	[Reflection] メニューから、[ツール] - [トレース] - [トレースの終了] を選択します。
TouchUx	[Reflection] メニューから、レンチのアイコンをタップし、[トレース] から [トレースの終了] を選択します。

トレースファイルをバイナリファイルとして http://upload.attachmate.com にアップロードしてください。現時点で技術者に問い合わせているサービスリクエストに関連する問題の場合は、トレースと一緒に Micro Focus サービスリクエスト番号を通知して、技術者にファイルをアップロードしたことを伝えてください。

HLLAPI トレースを生成するには

Windows の　[スタート] ボタンをクリックします。
[検索の開始] ボックスに「win.ini」と入力して [Enter] を押し、メモ帳で Win.ini ファイルを開きます。
以下の 2 行を Win.ini ファイルの最後に追加します。
```
[Reflection HLLAPI]
ExtTraceOn=1
```
Reflection のワークスペースで、セッションを開くか新しいセッションを作成して IBM ホストに接続します。
HLLAPI アプリケーションを開始します。
問題となる操作を再現し、実行トレースに記録します。
HLLAPI アプリケーションを終了します。

トレースファイルには、自動的に HLL*.TMP という名前が付けられます。* はランダムに生成された 16 進数です。TEMP ディレクトリがシステム環境設定で定義されている場合、ファイルは PC の TEMP ディレクトリに保存されます。それ以外の場合は、Windows のルートディレクトリに保存されます。
Win.ini ファイルを再度開き、ini ファイルの最終行を変更して ExtTraceOn 設定をゼロに変更します。
```
ExtTraceOn=0
```
トレースファイルをバイナリファイルとして http://upload.attachmate.com にアップロードしてください。現時点で技術者に問い合わせているサービスリクエストに関連する問題の場合は、トレースと一緒に Micro Focus サービスリクエスト番号を通知して、技術者にファイルをアップロードしたことを伝えてください。