COMPAQ Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 26.88.09 Interface for OpenVMS[TM], Version 2.4 This SPD describes the DIGITAL[TM] SNA APPC/LU6.2 Programming Inter- face for OpenVMS[TM], which is available for the OpenVMS Operating Sys- tem for Alpha and VAX[TM] platforms. All information applies to both platforms unless otherwise indicated. DESCRIPTION The DIGITAL SNA Advanced Program-to-Program Communications/Logical Unit 6.2 (APPC/LU6.2) Programming Interface for OpenVMS (the APPC product) is a layered software product that allows user-written applications running on suitably configured OpenVMS systems, either within a DECnet[TM] network or running OpenVMS SNA software, to exchange messages with cooperating applications in an IBM[R] host. The APPC software ex- ists in the OpenVMS system as a shareable image. Access between the cooperating Compaq and IBM applications is via one of the following products: TCP/IP or DECnet Connections o DIGITAL SNA Peer Server o DIGITAL SNA Domain Gateway o DIGITAL SNA Access Server for Windows NT[R] DECnet Only Connections o DECnet SNA Gateway for Synchronous Transport o DECnet SNA Gateway for Channel Transport November 1998 AE-ET90K-TE Single OpenVMS VAX System o OpenVMS SNA (VAX only) The APPC product is a set of subroutines that 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 o Supply session-level security and inbound conversation level security o Allow outbound conversation allocation o Notify the user application of session failure o Notify the user application of conversation deallocation (not applicable to DIGITAL SNA Access Server for Windows NT) 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. 2 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 OpenVMS 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 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 3 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 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 4 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 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 5 User Interface Users of the APPC product should be experienced OpenVMS application programmers. They can use any of the OpenVMS programming languages that conform to the OpenVMS Calling Standard to create application programs that interact with application programs on an IBM system. The user doc- umentation 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 Users of the APPC product are not required to have a knowledge of SNA. INSTALLATION Installation services from Compaq are recommended for a customer's first purchase of the software product. These services provide for instal- lation of the software product by an experienced software specialist. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all prerequisite software and hardware, including terminals. o Have demonstrated, to Compaq's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway and the APPC programming interface. 6 o Make available for a reasonable period of time, as mutually agreed by Compaq and the customer, all hardware, communications facili- ties, and terminals that are to be used during installation. Installation service is available on a time and material basis. Con- tact your local Compaq office for more detailed information. HARDWARE REQUIREMENTS Processors Supported DIGITAL Alpha, VAX, MicroVAX[TM], VAXstation[TM], or VAXserver[TM] con- figuration as specified in the OpenVMS Operating System for Alpha and VAX Software Product Description (SPD 25.01.xx). Disk Space Requirements (Block Cluster Size = 1) Disk space required for installation: OpenVMS Alpha 18,000 blocks (9.0 MB) OpenVMS VAX 17,900 blocks (9.0 MB) Disk space required for use (permanent): OpenVMS Alpha 7,900 blocks (4.0 MB) OpenVMS VAX 6,800 blocks (3.4 MB) These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. 7 SOFTWARE REQUIREMENTS The DIGITAL SNA APPC/LU6.2 Programming Interface for OpenVMS requires the following software configurations: For OpenVMS Alpha Systems o OpenVMS Operating System for Alpha and VAX, Version 6.2 or 7.1 with Y2K Patches (SPD 25.01.xx) o DECnet for OpenVMS AXP[TM] (SPD 42.25.xx) o DIGITAL TCP/IP Services for OpenVMS (SPD 46.46.xx) o DIGITAL SNA Peer Server (SPD 51.08.xx) For OpenVMS VAX Systems in an SNA Gateway Environment o OpenVMS Operating System for Alpha and VAX, Version 6.2 or 7.1 with Y2K Patches (SPD 25.01.xx) o DECnet for OpenVMS VAX and Alpha (SPD 48.48.xx) o DIGITAL SNA Peer Server (SPD 51.08.xx) o DEC[TM] TCP/IP Services for OpenVMS VAX (SPD 25.A4.xx) Required SNA Gateway One of the following SNA gateways is required: o DECnet SNA Gateway for Channel Transport (SPD 29.76.xx) o DECnet SNA Gateway for Synchronous Transport (SPD 25.C6.xx) o DIGITAL SNA Domain Gateway (SPD 38.69.xx) o DIGITAL SNA Peer Server (SPD 51.08.xx) o DIGITAL SNA Access Server for Windows NT (SPD 64.79.xx) For OpenVMS VAX Systems in an OpenVMS SNA Environment o OpenVMS Operating System for Alpha and VAX, Version 6.2 or 7.1 with Y2K Patches (SPD 25.01.xx) o OpenVMS SNA Software (SPD 27.01.xx) 8 SOFTWARE LICENSING This software is furnished only under a license. For more information about Compaq's licensing terms and policies, contact your local Compaq 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 Operating System for Alpha and VAX Software Product Descrip- tion (SPD 25.01.xx) or the License Management Facility manual of the OpenVMS Operating System documentation set. For more information about Compaq's licensing terms and policies, con- tact your local Compaq office. GROWTH CONSIDERATIONS The minimum hardware and software requirements for any future version of this product may be different from the requirements for the cur- rent version. DISTRIBUTION MEDIA For Alpha Systems This product is available as part of the OpenVMS Alpha Software Product Library on CD-ROM. The software documentation for this product is available as part of the OpenVMS Alpha Online Documentation Library on CD-ROM. Documenta- tion in hardcopy format can be ordered separately. 9 For VAX Systams This product is available as part of the OpenVMS VAX Software Prod- uct Library on CD-ROM. The software documentation for this product is also available as part of the OpenVMS VAX Online Documentation Library on CD-ROM. Documen- tation in hardcopy format can be ordered separately. YEAR 2000 READY The product was installed on a test machine and the system date was set so that the rollover to 1-JAN-2000 and date handling in the twenty- first century were observed to work correctly. SOFTWARE WARRANTY This software is provided by Compaq with a 90-day conformance warranty in accordance with the Compaq warranty terms applicable to the license purchase. WARRANTY LIMITATIONS IBM Supported Configurations This software has been tested and is warranted against IBM System/370[TM] and IBM System/390[R] (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, Compaq cannot of- fer its standard warranty for this software unless it has been tested with such equipment and software configurations. The APPC product can interoperate with the following IBM software: 10 Table 1: IBM Software Configurations ___________________________________________________________________ Software Product Version Release ___________________________________________________________________ CICS/VSE[R] 2 All CICS/ESA[R] 4 1.0 Transaction Server All All ACF/VTAM[R] 4 4.0 Communications Server All All ___________________________________________________________________ Since the introduction of this software, other configurations may have been tested. Please contact your local Compaq office for up-to-date information regarding listed configurations. NOTE: Compaq will support IBM software configurations, version and re- lease numbers, as long as support for such configurations is gener- ally available from IBM. ORDERING INFORMATION For OpenVMS Alpha Software Licenses: QL-10SA*-** Software Documentation: QA-022AA-GZ Software Product Services: QT-10SA*-** Media and documentation for this product are available on the OpenVMS Alpha Software Product Library and Online Documentation Library on CD-ROM. Documentation in hardcopy 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*-** 11 Media and documentation for this product are available on the OpenVMS VAX Software Product Library and Online Documentation Library on CD-ROM. Documentation in hardcopy format can be ordered separately. * Denotes variant fields. For additional information on available li- censes, services, and media, refer to the appropriate price book. The above information is valid at time of release. Please contact your local Compaq office for the most up-to-date information. SOFTWARE PRODUCT SERVICES A variety of service options are available from Compaq. For more information, contact your local Compaq office. [R] IBM, CICS/ESA, CICS/VSE, System/390, and VTAM are registered trademarks of International Business Machines Corporation. [R] Windows NT is a registered trademark of Microsoft Corporation. [TM] System/370 is a trademark of International Business Machines Corporation. [TM] AXP, DEC, DECnet, DIGITAL, MicroVAX, OpenVMS, VAX, VAXserver, VAXstation, and VMS are trademarks of Compaq Computer Corporation. Compaq and the Compaq logo are registered in the United States Patent and Trademark Office. Other product names mentioned herein may be trademarks and/or registered trademarks of their respective companies. © 1998 Compaq Computer Corporation. All rights reserved. 12