Scripting and Programming Guides › Scripting Guide for Perl › CLI Policy Management Methods › Realm Methods › Agent Method—Sets or Retrieves the Agent for the Realm

Agent Method—Sets or Retrieves the Agent for the Realm

The Agent method sets or retrieves the agent for the realm.

Syntax

The Agent method has the following format:

Netegrity::PolicyMgtRealm‑>Agent([agent])

Parameters

The Agent method accepts the following parameters:

agent (PolicyMgtAgent)

(Optional) Specifies the agent to set for the realm.

Return Value

The Agent method returns one of the following values:

• A new or existing PolicyMgtAgent object for the realm
• undef if the call is unsuccessful