SNAP-IX LUA Programmer's Guide
BeforeYou Begin
Prerequisite Knowledge
Intended Audience
About This Book
Organization of This Book
Typographic Conventions
Graphic Conventions
SNAP-IX Publications
Publications for Users
Publications for Administrators
Publications for Programmers
Related Publications
1 Concepts
1.1 What Is LUA?
1.2 Choosing Which Interface to Use
1.3 LUs and Sessions
1.3.1 Configuration
1.4 LUA Verbs
1.4.1 Verb Summary
1.4.2 Asynchronous Verb Completion
1.5 A Sample LUA Communication Sequence
1.6 LUA Compatibility
2 Designing and Writing LUA Applications
2.1 LUA Entry Point for Solaris Applications
2.1.1 Function Call
2.1.2 Supplied Parameters
2.1.3 Returned Values
2.1.4 Usage
2.1.5 Callback Routine for Asynchronous Verb Completion
2.2 Scheduling Asynchronous Events
2.2.1 Single-Threaded Applications
2.2.2 Multithreaded Applications
2.2.3 Motif Applications
2.3 LUA Entry Points for Windows Applications
2.3.1 RUI
2.3.2 WinRUIStartup
2.3.3 WinRUI
2.3.4 WinRUIGetLastInitStatus
2.3.5 GetLuaReturnCode
2.3.6 WinRUICleanup
2.4 Issuing an LUA Verb
2.5 SNA Information
2.5.1 BIND Checking
2.5.2 Negative Responses and SNA Sense Codes
2.5.3 Pacing
2.5.4 Segmentation
2.5.5 Modification of Nonstandard Host Response/Request Header (RH) Bits
2.5.6 Courtesy Acknowledgments
2.5.7 Purging Data to End of Chain
2.6 Configuration Information
2.6.1 Data Link Control (DLC), Port, and Link Station (LS)
2.6.2 LU
2.6.3 LU Pool (Optional)
2.7 Solaris Environment Considerations
2.7.1 LUA Header File
2.7.2 Multiple Processes and Multiple Sessions
2.7.3 Compiling and Linking the LUA Application
2.8 Windows Environment Considerations
2.8.1 Multiple Sessions and Multiple Tasks
2.8.2 Compiling and Linking LUA Programs
2.8.3 Terminating Applications
2.9 Writing Portable Applications
3 LUA Verbs
3.1 LUA Verb Control Block (VCB) Format
3.1.1 LUA_VERB_RECORD Data Structure
3.1.2 Common Data Structure
3.1.3 Specific Data Structure
3.2 RUI_BID
3.2.1 Supplied Parameters
3.2.2 Returned Parameters
3.2.3 Interaction with Other Verbs
3.2.4 Usage and Restrictions
3.3 RUI_INIT
3.3.1 Supplied Parameters
3.3.2 Returned Parameters
3.3.3 Interaction with Other Verbs
3.3.4 Usage and Restrictions
3.4 RUI_PURGE
3.4.1 Supplied Parameters
3.4.2 Returned Parameters
3.4.3 Interaction with Other Verbs
3.5 RUI_READ
3.5.1 Supplied Parameters
3.5.2 Returned Parameters
3.5.3 Interaction with Other Verbs
3.5.4 Usage and Restrictions
3.6 RUI_REINIT
3.6.1 Supplied Parameters
3.6.2 Returned Parameters
3.6.3 Interaction with Other Verbs
3.6.4 Usage and Restrictions
3.7 RUI_TERM
3.7.1 Supplied Parameters
3.7.2 Returned Parameters
3.7.3 Interaction with Other Verbs
3.8 RUI_WRITE
3.8.1 Supplied Parameters
3.8.2 Returned Parameters
3.8.3 Interaction with Other Verbs
3.8.4 Usage and Restrictions
4 Sample LUA Application
4.1 Processing Overview
4.2 Testing the Application
4.2.1 Host Requirements
4.2.2 Configuration for the Sample Application
4.2.3 Compiling and Linking the Sample Application
4.2.4 Running the Sample Application
Index