ECPI-C (Enhanced CPI-C)

IBM License Agreement for ECPIC IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. International Business Machines corporation grants you a license to use the Program only in the country where you acquired it. The Program is copyrighted and licensed (not sold). We do not transfer title to the Program to you. You obtain no rights other that those granted you under this license. Under this license, you may: 1. use the Program on one or more machines at a time; 2. make copies of the Program for use or backup purposes within your Enterprise; and 3. modify the Program and merge it into another program. You must reproduce the copyright notice and any other legend of ownership on each copy or partial copy, of the Program. Except as expressly provided in the DAPTOOLS LIBRARY License Agreement (TOOLIC.TXT), you may NOT: 1. distribute the program in any manner, including through electronic bulletin board systems or other means; 2. sublicense, rent, lease, or assign the Program; and 3. reverse assemble, reverse compile, or otherwise translate the object code of the Program. We do not warrant that the Program is free from claims by a third party of copyright, patent, trademark, trade secret, or any other intellectual property infringement. Under no circumstances are we liable for any of the following: 1. third-party claims against you for losses or damages; 2. loss of, or damage to, your records or data; or 3. economic consequential damages (including lost profits or savings) or incidental damages, even if we are informed of their possibility. Some jurisdictions do no allow these limitations or exclusions, so they may not apply to you. We do not warrant uninterrupted or error free operation of the Program. We have no obligation to provide service, defect correction, or any maintenance for the Program. We have no obligation to supply any Program updates or enhancements to you even in such are or later become available. IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. You may terminate this license at any time. We may terminate this license if you fail to comply with any of its terms. In either event, you must destroy all your copies of the Program. You are responsible for the payment of any taxes resulting from this license. You may not sell, transfer, assign, or subcontract any of your rights or obligations under this license. Any atdttempt to do so is void. Neither of us may bring a legal action more than two years after the cause of action arose. If you acquired the Program in the United States, this license is governed by the laws of the State of New York. If you acquired the Program in Canada, this license is governed by the laws of the Province of Ontario. Otherwise, this license is governed by the laws of the country in which you acquired the Program. ----------------------------------------------------------------------------- ECPI-C (Enhanced CPI-C) Version 1.3 DESCRIPTION: ECPI-C is a version of the portable CPI-C code base common to several IBM products (see below). ECPI-C is the beta test vehicle for new function in the CPI-C kernel. ECPI-C currently offers most of the CPI-C 1.2 and some CPI-C 2.0 calls. Some features include: - Full-duplex support (native and simulated). ECPI-C has been tested with CM/2 1.1 for native full-duplex support. ECPI-C will also, at application request, offer simulated support of full-duplex communications on/to older LUs. - Non-blocking support (native and simulated). ECPI-C has also been tested with CM/2 1.1 for native support of CPI-C 2.0 non-blocking calls. ECPI-C will transparently support the use of non-blocking calls if the LU is not capable. - New CPI-C 1.2 Calls. Accept_Incoming, Convert_Incoming, Convert_Outgoing, Extract_Conversation_Context, Extract_Maximum_Buffer_Size, Extract_TP_Name, Initialize_For_Incoming, Release_Local_TP_Name, Specify_Local_TP_Name. The following CPI-C 1.2 calls will return CM_FUNCTION_NOT_SUPPORTED: Cancel_Conversation, Set_Processing_Mode, Wait_For_Conversation. - New CPI-C 2.0 Calls. Extract_Send_Receive_Mode, Set_Queue_Processing_Mode, Set_Send_Receive_Mode, Wait_For_Completion. The following CPI-C 2.0 calls will return CM_FUNCTION_NOT_SUPPORTED: Set_Queue_Callback_Function, Extract_Secondary_Information, Set_Partner_ID, Extract_Partner_ID. The distributed security calls, OSI-TP functions, and CPI-RR functions are also not supported. - New Extension Call. Cancel_Wait_For_Completion. Please report any problems to the CPICPGMS FORUM or directly to the developers, listed below. Your feedback is appreciated! PRODUCT AVAILABILITY: The following products use the portable CPI-C code base. - Person-to-Person Desktop Conferencing for APPC Functions used: full-duplex, non-blocking. Product shipped 1/94. - AnyNet/2 NetBEUI over SNA Functions used: non-blocking. - Communications Manager/2 1.2 - SNA for Workplace OS The following enhancements are in plan for portable CPI-C: - 32-bit - Complete CPI-C 1.2 function - Complete CPI-C 2.0 base function OTHER TESTED APPLICATIONS: The following programs were used to test ECPI-C's new function. - IOTS. Upgraded with all the new CPI-C 1.2 calls and some CPI-C 2.0 calls. Regression testing has been completed. - JQCPIC. Upgraded to randomly stress test the full-duplex and non-blocking functions. - MERIT. Series of client-server test TPs. CONTACT NAMES: Feel free to contact the developers with any questions and concerns. - Joe Belna JBELNA at RALVM5 - Jeff Hicks HICKSJ at RALVM5 - Erik Erikson ERIKSON at RALVM6 - John Broughton JCB at RALVM6 - Richard Gray RLGRAY at RALVM6 OS2TOOLS HISTORY: Date Version Description 8/27/93 0.9 Initial beta release 9/14/93 0.94 Refresh beta release - ECPI-C now gets its own memory; no longer uses the CM/2 mem mgr - fixed 0-byte send/receive bug - fixed CPIC.H brackets problem - linted ECPI-C - checked ECPI-C for memory leaks - BURP returns help if invoked with no parms - announcement on forums 10/18/93 1.00 Official release - fixed mangled BURP source listing in doc - ECPI-C supports X/Open fdx sim proposal - scrubbed documentation - added Set_Partner_ID, Extract_Partner_ID stubs (check parms, return FUNC_NOT_SUPP) - re-added Initialize_Conversation_For_TP, Start_TP, End_TP - removed support for Cancel_Conversation pending LU support - moved all OS/2 calls to utilities file - isolated twin-piping code - verified code over CM/2 1.1 - passed all IOTS cases in test - stable under prolonged JQCPIC testing 11/24/93 1.10 Refresh release - merged with CM/2's CPI-C to form the portable CPI-C code base (Sisyphus) - isolated code that accesses internal data structures - revamped trace code - improved the performance of the non-blocking simulation 11/29/93 1.11 Refresh release - ECPIC.DLL did not have latest updates - added message files 02/10/94 1.3 Refresh release - Wait_For_Completion now handles more than 15 outstanding operations. Fairness algorithm implemented. - Dynamic data structure allocation. - Source code now object-based.