2.3.112 QOSCookieName

Description

QOSCookieName specifies the name of the cookie used by the flow control functionality.

Note that the mod_hws_qos module must be built-in to use the flow control functionality.

LoadModule hws_qos modules/mod_hws_qos.so

Syntax

QOSCookieName cookie_name [{hws|user}]

Specifiable values

cookie_name

Specifies the name of the cookie used by the flow control functionality. You cannot use semicolons, commas, or spaces for cookie_name.

When you manage sessions by using different cookies between hosts and between URLs, you need to specify different cookie names.

hws

Sessions are managed by using the cookie that is created by the web server. This is called HWS creation mode.

user

Sessions are managed by using the cookies that are created by external modules other than the web server. This is called user creation mode.

Notes

• When the QOSCookieName directive is specified for a specific block, the higher-order QOSCookieName directives are not inherited.

  Example:

  QOSCookieName Cookie1 hws
  <Location /loc1>
      QOSCookieName Cookie2 user
  </Location>

  In this case, in the request beginning with /loc1, the specification of the cookie name Cookie2 is enabled. In a request beginning with something other than /loc1, the specification of the cookie name Cookie1 is enabled.

• When you specify multiple QOSCookieName directives, do not duplicate a cookie name. If a cookie name is duplicated, a start error occurs.

  Example:

  QOSCookieName Cookie1 hws
  QOSCookieName Cookie1 user

  In this case, a start error occurs because the cookie name is duplicated.

• When you specify multiple QOSCookieName directives in HWS creation mode, the directive specified later is enabled.

  Example:

  QOSCookieName Cookie1 hws
  QOSCookieName Cookie2 hws

  In this case, the specification of the cookie name Cookie1 is disabled, and the specification of Cookie2 is enabled.

Default value

If the definition item is omitted:

hws

Locations where it can be written

httpsd.conf, <VirtualHost> and <Location>