デバッグ・プロファイル・サービス API のサポートの追加

デバッグ プロファイル サービス API は、 CICS と非 CICS 環境間のデバッグ プロファイルを管理するために z/OS® 上で実行される REST API です。

デバッグプロファイルの管理

デバッグ・プロファイル・サービス API は、環境が CICS か非 CICS かによって、デバッグ・プロファイルの扱い方が異なります。

CICS 環境

CICS環境では、デバッグ・プロファイルはCICSリージョンが所有するリポジトリに格納されます。 このリポジトリはどちらでもよい：

  • CICS一時記憶キュー（TSQ）、または
  • DD:EQADPFMB に割り当てられた VSAM データセット。

Debug Profile Service API を CICS で使用するには、対象の CICS 地域とどのように相互作用するかを決定する必要があります。 2つの統合オプションがある：

  1. CICS TCPIPサービス
    このオプションでは、 CICS リージョンごとに DTCN API インスタンスをインストールする必要がある。 DTCN APIは、 CICS DTCN Repository Managerと相互作用してデバッグ・プロファイルを管理するRESTサービスです。 これを有効にするには、 CICS システムプログラマーがTCPIPSERVICEとURIMAPの定義を定義してインストールし、 z/OS デバッガープログラムライブラリ （デフォルト EQAW.SEQAMOD ）が CICS コンカチネーションに含まれていることを確認する必要があります。 各地域は、固有のTCP/IPポート番号で構成された独自のDTCN APIインスタンスを必要とする。 CICS セットアップが完了すると、DTCN API TCP/IP ポート番号を使用して対応する CICS 領域を識別することにより、 CICS デバッグ プロファイルを管理するようにデバッグ プロファイル サービス API を構成できます。
  2. CICS エキシ
    このオプションでは、 デバッグ・プロファイル・サービス APIがEXCIインターフェイスを使用して、 CICS 各リージョン内で実行される CICS DTCN Repository Managerであるかのようにデバッグ・プロファイルを管理するように構成できる。 CICS システム・プログラマーは、CONNECTIONとSESSIONSの定義を定義してインストールし、 z/OS デバッガー・プログラム・ライブラリ （デフォルト EQAW.SEQAMOD ）が CICS の連結に含まれていることを確認する必要があります。 各リージョンは同じEXCI定義を必要とするが、 CICS システム初期化（SIT）パラメータで指定された固有のAPPLIDを必要とする。 CICS のセットアップが完了すると、 Debug Profile Service API は、APPLID を使用して対応する CICS 地域を特定することで、デバッグ・プロファイルを管理するように設定できる。

どちらの構成でも、 デバッグ プロファイル サービス API は、ターゲット CICS 領域を識別して通信するために、デバッグ プロファイル サービス CICS DTCN 構成ファイルである dtcn.ports という構成ファイルに依存します。 このファイルには、 CICS リージョン名と対応するポート番号のリストが含まれており、ルックアップテーブルの 役割を果たす。

外部コンポーネントを構成するには、 「 CICS TCPIPSERVICE リソースの定義 」または 「 CICS EXCI CONNECTION および SESSIONS リソースの定義 」を参照してください。

Debug Profile Service API がデバッグプロファイルを管理するための単一のエントリポイントとして設定されると、選択したユーザーにプロファイル管理 UI を使用して他のユーザーに代わってプロファイルを管理する権限を付与できます。 例えば、古くなったデバッグ・プロファイルを整理したり、ユーザーフレンドリーなインターフェイスで他のユーザーのプロファイルを確認したりすることができる。

ユーザーにプロファイル管理UIへのアクセスを許可するには、 DTCNプロファイルの作成、変更、または削除を許可するユーザーを定義するを参照してください。 プロファイル管理 UI の操作方法については、 「 z/OS Debugger Profile Management でプロファイルを管理する 」を参照してください。

API ドキュメントについては、内部の Swagger UI URL を介して DTCN Profile ( CICS ) API を使用し、セットアップを確認してください。 詳細については、 デバッグ・プロファイル・サービスの診断を参照してください。

CICS 環境

CICS 以外の場合、デバッグ・プロファイルはEQAUOPTSデータセットに保存される。 Debug Profile Service API は、 eqaprof.env 設定ファイルで定義されたパターンに基づいて、データセットを直接操作（作成、削除、読み取り）します。

API ドキュメントについては、内部の Swagger UI URL を介して DTSP Profile (non- CICS ) API を使用し、セットアップを確認してください。 詳細については、 デバッグ・プロファイル・サービスの診断を参照してください。