ttWarnOnLowMemory

This procedure enables applications to specify that operations run on the current connection should return a warning if they allocate memory and find that memory is low. If the value is set, a warning is returned for any operation that does an allocation and finds total memory in use to be above the connection's threshold value as specified by the PermWarnThreshold and TempWarnThreshold connection attributes.

Required Privilege

This procedure requires no privilege.

Usage in TimesTen Scaleout and TimesTen Classic

This procedure is supported in TimesTen Classic.

TimesTen Scaleout applications can call this built-in procedure.

In TimesTen Scaleout, this procedure runs locally on the element from which it is called.

Related Views

This procedure has no related views.

Syntax

ttWarnOnLowMemory(permanent, temporary)

Parameters

ttWarnOnLowMemory has these parameters:

Parameter	Type	Description
permanent	TT_INTEGER NOT NULL	1- Enable warnings for the permanent data partition 0 - Disable warnings for the permanent data partition
temporary	TT_INTEGER NOT NULL	1- Enable warnings for the temporary data partition 0 - Disable warnings for the temporary data partition

Result Set

ttWarnOnLowMemory returns no results.

Examples

CALL ttWarnOnLowMemory(1, 0);

Enables low memory warnings for the permanent data partition only.

Note:

By default, TimesTen does not issue low memory warnings for either partition. Applications that want to receive these warnings must call this procedure. This procedure is connection specific, and so you must issue it for each connection upon which warnings are desired. Also, the current setting does not persist to subsequent connections.