CDWindows Release Notes
CDWindows Release Notes
Version 4.6.00
Release Notes
This edition applies to the 4.6.00 Version of IBM Sterling Connect:Direct for Microsoft Windows and to all subsequent releases and
modifications until otherwise indicated in new editions.
Before using this information and the product it supports, read the information in “Notices” on page 15.
Requirements 5
Improvements to Documentation 8
Special Considerations 8
Known Restrictions 9
Installation Notes 11
Upgrading Guidelines 12
Documentation Updates 14
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 3
Contents
Notices 15
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
IBM Sterling Connect:Direct for Microsoft
Windows Version 4.6.00 Release Notes
The IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes document
supplements IBM® Sterling Connect:Direct® for Microsoft Windows version 4.6 documentation
and the documentation for the following Sterling Connect:Direct for Microsoft Windows related
software: IBM Sterling Connect:Direct Requester, IBM Sterling Connect:Direct File Agent, and
IBM Sterling Connect:Direct Secure Plus. Release notes are updated with each release of the
product and contain last-minute changes and product requirements, as well as other information
pertinent to installing and implementing Sterling Connect:Direct. Read the document in its entirety
before installation.
The Sterling Connect:Direct package consists of the distribution media, and product publications.
Requirements
Sterling Connect:Direct for Microsoft Windows has the following requirements.
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 5
Requirements
Microsoft TCP/IP Support Token ring or ethernet Microsoft TCP/IP WinSOCK interface installed as part of
interface card the Windows system
Database Software Install one of the following before you install Sterling
Connect:Direct:
Microsoft SQL Server Express 2008 SP1, provided as
a separate installation with Sterling Connect:Direct.
Microsoft SQL Server 2005 or 2008—This software is
not provided. You can configure SQL Server during
the Sterling Connect:Direct installation.
MySQL Community Edition 5.5 with My SQL
Connector-ODBC 3.51 (x86, 32-bit version)
Download the software from the MySQL Community
website at
http://www.mysql.com/products/community/.
Note: Local-domain access must be available to
Microsoft SQL Server.
For more information, see the IBM Sterling Connect:Direct
for Microsoft Windows Getting Started Guide.
6 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
Features and Enhancements
Sterling Connect:Direct Same as requirements for Same requirements as Sterling Connect:Direct for
File Agent Sterling Connect:Direct for Microsoft Windows
Microsoft Windows
Sterling Connect:Direct Same as requirements for Same requirements as Sterling Connect:Direct for
Requester Sterling Connect:Direct for Microsoft Windows
Microsoft Windows Clustering is not supported. Refer to the Cluster
Service Guide on Support On Demand.
Sterling Connect:Direct Same as requirements for Microsoft Visual C++ 2008 to build the C++ samples
for Microsoft Windows Sterling Connect:Direct for Microsoft Visual Basic 2008 to build the Visual Basic
SDK Microsoft Windows samples
Note: This software is required to build the samples,
but is not required to run the samples.
4.6 Remove support for MySQL is no longer installed with Sterling Connect:Direct.
MySQL
Support Microsoft SQL Microsoft SQL Server Express 2008 SP1 is provided with Sterling
Server Express Connect:Direct but must be installed separately.
SHA-2 Support The following digests have been added to Sterling Connect:Direct
Secure Plus: SHA-224, SHA-256, SHA-384, SHA-512.
Session Start Record The Session Start Record (SSTR) on the PNODE now displays the
name and number of the first Process executing within a session.
Command Line Interface A new command line switch (-l) has been added to display longer
lines and not truncate information, such as long file names or
sysopts strings.
New SDK A new SDK supports Microsoft .NET languages C# and VB .NET.
Download this SDK from the Customer Center Portal.
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 7
Improvements to Documentation
Improvements to Documentation
IBM welcomes your suggestions for improvements to product documentation. As part of our
continuing effort to improve the user experience and satisfaction with our documentation, the
documentation for Sterling Connect:Direct for Microsoft Windows version 4.6 has the following
change:
The documentation set has moved to a new XML-based solution that will allow dynamic update
rather than require a major release for documentation updates.
Special Considerations
This section details special considerations to be aware of for your platform.
✦ The database retry feature retries a connection for up to eight minutes before a failure is
allowed to continue. When you use client applications like Sterling Connect:Direct Requester,
the application may appear to quit working. If this occurs, check the event log for database
errors indicating a retry is in progress. If the retry is unsuccessful, you may need to recycle the
Sterling Connect:Direct server.
✦ Microsoft SQL Server Express is not supported on Itanium 64 bit hardware. You may install
Microsoft SQL Server as your database by attaching to a remote SQL installation from the
Itanium computer.
✦ Microsoft SQL Server Express and Sterling Connect:Direct for Microsoft Windows must be
installed by the same user. To allow two different users to install the two components,
download Microsoft SQL Management Studio Express and modify the user configurations.
✦ Microsoft SQL Server Express fails to install when the computer name matches the user
account performing the installation. Install Microsoft SQL Server using a different user
account.
✦ If the SQL Server Express installation fails, look in the installation logs, located in the
Microsoft SQL Server installation directory\100\Setup Bootstrap\Log. A reboot may be
required to complete the installation. After you reboot the computer, start the installation
again. If this does not solve the issue, consult the Microsoft support site.
✦ By default, SQL Server Express allows only the installing user ID to access the message
lookup database. Add a user to the SQL Server Express database to allow access to
Connect:Direct for Windows by functional authorities and the message lookup utility. A login
failure occurs if no additional user is added.
✦ Following are the SQLServer2008Express installation defaults:
Installs to the Program Files directory on drive C.
Windows Authentication mode is enabled
The SA Account is disabled
The instance name is set to CDWindows
8 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
Known Restrictions
✦ To change the default authentication mode with SQL Server Express, install the product using
Tools, available from the Microsoft Website. Use Microsoft SQL Management Studio
included with Tools, to make authentication mode changes.
✦ SQL Server Express does not support clustering.
Known Restrictions
Sterling Connect:Direct for Microsoft Windows and its related software have the following known
restrictions.
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 9
Known Restrictions
Note: To disable temporary addresses in the Windows Vista OS, issue the following command
from a command prompt: netsh interface ipv6 set privacy state=disabled. For other
Windows operating systems, see the Microsoft Windows documentation.
After this warning is written to Sterling Connect:Direct statistics, the Process is allowed to
continue as if DESKTOP(NO) had been originally specified.
This transitional feature works only if the RUN TASK or RUN JOB is capable of running
without desktop interaction. That is, if manually switching DESKTOP(YES) to
DESKTOP(NO) would cause the Sterling Connect:Direct Process to fail, then the dynamic
switch to DESKTOP(NO) will not be an effective solution. If the program executed by the
RUN TASK/JOB is unable to execute without user interaction then that program must be
changed so that it no longer needs user interaction.
✦ Under conditions of high CPU usage, a Sterling Connect:Direct for Microsoft Windows
Process running over UDT may be interrupted by a lost connection. Should this occur, Sterling
Connect:Direct retries the Process. If connection losses due to high CPU usage are occurring,
their frequency can be reduced by restricting the number of concurrent UDT sessions through
netmap session limits.
✦ For Sterling Connect:Direct for Microsoft Windows version 4.6 to work using the UDT
protocol with Sterling Connect:Direct for z/OS 4.8.00, you must install a fix for the Sterling
Connect:Direct for z/OS server. Without this fix (T014159), the first time a Process is initiated
in Sterling Connect:Direct for Microsoft Windows using UDT, the Process fails with a
“Connection Broken” error. The RPLERRCK DD indicates the UDT error code of 2001.
10 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
Installation Notes
Sterling Connect:Direct The following functions are not supported for Sterling Connect:Direct
Requester Requester connected to a Sterling Connect:Direct for UNIX or OpenVMS
server:
Server initialization parameters (initparms) maintenance
Network map maintenance
User authorization management
Remote user proxies
List all users
New translation table
Selecting statistics by copy file name (No statistics are available for
OpenVMS servers.)
The following Trace facility options are not supported for Sterling
Connect:Direct Requester connected to Sterling Connect:Direct for UNIX or
OpenVMS servers:
Ability to wrap file
Ability to set maximum file size
Ability to do MAIN trace
Ability to trace by Process number, Process name, or destination
(advanced options)
Installation Notes
Before you install Sterling Connect:Direct for Microsoft Windows and its related applications, read
all the information in this section and follow all the guidelines.
✦ Complete any worksheets before installing Sterling Connect:Direct for Microsoft Windows
and its related software.
✦ For instructions on installing Sterling Connect:Direct for Microsoft Windows in a cluster
environment, refer to the white paper titled Cluster Service Guide, available at the following
link: http://customer.sterlingcommerce.com.
✦ Review your security configuration to ensure compatibility with IBM products.
✦ Verify that you have the current updates for Sterling Connect:Direct for Microsoft Windows,
Sterling Connect:Direct Requester, Sterling Connect:Direct File Agent, and Sterling
Connect:Direct Secure Plus for Microsoft Windows.
✦ Print and review IBM Sterling Connect:Direct for Microsoft Windows Getting Started Guide.
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 11
Upgrading Guidelines
Upgrading Guidelines
Observe the following guidelines for upgrading Sterling Connect:Direct for Microsoft Windows
and its related software. The procedure for applying patches is available in a whitepaper on the
Product Information page for Sterling Connect:Direct for Microsoft Windows at
http://customer.sterlingcommerce.com.
12 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
Upgrading Guidelines
Sterling The installation has changed from a single-user installation to all users. Any user
Connect:Direct who is logged on can start Sterling Connect:Direct Requester. Because the
Requester configuration is user specific, Sterling Connect:Direct Requester automatically
creates the base registry key if one does not exist.
Microsoft Installation (MSI) does not recognize Install Shield installations. Install
Shield and MSI cannot point to the same installation folder or you may have
problems uninstalling Sterling Connect:Direct. If you upgrade Sterling
Connect:Direct Requester, the installation copies the folders of the older version of
Sterling Connect:Direct Requester to the new installation directory before the new
version is installed. The new version overwrites existing files in the destination
folder.
Sterling When you upgrade Sterling Connect:Direct File Agent, it is installed as a service
Connect:Direct File on Windows using the Local System Account. If you change the user account for
Agent Sterling Connect:Direct File Agent after installation, each time you perform an
upgrade, you must change from the Local System Account to a different user
account for the service.
IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes 13
Documentation Updates
Documentation Updates
The Sterling Connect:Direct for Microsoft Windows version 4.6 documentation requires no
last-minute updates.
14 IBM Sterling Connect:Direct for Microsoft Windows Version 4.6.00 Release Notes
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 grant 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 character set (DBCS) information, contact the
IBM Intellectual
Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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,
This information is for planning purposes only. The information herein is subject to change
before the products described become available. This information contains examples of
data and reports used in daily business operations. To illustrate them as completely as
possible, the examples include the names of individuals, companies, brands, and products.
All of these names are ficticious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate
programming techniques on various operating platforms. You may copy, modify, and
distribute these sample programs in any form without payment to IBM, for the purposes of
developing, using, marketing or distributing application programs conforming to the
application programming interface for the operating platform for which the sample
programs are written. These examples have not been thoroughly tested under all conditions.
IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. The sample programs are provided "AS IS", without warranty of any kind. IBM
shall not be liable for any damages arising out of your use of the sample programs.
Each copy or any portion of these sample programs or any derivative work, must include a
copyright notice as follows:
© IBM 2010. Portions of this code are derived from IBM Corp. Sample Programs.
© Copyright IBM Corp. 2010.
If you are viewing this information softcopy, the photographs and color illustrations may
not appear.
Trademarks
The following terms are trademarks of the International Business Machines Corporation in
the United States, other countries, or both: http://www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks
or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
IT Infrastructure Library is a registered trademark of the Central Computer and
Telecommunications Agency which is now part of the Office of Government Commerce.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron,
Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks
of Intel Corporation or its subsidiaries in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or
both.
Microsoft Windows, Microsoft Windows NT, and the Microsoft Windows logo are
trademarks of Microsoft Corporation in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of the Office of
Government Commerce, and is registered in the U.S. Patent and Trademark Office.
UNIX is a registered trademark of The Open Group in the United States and other
countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United
States, other countries, or both and is used under license therefrom.
Linear Tape-Open, LTO, the LTO Logo, Ultrium and the Ultrium Logo are trademarks of
HP, IBM Corp. and Quantum in the U.S. and other countries.
Connect Control Center®, Connect:Direct®, Connect:Enterprise, Gentran®,
Gentran:Basic®, Gentran:Control®, Gentran:Director®, Gentran:Plus®,
Gentran:Realtime®, Gentran:Server®, Gentran:Viewpoint®, Sterling Commerce™,
Sterling Information Broker®, and Sterling Integrator® are trademarks or registered
trademarks of Sterling Commerce, Inc., an IBM Company.
Other company, product, and service names may be trademarks or service marks of others.