z/OS での 自由 の要求ロギングの有効化

z/OS® 要求ロギング・フィーチャー zosRequestLogging-1.0は、HTTP 要求に関する情報を収集し、その情報を z/OS SMF データ・ストアに記録します。 z/OS 要求ロギング機能がアクティブ化され、 RACF® が正しくセットアップされている場合、SMF タイプ 120 サブタイプ 11 バージョン 2 およびバージョン 3 レコードが生成されます。 要求の部分が非同期に作成される場合、それらの部分についてのデータは収集されません。

1. server.xml 構成ファイルの featureManager エレメントに zosRequestLogging-1.0 フィーチャーを追加して、要求ロギングを有効にします。

   <feature>zosRequestLogging-1.0</feature>

2. 以下のコマンドを発行して、SMF レコードを書き込むように RACF を構成します。

   RDEFINE FACILITY BPX.SMF UACC(NONE)                      
   PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)  
   SETROPTS GENERIC(FACILITY) REFRESH                       
   SETROPTS RACLIST(FACILITY) REFRESH 

3. オプション: サーブレットで UserData API を呼び出すことにより、SMF レコードにユーザー・データを追加します。

   サーブレットは、UserData add メソッドを使用して、HTTP 要求について書き込まれる SMF 120、サブタイプ 11、バージョン 2 および バージョン 3 レコードに、サーブレット自体の要求固有データを追加できます。 UserData インターフェースは、 com.ibm.websphere.zos.request.logging パッケージに含まれています。

   次の例は、サーブレットがそれ自体の要求固有データを SMF レコードに追加する方法を示します。

   InitialContext ic = new InitialContext();
       try {
               UserData userData = (UserData) ic.lookup("com/ibm/websphere/zos/request/logging/UserData");
               int rc = userData.add(65535,"My request-specific data");
       } catch (NamingException e) {
   }