Agents › DevTest CICS エージェント › CICS エージェントの操作

CICS エージェントの操作

DevTest CICS エージェントおよび出口の起動

DevTest CICS エージェントおよび出口は、CICS 起動 PLT 処理中に起動されます。 エージェントおよび出口は、TKOI トランザクションを実行するか、またはモニタ トランザクション TKOM を使用して手動で起動することもできます。 TKOI トランザクションは出口をインストールし、エージェント トランザクション（TKOA）を起動します。

DevTest CICS エージェントおよび出口の停止

DevTest CICS エージェントおよび出口は、CICS シャットダウン PLT 処理中に停止されます。 エージェントおよび出口は、TKOR トランザクションを実行するか、またはモニタ トランザクション TKOM を使用して手動で停止することもできます。

まれな状況として、CICS エージェント トランザクション（TKOA）が終了に失敗する場合があります。 この状況であると考えられる場合は、CEMT I TAS コマンドを使用して、TKOA がまだ実行されているかどうかを確認します。 実行されている場合は、TKOA を終了するために、必要に応じて CEMT SET TAS(nnn) PURGE または CEMT SET TAS(nnn) FORCEPURGE コマンドを使用します。

仮想化された CICS LINK コマンドへの影響

まれなケースとして、CICS LINK の仮想化が失敗する場合があります。 この場合、CICS LINK は「無効な要求」（INVREQ）状態（EIBRCODE=x'E00000000000' および EIBRESP=16）でアプリケーションに戻ります。 この状況では通常、アプリケーションに INVREQ 状態の処理が実装されていない限り、トランザクションの異常終了が発生します。 EIBRESP2 を使用すると、仮想化の失敗の正確な原因を特定できます。

500 / x'1F4'

VSE から再生応答が受信されませんでした。 これは、ほとんどの場合、タイムアウトが原因です。 タイムアウト間隔は、10 秒に設定されています。 タイムアウト値を変更する必要がある場合は、テクニカル サポートに問い合わせてください。

501 / x'1F5'

DevTest CICS エージェントがダウンしています。 「CICS LINK の後」の出口が、DevTest CICS エージェントがダウンしていることを検出しました。 再生応答は返されません。

502 / x'1F6'

仮想化が失敗しました。 サービス仮想化から再生応答が受信され、CICS LINK COMMAREA または CHANNEL/CONTAINER の更新が失敗しました。 CICS コマンドの失敗メッセージについては、CICS ジョブのログを参照してください。

503 / x'1F7'

DevTest LPAR エージェントがシャットダウンされ、保留中の再生要求がすべてキャンセルされました。

仮想化された CICS DTP/MRO コマンドへの影響

まれなケースとして、CICS DTP/MRO コマンド（ALLOCATE、FREE、SEND、RECEIVE、CONVERSE、EXTRACT ATTRIBUTES）の仮想化が失敗する場合があります。 この場合、CICS コマンドは「無効な要求」（INVREQ）状態（EIBRCODE=x'E00000000000' および EIBRESP=500）でアプリケーションに戻ります。 この状況では通常、アプリケーションに INVREQ 状態の処理が組み込まれていない限り、トランザクションの異常終了が発生します。 EIBRESP2 を使用すると、仮想化の失敗の正確な原因を特定できます。

501 / x'1F5'

DevTest CICS エージェントがダウンしています。 「CICS LINK の後」の出口が、DevTest CICS エージェントがダウンしていることを検出しました。 再生応答は返されません。

502 / x'1F6'

サービス仮想化から応答が受信されませんでした。

503 / x'1F7'

サービス仮想化から無効な応答が受信されました。 CICS コマンドの失敗メッセージについては、CICS ジョブのログを参照してください。

504 / x'1F8'

セッション テーブルがいっぱいでした。

505 / x’1F9’

再生キューへの再生要求の追加に失敗しました。

506 / x’1FA’

サービス仮想化から応答が受信される前に、XEIIN WAIT タイムアウトが期限切れになりました。

507 / x’1FB’

要求または応答の GETMAIN が失敗しました。

モニタ トランザクション（TKOM）

モニタ トランザクション（TKOM）を使用すると、以下のことが可能です。

• エージェントおよび出口のステータスの確認
• グローバル作業領域（GWA）の 16 進数での表示
• 整形またはデコードされた GWA フィールドの一部の表示
• レコーディング数および再生数の確認
• プログラム テーブル数の確認
• プログラム テーブルの表示
• エージェントの起動および停止
• 出口の起動および停止
• 以下の 3 つの主なキューの現在の深度（数）とウォータマークの上限（最大）の確認

  レコーディング キュー（RecQ）

  • 記録されたイメージのキューを定義します。

  再生キュー（PlbQ）

  • DevTest LPAR エージェントに送信される再生イメージのキューを定義します。

  LPAR エージェント キュー（LPAQ）

  • DevTest LPAR エージェントからの応答を待機している再生イメージのキューを定義します。
• エージェント トランザクションのタスク番号の確認

モニタ トランザクションは、以下のように表示されます。