Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Host Configuration Methods › EnableFailover Method—Sets or Retrieves the Enable Failover Flag

EnableFailover Method—Sets or Retrieves the Enable Failover Flag

The EnableFailover method Sets or retrieves the enable failover flag. This flag determines whether an agent and the Policy Server should communicate through failover or round-robin.

Syntax

The EnableFailover method has the following format:

Netegrity::PolicyMgtHostConfig‑>EnableFailover([EnableFailover])

Parameters

The EnableFailover method accepts the following parameter:

EnableFailover (int)

(Optional) Specifies the value of the flag to set.

Return Value

The EnableFailover method returns one of the following values:

• The new or existing flag setting:
  • 1 for failover
  • 0 for round-robin
• -1 if the call is unsuccessful