Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Response Methods › CreateAttribute Method—Creates a Static Response Attribute for the Response

CreateAttribute Method—Creates a Static Response Attribute for the Response

The CreateAttribute method creates a Static response attribute for the response.

Syntax

The CreateAttribute method has the following format:

Netegrity::PolicyMgtResponse‑>CreateAttribute(attrName, varValue [, TTL])

Parameters

The CreateAttribute method accepts the following parameters:

attrName (string)

Specifies the name of the attribute to create. Valid attribute names vary with the type of agent associated with the response.

Agent type is specified in the SiteMinder Response Dialog, which is displayed when you create a response. To see the list of attributes associated with a given agent type, select the agent type in the SiteMinder Response Dialog, click Create, then view the choices in the Attribute field of the SiteMinder Response Attribute Editor.

For example, if you are creating a response with a SiteMinder Web Agent type, you can create any of the following response attributes:

• WebAgent-HTTP-Header-Variable
• WebAgent-HTTP-Cookie-Variable
• WebAgent-OnAccept-Redirect
• WebAgent-OnAccept-Text
• WebAgent-OnAuthAccept-Session-Idle-Timeout
• WebAgent-OnAuthAccept-Session-Max-Timeout
• WebAgent-OnReject-Redirect
• WebAgent-OnReject-Text

  varValue (string)

Specifies the value of the static attribute. This value appears in the Value column of the SiteMinder Response Dialog. The value represents either a variable or cookie value or a name/value pair. If you need to specify a name as well as a value, use the form name=value. For example, the attribute WebAgent-HTTP-Header-Variable requires a name/value pair. If the name is show_content and the value is yes, you would assign show_content=yes to varValue.

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 CreateAttribute 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‑>CreateActiveAttribute method and the PolicyMgtResponse‑>CreateVariableAttribute method.