z/OS®「要求記載」特性 zosRequestLogging-1.0 會收集 HTTP 要求的相關資訊,並將資訊記錄到 z/OS SMF 資料儲存庫。
當 z/OS「要求記載」特性已啟動,且 RACF® 正確設定時,便會產生 SMF 類型 120 子類型 11 第 2 版記錄。
對於非同步建立的局部要求,不會擷取資料。
程序
- 在 server.xml 配置檔的 featureManager 元素中,新增 zosRequestLogging-1.0 特性來啟用要求記載。
<feature>zosRequestLogging-1.0</feature>
- 發出下列指令,配置 RACF 寫入 SMF 記錄:
RDEFINE FACILITY BPX.SMF UACC(NONE)
PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)
SETROPTS GENERIC(FACILITY) REFRESH
SETROPTS RACLIST(FACILITY) REFRESH
- 選擇性的: 在 Servlet 中實作 UserData API,將使用者新增至 SMF 記錄。
Servlet 可以使用 UserData
add 方法,將其本身的要求特定資料新增至 SMF 120 子類型 11 第 2 版記錄(針對 HTTP 要求而寫入)。
UserData 介面在 com.ibm.websphere.zos.request.logging 套件中。
下列範例顯示 Servlet 如何將其本身的要求特定資料,新增至 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) {
}