Title

          Copyright

          Preface

          Part I    Introduction

     1.     Overview of DEC SNA 3270 Application Services
       1.1   The 3270 Application Services Application Programming Interface
       1.2   The 3270 OpenVMS Print Symbiont (OpenVMS Only)
       1.3   DEC VTX Support (OpenVMS Only)
       1.4   DECforms Support (OpenVMS Only)
       1.5   MEP VT for DEC SNA 3270 Application Services (OpenVMS Only)
       1.6   SNA Concepts

          Part II    Programming with the API

     2.     Using the 3270 Application Services API
       2.1   Obtaining a Session Identifier
       2.2   Establishing a Connection
       2.2.1  Connection Privileges
       2.2.2  3270 Terminal ­Initiated Connections
       2.2.3  Application ­Initiated Connections
       2.2.4  Failure of Connect
       2.3   Establishing a Session
       2.4   Transmitting Data
       2.4.1  Transmitting Data Within Brackets
       2.4.2  Data Between Brackets
       2.4.3  Negative Responses
       2.5   Requesting Permission to Transmit Data
       2.6   Receiving Data
       2.7   Cancelling the Receipt of Data
       2.8   Acknowledging a Data Stream
       2.9   Deallocating a Session
       2.10   Making Calls in Blocked and Callback Mode
       2.11  Timers
       2.12   LU0 ­Specific Considerations
       2.13  DEC OSF/1 ­Specific Considerations
       2.14  Portability Issues

     3.    Using Application Services Data Structures
       3.1   Using the Buffer Descriptor
       3.2   Using the I/O Status Vector
       3.3   Using the Item List
       3.3.1  Item Descriptor Fields
       3.3.2  Item Codes
       3.3.2.1 Connection Item Codes
       3.3.2.2 BIND Image Codes
       3.3.2.3 Session Item Codes
       3.4   Using Subfields Within Integral Data Types

     4.     3270 Application Services Callable Routines

          r3270_acknowledge

          r3270_allocate_session

          r3270_bind

          r3270_cancel_receive

          r3270_connect

          r3270_deallocate_session

          r3270_free_buffer

          r3270_get_sessinfo

          r3270_receive

          r3270_request_to_transmit

          r3270_transmit

     5.     Compiling, Linking, and Testing Your Application
       5.1   Compiling Your Application
       5.1.1  OpenVMS Symbol Naming Conventions
       5.2   Linking Your Application
       5.3   Testing the Application
       5.4   Testing with the DEC SNA 3270 Terminal Emulator

          Part III   3270 Connectivity Applications

     6.    The 3270 OpenVMS Print Symbiont
       6.1   Initializing and Starting a Queue
       6.2   Defining Parameters for the Print Symbiont
       6.3   SNA Gateway and IBM Definitions
       6.4   Translation Tables
       6.5   Printer Failure Recovery
       6.6   Error Recovery
       6.7   Support for Embedded Carriage Controls
       6.8   Support for Record Attributes
       6.9   Support for Printers and Functions
       6.10   OpenVMS Command Support
       6.10.1  PRINT
       6.10.2  INITIALIZE/QUEUE
       6.10.3 START/QUEUE
       6.11   DQS Support and Spooled Printing
       6.12   Non ­Supported Print Symbiont Features

     7.    The DEC VTX 3270 Application (OpenVMS Only)
       7.1   Terminal Control Program Management Tasks
       7.2   SNA Gateway Management Tasks
       7.3   VTX Application ID
       7.4   Restricting Access to DEC VTX Infobases

          Example 7­1 Using VTX ACU to Add IBM User Information

          Example 7­2 Displaying the IBM User Information

          Example 7­3 Using VTXUPD to Update the Login Form Page
       7.5   R3270VTP.B32 Terminal ­Specific Source Module

          Part IV    Appendixes

     A.      Status Messages
       A.1   Success Message
       A.2   Informational Messages
       A.3   Error Messages

     B.     C Programming Example

     C.     Debugging Your Application
       C.1   Setting Up the Connection
       C.2   Troubleshooting the Connection
       C.2.1 Using CTF
       C.3   Troubleshooting the Session
       C.3.1 Using SNALOG
       C.3.2  Examining BIND Errors
       C.3.3   Examining Protocol Errors
       C.3.4   Examining FUNCABORT Errors

          Glossary

   List of Figures
       Figure 1­1  DEC SNA 3270 Application Services Topology
       Figure 2­1 Sequence of DEC SNA 3270 Application Services Calls
       Figure 3­1 The Buffer Descriptor (OpenVMS)
       Figure 3­2 The Status Vector
       Figure 3­3 The Item Descriptor
       Figure 6­1 Request Flow from an OpenVMS User to the Print Symbiont
       Figure 7­1 Flow When an IBM User Requests Access to a VTX Infobase

   List of Tables
       Table 3­1  Connection Modes
       Table 3­2  3270 Device Characteristics
       Table 3­3  3270 Device Characteristic Bitmask Values
       Table 3­4  Format Types for Load Programmed Symbols Set
       Table 5­1 OpenVMS Include Files for DEC SNA 3270 Application Services
       Table 5­2 OSF/1 Include Files for DEC SNA 3270 Application Services
       Table 6­1 Domain Gateway and IBM Definitions
       Table 6­2  Carriage Control Translations
       Table 6­3  Supported Record Attributes
       Table 6­4  SCS Keyboard Functions Supported
       Table 7­1 Tasks to Perform Before Starting the TCP
       Table 7­2  Tasks to Perform After VTX Installation
       Table C­1  Trace Logical Names and Environment Variables
       Table C­2  General Tracing Options
       Table C­3   Layered Product Tracing
       Table C­4   Options Within Each Layer