Programming Guides › Programming Guide for C › Agent API › Data Types and Structures › Sm_AgentApi_Server_t

Sm_AgentApi_Server_t

This structure defines the connection configuration for each server.

Syntax

This structure has the following format:

typedef struct Sm_AgentApi_Server_s
{
   char lpszIpAddr[SM_AGENTAPI_SIZE_NAME];
   long nConnMin; 
   long nConnMax;
   long nConnStep; 
   long nTimeout;
   long nPort[3];
   void* pHandle[3];
   long nClusterSeq;
} Sm_AgentApi_Server_t;

Parameters

This structure has the following parameters:

• pszIpAddr

  The IP address of the Policy Server. A pipe of TCP connections is formed for each of the three services within the Policy Server (Authorization, Authentication, and Accounting).

• nConnMin

  Describing the pipe of TCP connections, this is the initial number of connections.

• nConnMax

  Describing the pipe of TCP connections, this is the maximum number of allowed connections within the pipe.

• nConnStep

  As necessary, the number of connections in the pipe of TCP connections will be increased by this increment.

• nTimeout

  The number of seconds until it is determined that the agent can not reach the Policy Server. This parameter is configurable based on the overall throughput and latency conditions of the entire SiteMinder installation.

• nPort

  When the Policy Server is configured for a single Access Control TCP port, use the constant SM_AGENTAPI_POLICYSERVER to point to the combined port. The constants below are maintained for backward compatibility:

  • SM_AGENTAPI_AZ_SERVER
  • SM_AGENTAPI_AUTH_SERVER
  • SM_AGENTAPI_ACCT_SERVER
• pHandle

  Reserved; set to null.

• nClusterSeq

  The cluster sequence number. Sequence numbers begin at 1. Omit this parameter for a non-cluster server.