19.3 HTTP Server Functions

This section describes the server functions that are used to to manage requests (UDRs) from the HTTPD collector agent.

httpGetRequestCookie

This function searches for a cookie name in the httpdUDR and returns the contents.

string httpGetRequestCookie
( any httpdUDR ,
string cookieName )
ParameterDescription

httpdUDR

The request

cookieName

A cookie is made up of a key:value data object, where cookieName is the key.

Note!

The value can be "null".

ReturnsThe contents (value) of the cookie.

httpGetRequestCookieNames

This function retrieves a list of cookie names (keys) from the request (UDR).

list <string> httpGetRequestCookieNames ( any httpdUDR )
ParameterDescription

httpdUDR

The request

ReturnsA list of cookie names

httpSetResponseCookie

This function sets the response cookie (UDR) fields.

void httpSetResponseCookie
 ( any httpdUDR,				
 string name,
 string value,
 boolean discard,
 string domain,
 long maxAge,
 string path,
 boolean secure )				
ParameterDescription

httpdUDR

The response

name

The name of the cookie (the key in the key:value cookie object)

value

The contents of the cookie (the value in the key:value cookie object)

discard

Set to "true" to discard the cookie at browser close, or "false", to keep it.

domain

The domain to which the cookie should be sent

maxAge

The life-length of the cookie in seconds

path

The path within the domain that triggers the cookie

secure

Set to "true" for sending the cookie only to secure sites, or "false", for sending the cookie to any site within the domain.

ReturnsNothing