# tibemsSSL_System_SetFipsMode

Function

## Purpose

Enable or disable FIPS 140-2 mode.

## C Declaration

    tibems_status tibemsSSL_System_SetFipsMode(
        tibems_bool enabled)

## COBOL Call

    CALL "tibemsSSLParams_System_SetFipsMode"
         USING BY VALUE fipsEnabled,
               RETURNING tibems-status
    END-CALL.

## IBM i

This function is not supported on IBM i systems.

## Parameters

Parameter | Description
--- | ---
`fipsEnabled` | When `TIBEMS_TRUE`, FIPS mode is enabled. When `TIBEMS_FALSE`, FIPS mode is disabled.

## Remarks

This call, while closely associated with the SSL parameters calls, does not actually set or reset a parameter value. Rather, it enables at an application-wide scope the use (or disuse) of FIPS mode.

This call must be made before any other System SSL related calls and before instantiating an SSL connection factory.

Returns `TIBEMS_OK` if it succeeds, otherwise `TIBEMS_SSL_ERROR`.

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