Novell Documentation: NLM & NetWare Libraries for C

NWTTSGetConnectionThresholds

Returns the number of logical and physical record locks allowed before implicit transactions begin

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

Delphi Syntax

  uses calwin32 
   
  Function NWTTSGetConnectionThresholds 
    (conn : NWCONN_HANDLE; 
     logicalLockLevel : pnuint8; 
     physicalLockLevel : pnuint8 
  ) : NWCCODE;

Parameters

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

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

Both NWTTSSetConnectionThresholds and NWGetConnectionThreshold s are useful for applications changing the implicit application thresholds that later want to restore them. For example, NWTTSGetConnectionThresholds can get the 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 generating unnecessary implicit transactions, need to turn off all implicit transactions.)
Set implicit thresholds for applications always keeping one or more records locked.

The default threshold for logical and physical locks is 0. 0xFF means implicit transactions for the lock type have been completed.

Both physicalLockLevel and logicalLockLevel are optional parameters. Substitute NULL if these parameters are not to be returned. However, all parameter positions must be filled.

NCP Calls