SAP アプリケーションのコネクター・ログには、Create または Update 操作などの、コネクターに関連するすべてのイベントおよびエラーや、あるいはイベント・キューに到着したイベントが、発生日時の新しいものから順に表示されます。ログ・ファイルの各ログ・エントリーには、日付、時刻、およびイベントがリストされます。ログ・ファイルは、問題のトラブルシューティングをはじめるための、良い手掛かりになります。
グローバル設定およびユーザー設定は、表示するエントリーの数およびデータのタイプや、コネクター・ログ・ファイルに記録する詳細レベルに応じて設定できます。IBM WebSphere BI Station を使用してコネクターのロギング・レベルを設定するには、「Configuration」タブをクリックし、「Logging Level」から 0 から 3 のレベルを選択します。
ロギングには、次の 4 つのレベルがあります。
最近に処理したオブジェクトと、それに関連する詳細を表示するには、コネクター・ログを表示します。SAP アプリケーションでコネクター・ログを表示するには、以下の手順を行います。
ログ・エントリーには、日付、時刻、およびイベントが表示されます。各エントリーは、次のように色分けされています。
緑 -- 正常なイベントを示します。
黄 -- 警告メッセージを示します。
赤 -- エラーを示します。
白 -- アーカイブされたオブジェクトを示します。
マジェンタ (SAP アプリケーション GUI バージョン 4.6 以前) またはオレンジ (SAP アプリケーション GUI バージョン 4.6 以降) で表示されたエントリーでは、イベントの開始および終了に関する情報が提供されます。任意の矢印をクリックすると、そのビジネス・オブジェクトに関する SAP の表示トランザクションにリンクします。
各イベントについて表示される詳細の量を変更できます。表示レベルを変更するには、必要な詳細のレベルに応じて、「More Details」または「Fewer Details」ボタンをクリックします。
表示されるデータの量が現在必要としている量よりも多い場合は、表示される情報を制限します。例えば、ビジネス・オブジェクトをユーザー、名前、日付、またはログ・エントリー番号で表示できます。
「Configuration」タブで、一度に表示されるログ・エントリーの数、およびデフォルトのロギング表示レベルについて、ユーザー設定を設定できます。
失敗した、あるいはアーカイブされたオブジェクトを、コネクター・ログ・ファイルから再処理できます。失敗したオブジェクトとは、正常に処理できなかった SAP 内のオブジェクトのことです。アーカイブされたオブジェクトとは、処理されずにアーカイブされるように構成したオブジェクトのことです。どちらの場合にも、コードの特定の位置にブレークポイントを設定することで、オブジェクトを手動で段階ごとにたどっていくことができます。Dynamic Transaction および IDoc オブジェクトについては、トランザクションの画面を段階ごとにたどることができます。
ブレークポイントは、以下の位置の直前に設定できます。
ブレークポイントの配置は、オブジェクトのタイプによって異なります。
Dynamic Transaction および IDoc オブジェクトでは呼び出しトランザクションが使用されるため、これらのオブジェクトに対する画面処理を表示できます。表示には、以下のオプションがあります。
Dynamic Retrieve および BAPI オブジェクトでは、画面処理は使用されません。
デフォルトでは、いずれのアーカイブ・オプション (A、X、または N) も 動詞のアプリケーション固有情報内に指定されていない ABAP Extension Module ビジネス・オブジェクトは、障害時にアーカイブされます。つまり、処理によって 0 または 21 以外の戻りコードが発生した場合、ビジネス・オブジェクトは、/cwld/obj_arc_h 表および /cwld/obj_arc_i 表にアーカイブされます。
アーカイブ動作を変更する場合は、ビジネス・オブジェクトの動詞レベルで行います。つまり、各ビジネス・オブジェクトについて、アーカイブ活動は動詞によって変化します。オブジェクトがアーカイブされる方法を指定するには、動詞のアプリケーション固有情報内で、以下の構文を使用します。
AppSpecificInfo = connectormodule.class, ArchiveParameter: ABAPhandler
ArchiveParameter の説明を以下に示します。
一度に複数のパラメーターを指定できます。A および X アーカイブ・パラメーターを指定すると、IBM WebSphere BI Station 内の再処理ツールへのリンクの付いたエントリーがログ表に追加されます。アーカイブされたオブジェクトの状況は、アーカイブされたビジネス・オブジェクトのエントリーの下の行に入力されます。
次に示す例では、Dynamic Transaction オブジェクトをアーカイブし、ログ表にエントリーを追加します。
AppSpecificInfo = sap.sapextensionmodule.VSapBOHandler, A:/CWLD/DYNAMIC_RETRIEVE
次に示す例では、IDoc オブジェクトの SAP4_Order Create を SAP アプリケーションに入った時点でアーカイブし、次にそのオブジェクトの処理を停止します。
AppSpecificInfo = sap.sapextensionmodule.VSapBOHandler, X:/CWLD/ORDER:ORDER_C1
Reprocessing Tool では、ABAP Debugger を使用して、SAP の WebSphere ビジネス・オブジェクトを再処理することができます。
アーカイブされたオブジェクトを再処理するには、以下の手順を行います。
「CW reprocess objects from archive tables」ウィンドウが表示されます。その「Archived Object Number」フィールドには、オブジェクト番号が取り込まれます。
ABAP Debugger が、アーカイブされたオブジェクトとともに呼び出されます。
IBM WebSphere BI Station の Reprocessing Tool に手動でアクセスするには、「ツール」タブで「Reprocess Object」をクリックします。表示されたフィールドに、適切な値を入力します。
アーカイブされたオブジェクトを、SAP アプリケーションからアダプター提供の Delete Archive Objects ツールを使用して削除することができます。このツールでは、アーカイブされたオブジェクトを手動で削除できます。アーカイブされたオブジェクトを削除すると、コネクター・ログにあるそのオブジェクトのエントリーは、新しい状況で更新されます。オブジェクトは物理的に削除され、オブジェクトの状況だけが参照のために保持されます。
IBM WebSphere BI Station (トランザクション /n/CWLD/HOME) を使用して、アーカイブされたオブジェクトを削除するには、以下の操作を実行します。
オブジェクトを自動的に削除するようにアーカイブ・オブジェクト・プログラムをスケジュールするには、BASIS 管理者に連絡し、レポート /CWLD/DELETE_OBJECT_ARCHIVE をスケジュールします。 このレポートは、バックグラウンド・プロセスとして実行するようにスケジュールすることができます。
SAP はコネクターのアクティビティーのイベント・ログを保持しています。このログは、時間の経過とともに、多くのディスク・スペースを占有するようになる可能性があります。ディスク・スペースを節約するために、このログを自動的に切り捨てるように設定できます。 自動切り捨てを設定すると、デフォルトでは、SAP は切り捨てられたエント リーを、このジョブをセットアップしたユーザーのデフォルト・プリンターに 出力するため、印刷オプションを制御する必要が生じる場合があります。
ログを手動で切り捨てるには、以下の手順を行います。
イベント・ログの自動切り捨てをスケジュールするには、切り捨てオプションをセットアップし、BASIS 管理者に連絡してレポート /CWLD/DELETE_LOG をスケジュールします。