This SPD describes Digital SNA APPC/LU6.2 Programming Interface for OpenVMS, which is available for the OpenVMS VAX and OpenVMS AXP plat- forms. All information applies to both platforms unless otherwise in- dicated. DESCRIPTION The Digital SNA Advanced Program-to-Program Communications/Logical Unit 6.2 (APPC/LU6.2) Programming Interface for OpenVMS is a layered soft- ware product that allows user-written applications running on suit- ably configured OpenVMS systems either within a DECnet network or run- ning VMS/SNA software to exchange messages with cooperating applica- tions in an IBM[R] host. The APPC software exists in the OpenVMS sys- tem as a shareable image. Access between the cooperating Digital and IBM applications is via one of the following products: o Digital Peer Server o Digital SNA Gateway for Synchronous Transport o Digital SNA Gateway for Channel Transport o DEC SNA Domain Gateway for Channel Transport o VMS/SNA - an OpenVMS VAX layered product that supports users on the system where VMS/SNA is running The APPC product is a set of subroutines which are called by OpenVMS programs which act as LU6.2 transaction application programs. These subroutines allow an OpenVMS transaction application to: o Activate and deactivate sessions o Allocate and deallocate LU6.2 basic and mapped conversations o Send and receive data o Request confirmation and confirm transactions o Send and receive error information o Define and delete local LU names and TP names o Supply program initialization parameters April 1996 AE-ET90J-TE o Supply session-level security and inbound conversation level se- curity o Allow outbound conversation allocation o Notify the user application of session failure o Notify the user application of conversation deallocation Features The APPC product provides features to assist the user in writing and executing the OpenVMS transaction program. The APPC product performs the SNA communications function on the programmer's behalf, allowing the user to concentrate on solving the application problem rather than having to learn about the underlying communications medium. Because the APPC product performs all the SNA functions on the user's behalf, users are not required to have a knowledge of SNA. The verbs comprising the APPC product are defined to make the indi- vidual subroutine calls correspond to the verbs defined in the IBM man- ual, SNA Transaction Programmers Reference Manual for Logical Unit 6.2. This makes it easier for IBM application level programmers to code Open- VMS LU6.2 programs. The APPC product implements both the basic and mapped conversation verb set using the same procedure calls. The OpenVMS programmer may choose which type of conversation is desired by specifying the appropriate symbolic code in the TYPE parameter of the SNALU62$ALLOCATE procedure. Both sets of verbs can be synchronous or asynchronous. Asynchronous completion of verbs allows for multithreaded applications to use the LU6.2 interface without blockage. The following sections describe the supported and unsupported verbs. Supported Verbs The following basic conversation verbs are supported: o Allocate o Confirm 2 o Confirmed o Deallocate o Flush o Get_attributes o Get_type[B o Post_on_receipt o Prepare_to_receive o Receive_and_wait o Receive_immediate o Request_to_send o Send_data o Send_error o Wait The following mapped conversation verbs are supported: o Get_type o MC_Allocate o MC_Confirm o MC_Confirmed o MC_Deallocate o MC_Flush o MC_Get_attributes o MC_Post_on_receipt o MC_Prepare_to_receive o MC_Receive_immediate o MC_Receive_and_wait 3 o MC_Request_to_send o MC_Send_data o MC_Send_error o MC_Wait The following control operator verbs are supported: o Activate_session o Deactivate_session o Define_remote o Define_tp o Delete Refer to the APPC product documentation for complete descriptions of the use of these verbs. Unsupported Verbs The following basic conversation verbs are not supported: o Backout o Syncpt o Test The following mapped conversation verbs are not supported: o Backout o Syncpt o MC_Test The APPC product supports single sessions only; parallel sessions are not supported. The following control operator verbs are not needed: o Change_session_limit o Define_local_lu 4 o Define_mode o Display_local_lu o Display_mode o Display_remote_lu o Display_tp o Initialize_session_limit o Process_session_limit o Reset_session_limit User Interface Users of the APPC product should be experienced OpenVMS application programmers. They can use any of the OpenVMS programming languages which conform to the OpenVMS Calling Standard to create application programs which interact with application programs on an IBM system. The user documentation provides example programs written in the native form of the following languages: o MACRO-32 o BASIC o BLISS-32 o C o COBOL o FORTRAN o PASCAL o PL/I The users of the APPC product are not required to have a knowledge of SNA. INSTALLATION 5 Digital recommends that a customer's first purchase of this software product include Digital Installation Services. These services provide for installation of the software product by an experienced Digital Soft- ware Specialist. For subsequent purchases of this product, only experienced customers should attempt installation. Digital recommends that all other cus- tomers purchase Digital's Installation Services. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all requisite hardware including termi- nals; o Obtain, install, and demonstrate as operational any modems and other equipment and facilities necessary to interface to Digital's com- munications equipment; o Demonstrate equivalency of operation for modems other than Bell[TM] System 201C, 208A or 209A, AT&T[TM] 2596, 2556, Data Phone[TM] II (2096A, Digital 2500, or equivalent) type modems or, in Europe, PTT approved modems; o Have generated, to Digital's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway or VMS/SNA and the APPC Programming Interface; o Make available for a reasonable period of time, as mutually agreed by Digital and the customer, all hardware, communications facil- ities, and terminals that are to be used during installation. Delays caused by any failure to meet these responsibilities will be charged at the prevailing rate for time and materials. Successful use of this product requires that: o the customer must be prepared to work with both Digital and IBM sys- tems personnel to coordinate the preinstallation activities; 6 o the customer should be capable of modifying IBM component gener- ation parameters to support the SNA gateway or VMS/SNA and the APPC Programming Interface. HARDWARE REQUIREMENTS For AXP Systems: o AXP processor as specified in the System Support Addendum (SSA 31.58.02- x) o Any properly configured SNA gateway as specified in the System Sup- port Addendum (SSA 31.58.02-x) For VAX Systems: o VAX, MicroVAX, VAXstation, or VAXserver configuration as specified in the System Support Addendum (SSA 31.58.02-x) o Any properly configured SNA gateway as specified in the System Sup- port Addendum (SSA 31.58.02-x). An alternative is to run VMS/SNA software on the same VAX system as the APPC product. SOFTWARE/CONFIGURATION REQUIREMENTS* The Digital SNA APPC/LU6.2 Programming Interface for OpenVMS requires the following software/configurations: For OpenVMS AXP Systems: o OpenVMS AXP Operating System (SPD 41.87.xx) o DECnet for OpenVMS (SPD 42.25.xx) o Digital SNA Peer Server (SPD 51.08.xx) o One of the following SNA gateways: - Digital SNA Gateway for Channel Transport (SPD 29.76.xx) - Digital SNA Gateway for Synchronous Transport (SPD 25.C6.xx) - DEC SNA Domain Gateway for Channel Transport (SPD 38.69.xx) 7 For OpenVMS VAX Systems in an SNA Gateway Environment: o OpenVMS VAX Operating System (SPD 25.01.xx) o DECnet-VAX (SPD 48.48.xx) o Digital SNA Peer Server (SPD 51.08.xx) o One of the following SNA gateways: - DECnet SNA Gateway for Channel Transport (SPD 29.76.xx) - DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) - DEC SNA Domain Gateway for Channel Transport (SPD 38.69.xx) For OpenVMS VAX Systems in a VMS/SNA Environment: o OpenVMS VAX Operating System (SPD 25.01.xx) o VMS/SNA Software (SPD 27.01.xx) * Refer to the System Support Addendum for availability and required versions of prerequisite/optional software (SSA 26.88.07-x). 8 ORDERING INFORMATION For OpenVMS AXP: Software Licenses: QL-10SA*-** Software Documentation: QA-022AA-GZ Software Product Services: QT-10SA*-** Media and documentation for this product are available on the Digi- tal CD-ROM Software Library for OpenVMS AXP. Documentation in hard- copy format can be ordered separately. For OpenVMS VAX: Software Licenses: QL-022A*-** Software Media: QA-022A*-** Software Documentation: QA-022AA-GZ Software Product Services: QT-022A*-** * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. PREREQUISITE SUPPORT A Network Profile and a DECnet Customer Support Plan (where applica- ble) covering all the OpenVMS nodes that will access the APPC Program- ming Interface must be prepared jointly by Digital and the customer. In order for APPC/LU6.2 to be Digital supported, the customer must have a Digital supported SNA gateway or VMS/SNA configuration. To have a Digital supported SNA gateway configuration, purchase of Dig- ital's Transport Orientation/Installation Service is REQUIRED in con- junction with the customer's first purchase of the gateway. Refer to the SNA gateway SPDs (SPD 29.76.xx, SPD 25.C6.xx, SPD 38.69.xx) for details. To have a Digital supported VMS/SNA system configuration, purchase of Digital's VMS/SNA Orientation/Installation Service is REQUIRED in con- junction with the customer's first purchase of the VMS/SNA software. Refer to VMS/SNA (SPD 27.01.xx) for details. 9 SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more in- formation about Digital's licensing terms and policies, contact your local Digital office. License Management Facility Support This layered product supports the OpenVMS License Management Facil- ity. License units for this product are allocated on a CPU-capacity basis. For more information on the License Management Facility, refer to the OpenVMS VAX Operating System Software Product Description (SPD 25.01.xx), the OpenVMS AXP Operating System Software Product Description (SPD 41.87.xx), or the License Management Facility manual of the OpenVMS Operating Sys- tem documentation set. For more information about Digital's licensing terms and policies, con- tact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the pur- chase of a license for the product as defined in the Software Warranty Addendum of this SPD. WARRANTY LIMITATIONS IBM Supported Configurations This software has been tested and is warranted against IBM System/370 and IBM System/390 (includes 9xxx, 30xx, and 43xx series) class pro- cessor systems configured with the following IBM software. While this software may function correctly with other IBM software and equipment, and with software other than that supported by IBM, Digital cannot of- fer its standard warranty for this software unless it has been tested with such equipment and software configurations. 10 The APPC product can interoperate with the following IBM software: IBM Software Chart ___________________________________________________________________ Software_Product______Version______Release_________________________ CICS/DOS/VS 1 7.0 CICS/MVS 2 1.2 CICS/ESA 3 1.1 2.0 3.0 ACF/VTAM[TM] 3 3.0 4.1 4 1.0 2.0 ___________________________________3.0_____________________________ SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more in- formation contact your local Digital office. [R] IBM is a registered trademark of International Business Ma- chines Corporation. [TM] AT&T and Data Phone are trademarks of American Telephone & Telegraph Company. [TM] Bell is a trademark of Bell Telephone Companies. [TM] VTAM is a trademark of International Business Machines Corpo- ration. [TM] The Digital Logo, AXP, DECnet, Digital, MicroVAX, OpenVMS, VAX, VAXserver, VAXstation, and VMS are trademarks of Digital Equipment Corporation. ©1993 Digital Equipment Corporation. All rights reserved. 11