Software Product Description ________________________________________________________________ PRODUCT NAME: DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 DESCRIPTION The DECnet/SNA VMS Advanced Program-to-Program Communica- tions/LU6.2 Programming Interface (APPC) is a layered software product that allows user-written applications running on suit- ably configured VMS systems either within a DECnet network or running VMS/SNA software to exchange messages with cooperating applications in an IBM[R] host. The APPC software exists in the VMS system as a shareable image. Access between the cooperating Digital and IBM applications is via the DECnet/SNA Gateway or VMS/SNA software. The APPC product is a set of subroutines which are called by VMS programs which act as Logical Unit 6.2 (LU6.2) transaction application programs. These subroutines allow a VMS 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 DIGITAL November 1990 AE-ET90G-TE DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 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 writ- ing and executing the VMS transaction program. The APPC product performs the SNA communications function on the programmer's behalf, allowing the user to concentrate on solving the applica- tion problem rather than having to bother 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 individual subroutine calls correspond to the verbs defined in the IBM manual, SNA Transaction Programmers Reference Manual for Logical Unit 6.2. This makes it easier for IBM application level programmers to code VMS LU6.2 programs. The APPC product implements both the basic and mapped conversa- tion verb set using the same procedure calls. The VMS programmer may choose which type of conversation is desired by specify- ing the appropriate symbolic code in the TYPE parameter of the SNALU62$ALLOCATE procedure. Both sets of verbs can be synchronous or asynchronous. Asyn- chronous completion of verbs allows for multi-threaded applica- tions 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 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.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 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 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 descrip- tions 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 ses- sions are not supported. The following control operator verbs are not needed: o Change_session_limit 4 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 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 User Interface Users of the DECnet/SNA VMS APPC/LU6.2 product should be experi- enced VMS application programmers. They can use any of the VMS programming languages which conform to the VMS Calling Standard to create application programs which interact with applica- tion programs on an IBM system. The user documentation provides example programs written in the following languages: o MACRO-32 o VAX BASIC o VAX BLISS-32 o VAX C o VAX COBOL o VAX FORTRAN o VAX PASCAL o VAX PL/I The users of the APPC product are not required to have a knowl- edge of SNA. INSTALLATION 5 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 Digital requires that a customer's first purchase of this soft- ware product include Digital Installation Services. These ser- vices provide for installation of the software product by an experienced Digital Software Specialist. For subsequent purchases of this product, only experienced customers should attempt installation. Digital recommends that all other customers purchase Digital's Installation Services. 6 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all requisite hardware including terminals. o Obtain, install, and demonstrate as operational any modems and other equipment and facilities necessary to interface to Digital's communications 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 DECnet/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, communica- tions facilities, 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 systems personnel to coordinate the pre-installation activities. o The customer should be capable of modifying IBM component generation parameters to support the DECnet/SNA Gateway or VMS/SNA and the APPC Programming Interface. HARDWARE REQUIREMENTS VAX, MicroVAX, VAXserver or VAXstation configuration as speci- fied in the System Support Addendum (SSA 26.88.06-x). 7 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 OPTIONAL HARDWARE None SOFTWARE REQUIREMENTS* In a DECnet/SNA Gateway or VMS/SNA environment: o VMS Operating Systems In a DECnet/SNA Gateway environment: o DECnet-VAX In a VMS/SNA environment: o VMS/SNA OPTIONAL SOFTWARE* o DECnet/SNA VMS Gateway Management * Refer to the System Support Addendum for availability and required versions of prerequisite/optional software (SSA 26.88.06-x). ORDERING INFORMATION 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 avail- able licenses, services and media, refer to the appropriate price book. PREREQUISITE SUPPORT 8 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 A Network Profile and a DECnet Customer Support Plan (where applicable) covering all intended VMS nodes that wish to access the APPC Programming 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 DECnet/SNA Gateway or VMS/SNA configuration. To have a Digital supported DECnet/SNA Gateway configuration, purchase of Digital's Gateway Orientation/Installation Service is REQUIRED in conjunction with the customer's first purchase of the Gateway. Refer to the DECnet/SNA Gateway SPDs (SPD 30.15.xx, SPD 29.C6.xx, SPD 29.76.xx) for further details. To have a Digital supported VMS/SNA system configuration, pur- chase of Digital's VMS/SNA Orientation/Installation Service is REQUIRED in conjunction with with the customer's first purchase of the VMS/SNA software. Refer to VMS/SNA (SPD 27.01.xx) for further details. SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more information about Digital's licensing terms and poli- cies, contact your local Digital office. 9 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 LICENSE MANAGEMENT FACILITY SUPPORT This layered product supports the VMS License Management Fa- cility. License units for this product are allocated on a CPU-capacity basis. For more information on the License Management Facility, refer to the VMS Operating System Software Product Description (SPD 25.01.xx) or the License Management Facility manual of the VMS Operating System documentation set. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase 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 (includes 30xx and 43xx series) class processor systems 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 offer its standard warranty for this software unless it has been tested with such equipment and software configurations. The following list shows the configurations with which the software has been tested and is warranted: ________________________________________________________________ Software Product_________Version_______Release___________________________ ACF/VTAM 3 1.2 3 2.0 10 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 ________________________________________________________________ Software Product_________Version_______Release___________________________ 3 2.1 3 3 MVS/SP 2 1.5 2 1.7 2 2.0 3 1.0 CICS/OS/VS 1 6.1 - 7 VSE/SP__________3_____________2.0_______________________________ SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information contact your local Digital office. [R] IBM is a registered trademark of IBM Corporation. 11 DECnet/SNA VMS APPC/LU6.2 Programming Interface, SPD 26.88.06 Version 2.2 [TM] AT&T and Data Phone are trademarks of American Telephone & Telegraph Company. [TM] Bell is a trademark of Bell Telephone Companies. [TM] The DIGITAL Logo, VAX, MicroVAX, VAXstation and VMS are trademarks of Digital Equipment Corporation. 12