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