Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Response Methods › CreateActiveAttribute Method—Creates an Active Response Attribute for the Response

CreateActiveAttribute Method—Creates an Active Response Attribute for the Response

The CreateActiveAttribute method creates an Active Response attribute for the response.

Syntax

The CreateActiveAttribute method has the following format:

Netegrity::PolicyMgtResponse‑>CreateActiveAttribute(agentAttrName, name, lib, func, params [, TTL])

Parameters

The CreateActiveAttribute method accepts the following parameters:

agentAttrName (string)

Specifies the name of the Web Agent attribute, for example, WebAgent-HTTP-Header-Variable.

name (string)

Specifies the name of the response attribute.

lib (string)

Specifies the name of the shared library that will retrieve values for the response attribute. You should not specify a file extension for the shared library. Specify a path if the shared library is not referenced by the PATH environment variable.

func (string)

Specifies the name of the shared library function that retrieves the values for the response attribute.

params (string)

Specifies any parameters required by the func parameter.

TTL (int)

(Optional) Specifies the amount of time in seconds that can elapse before the value of the response attribute is recalculated.

Return Value

The CreateActiveAttribute method returns one of the following values:

• A PolicyMgtResponseAttr object
• undef if the call is unsuccessful

Remarks

You cannot create response attributes of type User Attribute or DN Attribute with the Command Line Interface.

See also the descriptions of the PolicyMgtResponse‑>CreateAttribute method and the PolicyMgtResponse‑>CreateVariableAttribute method.