Novell Documentation: NLM & NetWare Libraries for C

NWTTSGetProcessThresholds

Returns the number of explicit physical and logical record locks allowed 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  NWTTSGetProcessThresholds  ( 
     NWCONN_HANDLE   conn,  
     pnuint8         logicalLockLevel,  
     pnuint8         physicalLockLevel);

Delphi Syntax

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

Parameters

conn: (IN) Specifies the NetWare server connection handle.
logicalLockLevel: (OUT) Points to the number of explicit logical record locks allowed before implicit transactions begin (0 to 255, optional).
physicalLockLevel: (OUT) Points to the number of explicit 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

NWTTSGetProcessThresholds and NWTTSSetProcessThresholds are useful for applications changing the implicit process thresholds that later want to restore them. For example, NWTTSGetProcessThresholds can query an application for the number of logical and physical record locks allowed before an implicit transaction begins, and NWTTSSetProcessThresholds can perform one of the following:

Turn off implicit transactions. (Applications intending to use 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.

The default threshold for logical and physical locks is 0. 0xFF means no implicit transactions are allowed for the lock type.

Thresholds returned by NWTTSGetProcessThresholds are valid for the requesting application only. When the application terminates, the connection thresholds are restored.

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