TTSSetApplicationThresholds

Sets the current connection’s application thresholds for implicit transactions (For cross-platform functionality, see Developing NLMs with Cross-Platform Functions ( NDK: NLM Development Concepts, Tools, and Functions) and call and call NWTTSSetConnectionThresholds.)

Local Servers:nonblocking
Remote Servers:blocking
NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM
Service:Server-Based TTS

Syntax

  #include <\nlm\nit\nwtts.h>  
   
  int TTSSetApplicationThresholds (  
     BYTE   logicalRecordLockThreshold,  
     BYTE   physicalRecordLockThreshold); 
  

Parameters

logicalRecordLockThreshold
(IN) Specifies the maximum number of logical locks that can be held without starting a transaction.
physicalRecordLockThreshold
(IN) Specifies the maximum number of physical locks that can be held without starting a transaction.

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

NetWare Error

UNSUCCESSFUL

Remarks

The thresholds set by this function are valid only until the next end-of-job on the current connection. When the next end-of-job occurs, the application thresholds are set to the current workstation thresholds.

This function is useful for either turning off implicit transactions or allowing applications to work that always keep one or more records locked. For example, applications that use only explicit transactions, but sometimes generate unnecessary implicit transactions, can use this function to turn off all implicit transactions.

The default threshold for logical and physical locks is 0. A threshold of 0xFF means there are no implicit transactions for that lock type.

The thresholds set by this function are valid for the requesting application only. When the application terminates, the workstation thresholds are restored. This is only meaningful in a client-server NLM that uses the client’s connection number for transactions. Whenever the client’s workstation generates an end-of-job (normally when a workstation application ends), the TTS application thresholds are reset to the TTS workstation thresholds.

See Also

TTSGetApplicationThresholds