DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.02 Interface for DIGITAL UNIX[R], Version 3.2 This SPD describes the DIGITAL[TM] SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX[R] product, which is available for the DIGITAL UNIX platform. DESCRIPTION The DIGITAL SNA Advanced Program-to-Program Communications/Logical Unit 6.2 (APPC/LU6.2) Programming Interface for DIGITAL UNIX product is a layered software product that allows user-written applications running on suitably configured DIGITAL UNIX systems, either within a TCP/IP or DECnet[TM] network environment, to exchange messages with cooperating applications on an IBM[R] host. The APPC software exists in the DIGITAL UNIX system as two executable images, two shareable objects, and two static archives. Access between the cooperating DIGITAL and IBM applications is via one of the following products: o DIGITAL SNA Peer Server (TCP/IP or DECnet) o DIGITAL SNA Domain Gateway for Channel Transport (TCP/IP or DECnet) o DIGITAL SNA Domain Gateway for Synchronous Transport (TCP/IP or DECnet) o DEC SNA[TM] Gateway for Channel Transport (DECnet only) o DEC SNA Gateway for Synchronous Transport (DECnet only) April 1998 AE-QQW6C-TE The APPC product includes a set of subroutines called by DIGITAL UNIX programs that act as LU6.2 transaction application programs. These subroutines allow a DIGITAL UNIX 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 local LU, remote LU, mode, and transaction program parameters o Supply program initialization parameters o Supply session-level security and conversation-level security o Allocate a conversation in response to an allocation request from a partner transaction program Features The APPC product provides features to assist the user in writing and executing the DIGITAL UNIX 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. The APPC product performs all the SNA functions on the user's behalf. However, users must understand binds, mode parameters, and generalized data stream (GDS) level information. The APPC product comprises verbs that are defined to make the individual subroutine calls correspond to the verbs defined in the IBM manuals SNA Transaction Programmer's Reference Manual for LU Type 6.2 and CPI-C Programmer's Reference Manual. This makes it easier for IBM application-level programmers to code DIGITAL UNIX LU6.2 programs. The APPC product implements both the basic and mapped conversation verb set using the same procedure calls. 2 The APPC product supports parallel sessions and single session communication. The APPC product provides facilities for configuration, monitoring, and controlling the APPC/LU6.2 sessions. Both sets of verbs support blocking and nonblocking operation and thread reentrant usage. The following sections describe the supported and unsupported verbs. Supported Verbs The following basic and mapped conversation verbs are supported: o Allocate o Confirm o Confirmed o Deallocate o Flush o Get_attributes o Get_tp_properties o Get_type 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 Test o Wait 3 o Wait_for_completion The following control operator verbs are supported: o Activate_session o Change_session_limit o Deactivate_conv_group o Deactivate_session o Define_local_lu o Define_mode o Define_remote_lu o Define_tp o Delete o Display_local_lu o Display_mode o Display_remote_lu o Display_tp o Initialize_sess_limit o Process_session_limit o Reset_session_limit The following product-specific verbs are supported: o As2eb o Attach_listen o Cancel_conversation o Eb2as o Free_mem o Get_event 4 o Get_log_data o Get_message o Get_pip o Pass_resource o Receive_allocate Refer to the APPC product documentation for complete descriptions of the use of these verbs. Unsupported Verbs The following basic and mapped conversation verbs are not supported: o Backout o Receive_expedited_data o Send_expedited_data o Set-syncpt_options o Syncpt The following additional verbs are not supported: o Display_signed_on_list o Process_sign_off o Sign_off Supported CPI-C 1.2 Calls The following CPI-C 1.2 calls are supported: o Accept_Conversation o Accept_Incoming o Allocate o Cancel_Conversation o Confirm 5 o Confirmed o Convert_Incoming o Convert_Outgoing o Deallocate o Extract_Conversation_Context o Extract_Conversation_State o Extract_Conversation_Type o Extract_Maximum_Buffer_Size o Extract_Mode_Name o Extract_Partner_LU_Name o Extract_Security_User_ID o Extract_Sync_Level o Extract_TP_Name o Flush o Initialize_Conversation o Initialize_For_Incoming o Prepare_To_Receive o Receive o Release_Local_TP_Name o Request_To_Send o Send_Data o Send_Error o Set_Conversation_Security_Password o Set_Conversation_Security_Type o Set_Conversation_Security_User_ID 6 o Set_Conversation_Type o Set_Deallocate_Type o Set_Error_Direction o Set_Fill o Set_Log_Data o Set_Mode_Name o Set_Partner_LU_Name o Set_Prepare_To_Receive_Type o Set_Processing_Mode o Set_Receive_Type o Set_Return_Control o Set_Send_Type o Set_Sync_Level o Set_TP_Name o Specify_Local_TP_Name o Test_Request_To_Send Received o Wait_For_Conversation User Interface Users of the APPC product should be experienced DIGITAL UNIX application programmers who are familiar with the C programming language to write an APPC application to communicate with programs on an IBM system. The user documentation provides example programs written in the native form of the C language. 7 INSTALLATION 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 Software Specialist. Customer Responsibilities Before installation of the software, the customer must: o Previously have installed all requisite hardware, including terminals. o Have generated, to DIGITAL's satisfaction, any necessary IBM host software that will be communicating with the SNA gateway 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 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 preinstallation activities. o The customer should be capable of modifying IBM component generation parameters to support the SNA gateway and the APPC Programming Interface. 8 HARDWARE REQUIREMENTS This product requires the following hardware: o An Alpha workstation or server running the DIGITAL UNIX Operating System. o Any properly configured SNA gateway as specified in this document. Refer to the DIGITAL UNIX Operating System Software Product Description (SPD 41.61.xx) for valid configurations and supported processors. SOFTWARE CONFIGURATION REQUIREMENTS The DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX requires the following software configurations: o DIGITAL UNIX Operating System Version 4.0 to Version 4.0D (SPD 41.61.xx) o One of the following SNA gateways: - DIGITAL SNA Peer Server (SPD 51.08.xx) - DIGITAL SNA Domain Gateway for Channel Transport (SPD 38.69.xx) - DIGITAL SNA Domain Gateway for Synchronous Transport (SPD 38.69.xx) - DEC SNA Gateway for Channel Transport (SPD 29.76.xx) - DEC SNA Gateway for Synchronous Transport (SPD 25.C6.xx) ORDERING INFORMATION DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, Development system Software Licenses: QL-4URA*-AA (traditional) QL-4URAM-*B (concurrent user) Software Documentation: QA-4UQAA-GZ Software Product Services: QT-4UR*-** 9 DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, Runtime system Software Licenses: QL-4UQA*-AA (traditional) QL-4UQAM-*B (concurrent user) Software Documentation: QA-4UQAA-GZ Software Product Services: QT-4UQ*-** * Denotes variant fields. For additional information on available licenses, services, and media, refer to the appropriate price book. Media and documentation for this product are available on the DIGITAL CD-ROM Software Library for DIGITAL UNIX. Documentation in hardcopy copy format can be ordered separately. Supported IBM Software Configurations The DIGITAL SNA APPC/LU6.2 product supports the following IBM soft- ware configurations. ___________________________________________________________________ Software Product Version Release ------------------------------------------------------------------- OS/390[TM] 1 3.0 2 4.0 2 5.0 MVS/ESA[TM] SP 5 1.0 5 2.0 5 2.1 5 2.2 VM/ESA[R] 1 2.2 2 1.0 2 2.0 ACF/VTAM[R] 3 4.2 4 3.0 4 4.0 10 ___________________________________________________________________ Software Product Version Release ------------------------------------------------------------------- ACF/NCP 4 3.1 (for 3725s) ACF/NCP 6 3.0 (for 3745s) 7 1.0 7 2.0 7 3.0 7 4.0 7 5.0 7 6.0 NPSI 3 4.0 3 6.0 3 7.0 3 8.0 OS/400[R] 3 6.0 3 7.0 4 4.1 4 4.2 CICS[R] 3 3.0 4 1.0 CICS Transaction 2 4.0 Server for OS/390 ___________________________________________________________________ SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more information, contact your local DIGITAL office. [R] CICS, IBM, OS/400, VM/ESA, and VTAM are registered trademarks of International Business Machines Corporation. 11 [R] UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. [TM] MVS/ESA and OS/390 are trademarks of International Business Machines Corporation. [TM] DEC, DECnet, DEC SNA, DIGITAL, and the DIGITAL logo are trademarks of Digital Equipment Corporation. © 1998 Digital Equipment Corporation. All rights reserved. 12