Session_Trace 要求は、ttsession がそれ自身を処理するために登録する ToolTalk 要求です。つまり、ttsession は Session_Trace 要求のハンドラです。この要求は、どの ToolTalk クライアントでも送信できます。お勧めできる方法ではありませんが、この要求を処理するために他の ToolTalk クライアントを登録できます。
この方法ではトレースは行われません。
この要求の構文は次のとおりです
[file] Session_Trace( in boolean on, in boolean follow [in attribute toPrint |in state toTrace |in op toTrace |in handler_ptype toTrace |in sender_ptype toTrace][...] );
Session_Trace 要求は、配信範囲指定されたセッションでのメッセージ・トレースをオンまたはオフにします。
トレースがオンで、要求のファイル属性が設定されている場合、後続のトレース出力は属性が名前を付けたファイルに付け加えられます。
トレースがオンで、ファイル属性が設定されていない場合、トレースは現在のトレースを続行します。
デフォルトの場合、デーモン・モードでは ttsession を実行中のホストのコンソールが出力先になります。ジョブ・コントロール・モードでは、ttsession の標準エラーが出力先になります。表 4-1 は、この要求の必須およびオプションの引き数を示しています。
表 4-1 Session_Trace 引き数
現在のセッション・トレースの動作は、この要求が失敗しない場合にのみ変更されます。失敗した場合には、応答の tt_message_status は表 4-2 で説明されているエラーの 1 つに設定されます。
表 4-2 Session_Trace 要求が返すエラー・メッセージ
エラー |
説明 |
---|---|
要求に対するハンドラを見つけることができません。 |
|
ttsession がトレース・ファイルを開くまたは作成するためのアクセス権を持っていません。 |
|
トレース・ファイルがディレクトリです。 |
|
ターゲット・ファイル・システムにトレース・ファイルの作成に十分なスペースがありません。 |
|
トレースがすでに別のファイルで行われています。ttsession は、応答のファイル属性を再設定して既存のトレース・ファイルの名前を付けます。別のファイルへのトレースを行うには、最初に現在のトレース・ファイルへのトレースをオフにします。 |