NWTTSSetProcessThresholds

Sets the number of logical and physical locks to perform before implicit locking begins

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  NWTTSSetProcessThresholds  ( 
     NWCONN_HANDLE   conn,  
     nuint8          logicalLockLevel,  
     nuint8          physicalLockLevel);
  

Delphi Syntax

  uses calwin32 
   
  Function NWTTSSetProcessThresholds 
    (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-255).
physicalLockLevel
(IN) Specifies the number of physical record locks to allow before implicit transactions begin (0-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

0x8996

SERVER_OUT_OF_MEMORY

Remarks

The thresholds set by NWTTSSetProcessThresholds are valid for the requesting application only. When the application terminates, the default workstation thresholds are restored.

NWTTSSetProcessThresholds either turns off implicit transactions or allows applications always keeping one or more records locked to work. Applications intending to use only explicit transactions, but sometimes generating unnecessary implicit transactions, can call NWTTSSetProcessThresholds to turn off all implicit transactions.

The default threshold for logical and physical locks is 0 unless the number has been changed by calling NWTTSSetConnectionThresholds. 0xFF means no implicit transactions for the lock type are performed.

NCP Calls

See Also

NWTTSGetProcessThresholds