 






     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
