IBM Remote API Client for Windows v6.4.0.0 INSTALLATION AND RELEASE NOTES 5724-I33, 5724-I34, 5765-E51 * © Copyright International Business Machines Corp. 2003, 2009 * All Rights Reserved * Licensed Material - Property of IBM * * US Government Users Restricted Rights - Use, duplication or * disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Table of Contents ----------------- 1. About this release 1.1 New in this release 1.2 Product fix history 1.3 Product compatibility 1.4 Viewing the Documentation 2. Installation information 2.1 Hardware requirements 2.2 Software requirements 2.2.1 Operating system version 2.3 Installation process 2.3.1 Installing the IBM Remote API Client for Windows 2.3.2 Installing the Win32 SDK 2.3.3 'Silent' installation 2.3.4 Possible Errors 3. Uninstallation information 4. Documentation updates 5. Notices and trademarks 5.1 Notices 5.2 Trademarks 1. About this release ---------------------- IBM Remote API Client for Windows provides a remote SNA API for 32-bit Intel based Windows systems, allowing it to connect to a domain of IBM Communications Server for Linux v6.4.0 (or later) servers or a domain of CS/AIX v6.4.0 (or later) servers via TCP/IP. 1.1 New in this release ------------------------ This release includes enhancements for: - Server enhancements to improve connectivity over IP: Enterprise Extender, HPR/IP, enhancements for Progressive ARB. Path Switch Delay support - Client support for the latest Java 5 and Java 6 releases. - The "Advanced..." panel in the Configuration Utility allows you to select Exception logging, Audit logging, Tracing for API tracing. 1.2 Product fix history ------------------------ Please check the web sites: http://www.ibm.com/software/network/commserver/aix http://www.ibm.com/software/network/commserver/linux http://www.ibm.com/software/network/commserver/support for the latest information about this product. You can use the public newsgroups: news://news.software.ibm.com/ibm.software.commserver.aix news://news.software.ibm.com/ibm.software.commserver.linux for informal Question & Answer support. 1.3 Product compatibility -------------------------- The IBM Remote API Client for Windows requires one of: Microsoft Windows 2000 Microsoft Windows XP Microsoft Windows 2003 Microsoft Windows Vista Microsoft Windows 2008 1.4 Viewing the Documentation ------------------------------ The documentation is available on the first CD in the 'DOCS' subdirectory in PDF format. See the README file for the associated server for details. The documentation is also available on the Internet at: http://www.ibm.com/software/network/commserver/library 2. Installation information ---------------------------- The IBM Remote API Client for Windows is packaged as self-extracting .exe files on the Remote API Clients CD containing this README file, the client code, and the licensing tool. This file has details for the IBM Remote API Client for Windows If you are installing the client on a different platform see the README file in the proper ibm-commserver-clients subdirectory on the Remote API Clients CD. If you are installing one of the server components see the appropriate README file in the root directory on the server CD of the install media. 2.1 Hardware requirements -------------------------- IBM Remote API Client for Windows requires Pentium III or later 32-bit Intel system supported by one of the Microsoft Windows operating systems listed in section 2.2.1 Operating system version. 2.2 Software requirements -------------------------- 2.2.1 Operating system version ------------------------------------- This version of IBM Remote API Client for Windows has been tested with the following operating system versions. Microsoft Windows XP Professional Microsoft Windows Server 2003 Standard Edition, Enterprise Edition Microsoft Windows Vista Microsoft Windows Server 2008 2.3 Installation process ------------------------- 2.3.1 Installing the IBM Remote API Client for Windows ------------------------------------------------------ If you have a previous level of IBM Remote API Client for Windows already installed, follow the steps in section 3 to remove it before installing this new level. Any old configuration information will be removed and will have to be re-entered when the new install is done. - To install the 6.4.0.0 level of the IBM Remote API Client for Windows: 1. Copy the i_w32cli.exe file to your computer. This file is on the Remote API Clients CD in the ibm-commserver-clients/windows directory. The copy must be done in binary mode. For example, use "ftp" with the binary mode command. 2. Run this file which will unpack itself and start the installer program. 3. When the install has completed, you can delete the i_w32cli.exe file from the working directory. 2.3.2 Installing the Win32 SDK ------------------------------- To install the Win32 SDK, complete the steps as described above but choose "Developer" as the Setup Type. 2.3.3 'Silent' installation ---------------------------- To get a completely silent (no prompts) installation on Windows Vista or 2008 you must run the setup program with at least these parameters set: setup.exe -i -accept -s from a Windows Command Prompt which has administrator authority. 2.3.4 Possible Errors ---------------------- If running i_w32cli.exe produces an error such as "This program cannot be run in DOS mode.", this typically means that the i_w32cli.exe file has been copied to your computer using an ASCII copy, not a binary copy. Check the sizes of the file in the two locations. If a binary copy was done, they will be the same size; if the sizes are different, then try the copy of the i_w32cli.exe file again. If an install window is 'buried' or hidden underneath other windows, use the ALT+TAB keyboard sequence to find the current window. If you see a message during uninstall like: RUNDLL Error loading Ctor.dll then simply install the IBM Remote API Client for Windows again, then the uninstall will be able to complete. To avoid getting that error, reboot the Windows system after installing or uninstalling the IBM Remote API Client for Windows. 3. Uninstallation information ------------------------------ Close the IBM Remote API Client for Windows Monitor program if it is running. It can be stopped from the taskbar by right-clicking on the Monitor icon. Using an Administrator priveledged command prompt, stop the Remote API client service, "net stop sxclient". To uninstall the Windows client using system control panels, select the Windows "Add or Remove Programs" utility to remove the IBM Remote API Client for Windows: Start -> Settings -> Control Panel -> Add or Remove Programs To uninstall the Windows client using a command line prompt, start a command prompt as with Administrator rights. The issue this command: \ibmcs\w32cli\sxcluninst -y. Reboot the Windows system to remove in-memory DLLs. See the "Quick Beginnings" manual for more information. When the IBM Remote API Client for Windows is uninstalled its configuration information will be removed from the Windows registry, so it will have to be re-configured when installed again. 4. Documentation updates ------------------------- See the "WhatsNew6400.txt" file in the root of the CD for more details. 5. Notices and trademarks -------------------------- 5.1 Notices ------------ This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation P.O. Box 12195 3039 Cornwallis Road Research Triangle Park, NC 27709-2195 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. 5.2 Trademarks -------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: Advanced Peer-to-Peer Networking AIX Application System/400 AS/400 CICS IBM MQSeries MVS MVS/ESA MVS/XA NetView OpenPower OS/2 Power5 pSeries S/390 SP System p System x System z System/370 System/390 SAA Systems Application Architecture VTAM WebSphere z/OS z9 zSeries The following terms are trademarks or registered trademarks of other companies: Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc., in the United States, other countries, or both. UNIX is a registered trademark in the United States and other countries licensed exclusively through The Open Group. Intel and Pentium are trademarks of Intel Corporation. AMD64 is a trademark of Advanced Micro Devices, Inc. Linux is a trademark of Linus Torvalds. Microsoft, Windows, Windows NT, Windows XP, Windows 2003, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others.