Knowledge Base

How To Determine Session Status Using SLI API.

Article ID: 185438

Article Last Modified on 2/22/2007

Microsoft Host Integration Server 2000 Standard Edition
Microsoft SNA Server 2.0
Microsoft SNA Server 2.1
Microsoft SNA Server 3.0
Microsoft SNA Server 3.0 Service Pack 4
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.

Additional query words: HIS 2000

Keywords: KB185438