This guide is designed for application programmers who write programs that utilize IRIS® SNA LU 0-3 from Silicon Graphics®. IRIS SNA LU 0-3, which is included and shipped with the IRIS SNA SERVER, provides an interface to the services available in Systems Network Architecture (SNA) Logical Unit (LU) Types 0, 1, 2, and 3.
This guide focuses only on those aspects of the SNA product that pertain to
LU 0-3 and should be used in conjunction with the IRIS SNA SERVER Administration Guide, which covers such topics as the graphical user interface network management tool (IRIS SNAView) and configuring and operating the IRIS SNA SERVER.
The IRIS SNA SERVER Programming Guide contains the following chapters and appendices:
| Chapter 1 | “Before You Begin” describes how to set the run-time variables and provides an overview of the verbs used to implement IRIS SNA LU 0-3. Detailed verb documentation is also provided in Appendix H, “Man Pages,” of this guide. | |
| Chapter 2 | “Programming with the SNA SERVER Verbs” describes the Application Programmers Interface (API), or verb functions, which are provided separately as manual pages in Appendix H. A diagnostic guide for applications is also included. | |
| Chapter 3 | “Programming with the LU 0-3 Verbs” presents an overview to the Programmable Interface (PI), or verb functions for the Logical Unit Types 0, 1, 2, and 3. | |
| Appendix A | “Major and Minor Return Codes” lists the major and minor error codes returned by the API verbs (that is, the SNA SERVER, LU 6.2, and LU 0-3 verbs). | |
| Appendix B | “Supported SNA Request Units” lists RUs that can be sent or received by a transaction program using IRIS SNA LU 0-3. | |
| Appendix C | “Notification Events” presents the valid notifications reported in the ru_cmd parameter of the rcvru verb and the layout of the rcvru verb for each valid event. | |
| Appendix D | “LU Finite-State Machines” describes the members contained in the LU finite-state machine structure, fsm_lu. | |
| Appendix E | “PU Finite-State Machines” describes the members contained in the PU finite-state machine structure, fsm_pu. | |
| Appendix F | “State Definition” describes valid states for LU and PU | |
| Appendix G | “API Verb Catalog” provides an index to all API verbs. | |
| Appendix H | “Man Pages” contains the category (3) IRIS SNA SERVER and LU 0-3-related man pages. |
Within text, file names, parameters, commands, and command arguments are shown in italics. Machine names are shown in bold italics.
Command syntax descriptions and examples appear in typewriter font.
User input and keyboard commands appear in bold typewriter font.
API verb names are shown in bold face.
This guide is part of a three-volume set that includes:
IRIS SNA SERVER Administration Guide
IRIS SNA SERVER VT100 Interface Guide
In addition, the following reference materials from Silicon Graphics and IBM® provide supplementary information on topics covered in this guide.
Token Ring Administration Guide
IRIS SNA LU 6.2 Programming Guide
IRIS SNA 3270 Administrator's Guide
International Business Machines (IBM order numbers follow title)
Systems Network Architecture Concepts and Products (GC30-3072)
Systems Network Architecture Technical Overview (GC30-3073)
An Introduction to Advanced Program-to-Program Communication (GG24-1584)
Systems Network Architecture Transaction Programmer's Reference Manual for LU Type 6.2 (GC30-3084)
Systems Network Architecture Format and Protocol Reference Manual: Architecture Logic for LU Type 6.2 (SC30-3269)
Systems Network Architecture Network Product Formats (LY43-0081)
Synchronous Data Link Control Concepts (GA27-3093)
Systems Network Architecture Reference Summary (GA27-3136)
Token Ring Network Architecture Reference (SC30-3374)