Recording information about requests and responses

Use System Management Facilities (SMF) to record request and response information for IBM HTTP Server.


About this task

We can enable the recording of SMF type 103 subtype 14 records for IBM HTTP Server after you load the appropriate modules, set the appropriate directives, and update the SMFPRMxx parmlib member.
Table 1. SMF record 103.14 format
Field ID Description Length Notes
PID Integer. Process ID. 4  
METHOD_LENGTH Integer. Length of the HTTP request method. 4  
DOMAIN_LENGTH Integer. Length of the HTTP host header. 4  
URL_LENGTH Integer. Length of the HTTP request URL. 4  
RIP_LENGTH Integer. Length of the client IP address. 4  
CPU_TIME String. Accumulated CPU time in seconds. 8  
ELAPSED_TIME Integer. Long. Elapsed request time in milliseconds. 8  
METHOD String. HTTP request method. $METHOD_LENGTH  
DOMAIN String. HTTP request domain. $DOMAIN_LENGTH  
URL String. HTTP request URL. $URL_LENGTH  
CLIENTIP String. Remote client IP address. $RIP_LENGTH  
VERSION Integer. Version of the SMF record. 4  
JOBNAME String. Not null terminated. Process job name. 8 Added in version 2.
JOBID String. Not null terminated. Process job ID or started task (STC) ID. 8 Added in version 2.
ASID String. Not null terminated. 2 Added in version 3.


Procedure

  1. Identify the user ID where the IBM HTTP Server runs. Grant read authority to the BPX.SMF facility of the appropriate user ID.

  2. Verify that the mod_smf module is loaded into the server.

  3. Add the SMFRecord ON value to one or more configuration sections.

    The example configuration shows how to turn on SMF recording for requests only to the /example/* location.

    <Location "/example/">
      SMFRecord ON
    </Location>

  4. Enable the recording of SMF type 103 subtype 14 records by editing the SMFPRMxx parmlib member.