このセクションでは、SAP JCo ライブラリを使用して SAP システムと通信する Java アプリケーションのビジネストランザクション相関を有効にする方法について説明します。

• サポートされる JCo バージョン：SAPJCo2、SAPJco3
• サポートされる SAP Java リソースアダプタ（JRA）
• Java エージェントの最小バージョン：4.3.8.x
• Java エージェントバージョン 4.5.5 〜 4.5.8 との互換性に関する既知の問題、4.5.9 で修正済み
• Java エージェントバージョン 4.5.18 以降との互換性に関する既知の問題、JCo 拡張 20.5.0 以降で修正済み

JCo インストルメンテーション アーキテクチャ

現在のバージョンでは、JCo RFC コールのインストルメンテーションは Java エージェント拡張（SDK プラグイン）によって行われます。

次の図は、JCo インストルメンテーションのアーキテクチャの概要を示しています。

• Java アプリケーションは、SAP JCo ライブラリを使用して SAP NetWeaver システムの RFC 対応関数モジュールを呼び出します。
• Java エージェントは、JCo 拡張を使用して RFC exit コールを代行受信します。
• JCo 拡張は、ビジネストランザクションの続行を開始および停止できる相関情報を ABAP エージェントに送信します。

Java エージェントと JCo 拡張のインストール

Java エージェントのインストールの一般的な手順を使用し、次の手順に進み、Java から SAP システムへの RFC コールを確認します。

1. 「Install the Java Agent」に記載されている標準のインストール手順に従って、SAP コンポーネント内に Java エージェントをインストールします。
2. 次の ABAP エージェント zip ファイルを解凍します。APPD-SAP-<version>.zip.
3. APPD-SAP-< version>/AppServerAgent-JCo-plugin-<version>/ ディレクトリの内容を、[JavaAgentPath]/ver[JavaAgentVersion]/sdk-plugins/ ディレクトリにコピーします。
4. allow.unsigned.sdk.extension.jars=true パラメータを使用して、Java 起動スクリプトで署名なしの拡張を有効にします。

SAP アプリケーションサーバーを使用している場合は、次のツールを使用して Java エージェントをランタイムに追加することもできます。

1. SAP NetWeaver Administrator
2. AS Java Config Tool

SAP NetWeaver Administrator を使用した Java エージェントの設定 ：

1. SAP NetWeaver Application Server Java Web ポータルを開きます。
2. [SAP NetWeaver Administrator] > [設定（Configuration）] > [インフラストラクチャ（Infrastructure）] > [Javaシステムプロパティ（Java System Properties）] > [追加の VM パラメータ（Additional VM Parameters）]をクリックします。
   1. 署名されていない SDK 拡張機能の VM パラメータ -Dallow.unsigned.sdk.extension.jars=true を追加します。
   2. VM パラメータ -Dappdynamics.bciengine.should.implement.new.interfaces=false を追加します。
   3. Javaエージェント javaagent の VM パラメータを追加します。 <agent_home> /javaagent.jar 。
   4. [Save] をクリックします。
3. SAP サーバーを再起動します。

AS Java Config Tool を使用した Java エージェントの構成 ：

1. SAP NetWeaver Application Server Java Web ポータルを開きます。
2. AS Java Config Tool でインスタンスを選択し、[VM Parameters >> Additional] をクリックします。
   1. 署名されていない SDK 拡張機能の VM パラメータ -Dallow.unsigned.sdk.extension.jars=true を追加します。
   2. VM パラメータ -Dappdynamics.bciengine.should.implement.new.interfaces=false を追加します。
   3. Javaエージェント javaagent の VM パラメータを追加します。 <agent_home> /javaagent.jar 。
   4. [File]、[Apply Changes] の順にクリックします。
3. SAP サーバーを再起動します。

デバッグモードでのロギング

1. コントローラーに接続し、 [Tiers & Nodes]に移動します。
2. デバッグモードを有効にする必要がある目的の Java ノードを選択します。
3. [Agents] を選択し、[Request Agent Log File] をクリックします。
4. [Output from Specific logger, at a set level, for a fixed duration] を選択します。
   1. [Logger Name]：com.singularity
   2. [Logger Level]：Debug
   3. [Duration (minutes)]：10 以上
5. [Request Agent Log Files] をクリックします。
6. ステータスが成功になったら、[Download] をクリックします。

オーソリゼーション

次の SAP ユーザーに承認権限 /DVD/APPD_JAVA を割り当てる必要があります。

• Java から RFC を呼び出す SAP ユーザー
• RFC 宛先で使用される SAP ユーザー

詳細については、「Cisco AppDynamics Authorizations」を参照してください。

JCo Server でのビジネストランザクションの開始

JCo Server コール中にビジネストランザクションを開始するには、次の Java エージェント POJO ルールを設定します。

JCo Server でのビジネストランザクションの続行

JCo Server でアップストリーム ビジネス トランザクションから続行できるようにするには、JCo Server を呼び出すシステムで ABAP コードを変更する必要があります。「カスタム ABAP コードのインストゥルメント化」を参照してください。

SAP PI / PO（7.4）AS Java

次の表に、サポートされている SAP PI / PO 7.4 のJava チャネルを示します。

発信 SAP PI exit コールを表示するには、Java エージェント自動検出または POJO ルールを使用して、SAP PI 着信チャネルで BT を開始または続行する必要があります。