Programming Guides › Programming Guide for Perl › CLI Policy Management Methods › Session Methods › CreateHostConfig Method—Creates Host Configuration Object

CreateHostConfig Method—Creates Host Configuration Object

The CreateHostConfig method creates a host configuration object.

Syntax

The CreateHostConfig method has the following format:

Netegrity::PolicyMgtSession‑>CreateHostConfig(hostConfigName[, hostConfDesc][, enableFailover][, maxSocketsPerPort][, minSocketsPerPort][, newSocketstep][, requestTimeout])

Parameters

The CreateHostConfig method accepts the following parameters:

hostConfigName (string)

Specifies the name of the host configuration object.

hostConfDesc (string)

(Optional) Specifies the description of the host configuration object.

enableFailover (int)

(Optional) Specifies whether to use failover or round-robin communication between the Policy Server and the agent:

• value = 1

  Specifies failover communication.

• value = 0

  Specifies round-robin communication.

  maxSocketsPerPort (int)

(Optional) Specifies the maximum number of TCP/IP sockets that can be opened between an agent and the Policy Server.

minSocketsPerPort (int)

(Optional) Specifies the minimum number of TCP/IP sockets that can be opened between an agent and the Policy Server.

newSocketstep (int)

(Optional) Specifies how many sockets to open when additional sockets are required.

requestTimeout (int)

(Optional) Specifies how long, in seconds, an agent can wait for a response from the Policy Server.

Return Value

The CreateHostConfig method returns one of the following values:

• PolicyMgtHostConfig (object)
• undef if the call is unsuccessful or the host configuration name already exists