How To Determine Session Status Using SLI API. (185438)


The information in this article applies to:

  • Microsoft Host Integration Server 2000
  • Microsoft SNA Server 2.0
  • Microsoft SNA Server 2.1
  • Microsoft SNA Server 2.11
  • Microsoft SNA Server 3.0
  • Microsoft SNA Server 4.0
This article was previously published under Q185438

SUMMARY

When using the LUA/SLI interface to communicate with an IBM host application, it is necessary to make a call to SLI in order to determine if the session is still active. If SLI_BID is called, SLI_BID will block the calling thread until either the host sends a message to the SLI application, or the session is lost.

If the host never sends data to the application, the SLI application can call SLI_RECEIVE and set the nowait flag in order to determine if the session is still active. SLI_RECEIVE with nowait will return immediately and will not block the calling thread.

MORE INFORMATION

If the session has failed, SLI_RECEIVE(nowait) will return the following return codes: 
   primary_rc   = LUA_STATE_CHECK (0x0002)
   secondary_rc = LUA_NO_SLI_SESSION  (0x00000034)
If the session is still active, SLI_RECEIVE(nowait) will return the following return codes: 
   primary_rc   = LUA_UNSUCCESSFUL (0x0014)
   secondary_rc = LUA_NO_DATA (0x00000011)

REFERENCES

Refer to the SNA Server LUA Programmer's Reference for more information about the SLI_RECEIVE and SLI_BID functions.
Modification Type:MajorLast Reviewed:3/4/2004
Keywords:KB185438
©2004 Microsoft Corporation. All rights reserved.