PM46717: HTTP CHANNEL ACCESS LOG CAN NOT BE CUSTOMIZED

8.0.0.2: WebSphere Application Server V8.0 Fix Pack 2
8.0.0.3: WebSphere Application Server V8.0 Fix Pack 3
8.0.0.4: WebSphere Application Server V8.0 Fix Pack 4
8.0.0.5: WebSphere Application Server V8.0 Fix Pack 5
8.0.0.6: WebSphere Application Server V8.0 Fix Pack 6
8.0.0.7: WebSphere Application Server V8.0 Fix Pack 7
8.0.0.8: WebSphere Application Server V8.0 Fix Pack 8
8.0.0.9: WebSphere Application Server V8.0 Fix Pack 9
8.0.0.10: WebSphere Application Server V8.0 Fix Pack 10
8.0.0.11: WebSphere Application Server V8.0 Fix Pack 11
8.0.0.12: WebSphere Application Server V8.0 Fix Pack 12
8.0.0.13: WebSphere Application Server V8.0 Fix Pack 13
8.0.0.14: WebSphere Application Server V8.0 Fix Pack 14
8.0.0.15: WebSphere Application Server V8.0 Fix Pack 15

APAR status

• Closed as program error.

Error description

• The HTTP Channel access log can not be customized and lacks
  key information.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:  IBM WebSphere Application Server Version    *
  *                  8.0 users utilizing the HTTP Channel        *
  *                  Center for Supercomputing Applications      *
  *                  (NCSA) access log                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: The format within the HTTP Channel      *
  *                      NCSA access logs can not be customized  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The HTTP Channel NCSA access log only has two options for
  customization, COMMON and COMBINED. These options lack key
  information and customization.
  

Problem conclusion

• To customize HTTP NCSA access logging, utilize the new
  functionality of the HTTP channel custom property
  "accessLogFormat". It will now accept a space separated list
  of directives. Each individual directive can have quotes
  around it. Any directive, unless otherwise noted, will use the
  value of "-" if no value is found. The list of directives
  available:
  * %a
  ** Remote IP Address
  * %A
  ** Local IP Address
  * %b
  ** Response size in bytes excluding headers
  * %B
  ** Response size in bytes excluding headers
  ** Will print 0 instead of - if no value is found
  * %C
  ** %{CookieName}C
  ** Prints the request cookie within the brackets or if the
  brackets are missing print them all
  * %D
  ** The elapsed time of the request. Millisecond accuracy,
  microsecond precision
  * %h
  ** Remote Host
  * %i
  ** %{HeaderName}i
  ** HeaderName header value from the request
  * %m
  ** Request Method
  * %o
  ** %{HeaderName}o
  ** HeaderName header value from the response
  * %q
  ** Output the query string with any password escaped
  * %r
  ** First line of the request
  * %s
  ** Status code of the response
  * %t
  ** NCSA format of the start time of the request
  * %{t}W
  ** Prints the current time when the message to the access log
  is queued to be logged in our NCSA format
  * %u
  ** Remote user according to the WebSphere Specific $WSRU header
  * %U
  ** URL Path, not including the query string
  
  To enable this new functionality please add the
  "accessLogFormat" custom property to the HTTP Channel, the
  panel on the administrative console can be found here:
  
  Application Servers > {Server Name} > Web Container Transport
  Chains > {Chain Name} > {HTTP Channel Name} > Custom Properties
  
  Also, please ensure the "Use chain-specific logging" option is
  enabled on the HTTP Channel where the previously mentioned
  property is enabled.
  
  The fix for this APAR is currently targeted for inclusion in
  fix pack 8.0.0.2.  Please refer to the Recommended Updates
  page for delivery information:
  http://www.ibm.com/support/docview.wss?rs=180&uid=swg27004980
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  WEBSPHERE APP S

• Fixed component ID

  5724J0800

Applicable component levels

• R800 PSY

     UP