Chapter  1.  Concepts
What  Is  LUA?
Choosing  Which  Interface  to  Use
LUs  and  Sessions  Configuration
LUA  Verbs
RUI  Verb  Summary
SLI  Verb  Summary
Asynchronous  Verb  Completion
A  Sample  LUA  Communication  Sequence
LUA  Compatibility
Chapter  2.  Designing  and  Writing  LUA  Applications
LUA  Entry  Points  for  AIX  or  Linux  Applications
RUI  Function  Call
SLI  Function  Call
Supplied  Parameters
Returned  Values
Usage
Callback  Routine  for  Asynchronous  Verb  Completion
LUA  Entry  Points  for  Windows  Applications
RUI
WinRUIStartup
WinRUI WinRUIGetLastInitStatus  WinRUICleanup
GetLuaReturnCode
SLI
WinSLIStartup
WinSLI
WinSLICleanup
Issuing  an  LUA  Verb
SNA  Information
BIND  Checking:  RUI
BIND  Checking:  SLI
Negative  Responses  and  SNA  Sense  Codes
Pacing
Segmentation
Modification  of  Nonstandard  Host  Response/Request  Header  (RH)  Bits
Courtesy  Acknowledgments
Purging  Data  to  End  of  Chain
SNA  Information  for  RUI  Primary
Responsibilities  of  the  Primary  RUI  application
Pacing  Segmentation
Restrictions
Courtesy  Acknowledgments
Purging  Data  to  End  of  Chain
Configuration  Information
Data  Link  Control  (DLC),  Port,  and  Link  Station  (LS)
LU  LU  Pool  (Optional)
AIX  or  Linux  Considerations
LUA  Header  File
Multiple  Processes  and  Multiple  Sessions
Compiling  and  Linking  the  LUA  Application
Windows  Considerations  .
Multiple  Sessions  and  Multiple  Tasks
Compiling  and  Linking  LUA  Programs
Terminating  Applications
Writing  Portable  Applications
Chapter  3.  LUA  VCB  Structure
LUA  Verb  Control  Block  (VCB)  Format
LUA_VERB_RECORD  Data  Structure
Common  Data  Structure
Specific  Data  Structure
Chapter  4.  RUI  Verbs
RUI_BID
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
RUI_INIT
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
RUI_INIT_PRIMARY
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
RUI_PURGE
Supplied  Parameters
Returned  Parameters  Interaction  with  Other  Verbs
RUI_READ
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions  RUI_REINIT
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs  .
Usage  and  Restrictions
RUI_TERM  Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
RUI_WRITE
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
Chapter  5.  SLI  Verbs
SLI_BID  Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_CLOSE  Supplied  Parameters  Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_OPEN
Supplied  Parameters
Return  Value  from  SLI  Entry  Point
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_PURGE
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
SLI_RECEIVE  Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_SEND
Supplied  Parameters
Returned  Parameters
Interaction  with  Other
Verbs  Usage  and  Restrictions  .
SLI_BIND_ROUTINE
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_SDT_ROUTINE
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
SLI_STSN_ROUTINE
Supplied  Parameters
Returned  Parameters
Interaction  with  Other  Verbs
Usage  and  Restrictions
Chapter  6.  Sample  LUA  Application
Processing  Overview
Testing  the  Application
Host  Requirements
Configuration  for  the  Sample  Application
Compiling  and  Linking  the  Sample  Application
Running  the  Sample  Application
Appendix  A.  Return  Code  Values
Primary  Return  Codes
Secondary  Return  Codes
Appendix  B.  Accessibility  .
Using  assistive  technologies
Keyboard  navigation  of  the  user  interface
z/OS  information  .  Appendix  C.  Notices
Trademarks
Bibliography  CS/AIX  Version  6.3Publications
IBM  Communications  Server  for  AIX  Version  4  Release  2  Publications
IBM  Redbooks  Block  Multiplexer  and  S/390  ESCON  Channel  PCI  Adapter  publications
AnyNet/2  Sockets  and  SNA  publications
AIX  Operating  System  Publications
Systems  Network  Architecture  (SNA)  Publications
Host  Configuration  Publications
z/OS  Communications  Server  Publications
Multiprotocol  Transport  Networking  publications
TCP/IP  Publications
X.25  Publications
APPC  Publications
Programming  Publications
Other  IBM  Networking  Publications
Index
Communicating  Your  Comments  to  IBM

Chapter 1. Concepts
This chapter introduces the fundamental concepts of LUA—the Conventional LU (Logical Unit) Application Programming Interface (API).
The topics covered in this chapter are as follows:
v What is LUA?
v Choosing which interface to use (RUI or SLI)
v LUs and sessions
v LUA verbs
v A sample LUA communication sequence
v LUA compatibility
What Is LUA?
LUA (the Conventional LU Application Programming Interface) is an API that enables you to write CS/AIX applications to communicate with host applications.
The LUA interface is provided at the request/response unit (RU) level, allowing the programmer control over the Systems Network Architecture (SNA) messages sent between CS/AIX and the host. It can be used to communicate with any of the LU types 0, 1, 2, or 3 at the host; it is up to the application to send the appropriate SNA messages as required by the host application.
For example, you can use LUA to write a 3270 emulation program that communicates with a host 3270 application; a simple version of this is included as a sample LUA application with CS/AIX, and described in Chapter 6, “Sample LUA Application,” on page 147.
Choosing Which Interface to Use
LUA includes two different programming interfaces at different level v The Request Unit Interface (RUI) is provided at the request/response unit (RU) level, allowing the programmer control over the Systems Network Architecture (SNA) messages sent between CS/AIX and the host. It is up to the application to build and send the appropriate SNA messages as required by the host application.
The RUI interface supports SNA Function Management Profiles 2, 3, 4, 7, and 18, and SNA Transmission Services Profiles 2, 3, 4, and 7.
v The Session-Level Interface (SLI) is a higher-level interface, allowing the programmer to work at a logical message level rather than being concerned with the detail of individual RUs. For example:
– The session can be established and terminated with a single SLI verb (rather than with a sequence of RUI verbs corresponding to the individual RUs involved in session startup and termination).
– The SLI library controls chaining when the application needs to send or receive data that is longer than the maximum RU length specified in the BIND.
– For most SNA commands sent to the host, the SLI library can build the appropriate RU at the request of the application. The SLI interface supports SNA Function Management Profiles 3 and 4, and SNA Transmission Services Profiles 3 and 4..
Configuration
Each LU used by an LUA application must be configured using the Motif administration program, the command-line administration program, or the node operator facility (NOF) API (for more information, refer to the Communications Server for AIX Administration Guide or the Communications Server for AIX NOF Programmer’s Guide). In addition, the CS/AIX configuration may include LU pools.
A pool is a group of LUs with similar characteristics, such that an application can use any free LU from the group. This can be used to allocate LUs on a first-come, first-served basis when there are more applications than LUs available, or to provide a choice of LUs on different connections.

Si le lien ne fonctionne pas correctement, veuillez nous contacter (mentionner le lien dans votre message)
LUA programmer’s guide (1,70 MO) (Cours PDF)