# tibemsConnectionFactory_SetMetric

Function

## Purpose

Modify the load balancing metric.

## C Declaration

    tibems_status tibemsConnectionFactory_SetMetric(
        tibemsConnectionFactory factory,
        tibemsFactoryLoadBalanceMetric metric );

## COBOL Call

    CALL "tibemsConnectionFactory_SetMetric"
         USING BY VALUE factory,
               BY VALUE metric,
               RETURNING tibems-status
    END-CALL.

Note: `factory` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`factory` | Set the load balancing metric of this connection factory.
`metric` | Use this metric.

## Remarks

When the connection factory balances the client load among several servers, it uses this metric to determine the least loaded server, so the connection factory can create a connection to it. For values, see `tibemsFactoryLoadBalanceMetric`.

Copyright © Cloud Software Group, Inc. All rights reserved.