DIGITAL Software Product Description ___________________________________________________________________ PRODUCT NAME: DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 This SPD describes DIGITAL SNA APPC/LU6.2 Programming Interface for DIGITAL UNIX, 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 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 to exchange messages with cooperating applications in an IBM[R] host. The APPC software exists in the DIGITAL UNIX systems as 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) March 1997 AE-QQW6B-TE DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 The APPC product is a set of subroutines which are 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 TP names o Supply program initialization parameters o Supply session-level security and inbound conversation level security o Allow outbound conversation allocation 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 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 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 synchronous completion 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 3 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 o Wait 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 Eb2as o Free_mem o Get_Event o Get_Log_data 4 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 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 o Wait_for_completion 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 Confirm o Confirmed 5 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 o Convert_Incoming o Convert_Outgoing o Deallocate o Extract_Conversation_State o Extract_Conversation_Type 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 o Set_Conversation_Type o Set_Deallocate_Type o Set_Error_Direction 6 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 o Set_Fill o Set_Log_Data o Set_Mode_Name o Set_Partner_LU_Name o Set_Prepare_To_Receive_Type 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 Unsupported CPI-C 1.2 Calls The following CPI-C 1.2 calls are not supported: o Cancel_conversation o Extract_conversation_context o Extract_maximum_buffer_size o Set_processing_mode 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 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 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 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 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 (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[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 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 format can be ordered separately. Supported IBM Software Configurations The DIGITAL SNA APPC/LU6.2 product supports the following IBM software configurations. 10 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 ___________________________________________________________________ Software Product Version Release ___________________________________________________________________ MVS/ESA SP 5 1.0 5 2.0 5 2.1 5 2.2 VM/ESA 1 2.2 2 1.0 2 2.0 ACF/VTAM[TM] 3 4.2 4 2.0 4 3.0 ACF/NCP (for 4 3.1 3725s) ACF/NCP (for 6 3.0 3745s) 7 1.0 7 2.0 7 3.0 7 4.0 7 5.0 NPSI 3 4.0 3 6.0 3 8.0 OS/400[R] 3 6.0 3 7.0 CICS[TM] 3 3.0 ____________________4__________1.0_________________________________ SOFTWARE PRODUCT SERVICES A variety of service options are available from DIGITAL. For more information, contact your local DIGITAL office. 11 DIGITAL[TM] SNA APPC/LU6.2 Programming SPD 56.11.01 Interface for DIGITAL UNIX[R], Version 3.1 [R] IBM and OS/400 are registered trademarks of International Business Machines Corporation. [R] UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. [TM] CICS and VTAM are trademarks of International Business Machines Corporation. [TM] DEC, DECnet, DEC SNA, DIGITAL, and the DIGITAL logo are trademarks of Digital Equipment Corporation. © 1997 Digital Equipment Corporation. All rights reserved. 12