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.