Novell Documentation: NLM & NetWare Libraries for C

NWTTSSetConnectionThresholds

Sets the number of explicit physical and logical record locks to permit before invoking implicit transactions

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Transaction Tracking System (TTS)

Syntax

  #include <nwtts.h> 
  or 
  #include <nwcalls.h> 
   
  NWCCODE N_API  NWTTSSetConnectionThresholds  ( 
     NWCONN_HANDLE   conn,  
     nuint8          logicalLockLevel,  
     nuint8          physicalLockLevel);

Delphi Syntax

  uses calwin32 
   
  Function NWTTSSetConnectionThresholds 
    (conn : NWCONN_HANDLE; 
     logicalLockLevel : nuint8; 
     physicalLockLevel : nuint8 
  ) : NWCCODE;

Parameters

conn: (IN) Specifies the NetWare server connection handle.
logicalLockLevel: (IN) Specifies the number of logical record locks to allow before implicit transactions begin (0 to 255).
physicalLockLevel: (IN) Specifies the number of physical record locks to allow before implicit transactions begin (0 to 255).

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000	SUCCESSFUL
0x8801	INVALID_CONNECTION
0x890A	NLM_INVALID_CONNECTION

Remarks

The return values are in effect for all applications, not just ones calling NWTTSSetConnectionThresholds.

The default threshold for logical and physical locks is 0. 0xFF means no implicit transactions for the lock type can be performed.

NWTTSSetConnectionThresholds and NWTTSGetConnectionThresholds are useful for applications changing the implicit application thresholds that later want to restore them.

For example, NWTTSGetConnectionThresholds can obtain the current number of logical and physical locks, and NWTTSSetConnectionThresholds can perform one of the following:

Turn off implicit transactions. (Applications using only explicit transactions, but sometimes generate unnecessary implicit transactions, need to turn off all implicit transactions.)
Set implicit thresholds for applications always keeping one or more records locked.

NCP Calls