TTSGetWorkstationThresholds

Returns the current connection’s workstation thresholds for implicit transactions

Local Servers:blocking
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 TTSGetWorkstationThresholds (  
     BYTE   *logicalRecordLockThreshold,  
     BYTE   *physicalRecordLockThreshold); 
  

Parameters

logicalRecordLockThreshold
(OUT) Specifies the number of logical record locks allowed before an implicit transaction begins (0 to 255).
physicalRecordLockThreshold
(OUT) Specifies the number of physical record locks allowed before an implicit transaction begins (0 to 255).

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

NetWare Error

UNSUCCESSFUL

Remarks

This function allows an application to get the number of logical and physical record locks allowed before an implicit transaction begins for the current connection.

This function and TTSSetWorkstationThresholds are useful for applications that want to set the thresholds semi-permanently (until the next time TTSetWorkstationThresholds is called).

For example, TTSGetWorkstationThresholds can get the number of logical and physical locks, and TTSSetWorkstationThresholds can do one of the following:

  • Turn off implicit transactions.
  • Set implicit thresholds for applications that always keep one or more records locked.

Applications that use only explicit transactions, but sometimes generate unnecessary implicit transactions, can 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 threshold values set by TTSSetWorkstationThresholds are not reset when a workstation application terminates (that is, when an end-of-job occurs). In other words, all applications on the requesting workstation share these same thresholds.

Workstation users normally execute SETTTS.EXE to set workstation thresholds.

See Also

TTSSetWorkstationThresholds