10-18
User
Guide

for

the

Cisco

Application

Networking

Manager

5.2
OL-26572-01
Chapter
10






Configuring

Parameter

Maps
Configuring
Optimization

Parameter

Maps
Ta
b

l

e


10-7
Parameter
Expander

Functions
Variable
Description
$(number)
Expands
to

the

corresponding

matching

subexpression

(by

number)
in
the

URL

pattern.

Subexpressions

are

marked

in

a

URL

pattern
using
parentheses

().

The

numbering

of

the

subexpressions

begins
with
1

and

is

the

number

of

the

left-parenthesis

“(“

counting

from
the
l

eft.

You

can

specify

any

positive

i

nteger

for

the

number.

$(0)
matches
the

entire

URL.

For

example,

if

the

URL

pattern

is
((http://server/.*)/(.*)/)a.jsp,
and

the

URL

that

matches

it

is
http://server/main/sub/a.jsp?category=shoes&session=99999,
then
the
following

are

correct:
$(0)
=

http://server/main/sub/a.jsp
$(1)
=

http://server/main/sub/
$(2)
=

http://server/main
$(3)
=

sub
If
the

specified

subexpression

does

not

exist

in

the

URL

pattern,

then
the
variable

expands

to

the

empty

string.
$http_query_string()
Expands
to

the

value

of

the

whole

query

string

in

the

URL.

For
example,
if

the

URL

is
http://myhost/dothis?param1=value1&param2=value2,
then

the
following
is

correct:
$http_query_string()
=

pa

ram1=value1&param2=value2
This
function

applies

to

both

GET

and

POST

requests.
$http_query_param(query-param-name)
The
obsolete

syntax

is

also

supported:
$param(query-param-name)
Expands
to

the

value

of

the

named

query

parameter

(case

sensitive).
For
example,

if

the

URL

is
http://server/main/sub/a.jsp?category=shoes&session=99999,
then
the
following

are

correct:
$http_query_param(category)
=

shoes
$http_query_param(session)
=

999

99
If
the

specified

parameter

does

not

exist

in

the

query,

then

the
variable
expands

to

the

empty

string.

This

function

applies

to

both
GET
and

POST

requests.
$http_cookie(cookie-name)
Evaluates
to

the

value

of

the

named

cookie.

For

example,
$http_cookie(cookiexyz).
The

cookie

name

is

case

sensitive.
$http_header(request-header-name)
Evaluates
to

the

value

of

the

specified

HTTP

request

header.

In

the
case
of

multivalued

headers,

it

is

the

single

representation

as
specified
in

the

HTTP

specification.

For

example,
$http_header(user-agent).
The

HTTP

header

name

is

not

case
sensitive.
$http_method()
Evaluates
to

the

HTTP

method

used

for

the

request,

such

as

GET

or
POST.