La fonction de journalisation des demandes (Request Logging)
z/OS,
zosRequestLogging-1.0, collecte des informations
sur les demandes HTTP et les enregistre dans le
magasin de données SMF
de z/OS. Lorsque la fonction z/OS Request Logging est activée et que RACF est configuré correctement,
des enregistrements SMF type 120, sous-type 11, version 2
sont générés. Aucune donnée n'est capturée pour les parties de la demande qui sont créées de manière asynchrone.
Procédure
- Activez la journalisation des demandes en ajoutant la fonction zosRequestLogging-1.0 à
l'élément featureManager du fichier de configuration
server.xml.
<feature>zosRequestLogging-1.0</feature>
- Configurez RACF pour qu'il écrive
les enregistrements SMF en émettant les commandes suivantes :
RDEFINE FACILITY BPX.SMF UACC(NONE)
PERMIT BPX.SMF ID(MSTONE1) ACCESS(READ) CLASS(FACILITY)
SETROPTS GENERIC(FACILITY) REFRESH
SETROPTS RACLIST(FACILITY) REFRESH
- Facultatif : Ajoutez des données utilisateur aux enregistrements SMF en implémentant l'API UserData dans
vos servlets.
Un servlet peut utiliser la méthode add de
UserData pour ajouter des données spécifiques à sa propre demande
à l'enregistrement SMF 120, sous-type 11, version
2 qui est écrit pour la demande HTTP. L'interface UserData est dans le package
com.ibm.websphere.zos.request.logging.
L'exemple suivant montre comment un servlet peut ajouter des données spécifiques à sa demande
dans l'enregistrement 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) {
}