=====================================================================

IBM® WebSphere® DataStage Pack for SAP R/3 v. 5.2.1

Release Notes and Legal Notices June 2006
=====================================================================
This document contains proprietary information of IBM. It is provided
under a license agreement and copyright law protects it. The
information contained in this publication does not include any
product warranties, and any statements provided in this manual should
not be interpreted as such.
You can order IBM publications online or through your local IBM
representative.
- To order publications online, go to the IBM Publications Center
at www.ibm.com/shop/publications/order
- To find your local IBM representative, go to the IBM Directory of
Worldwide contacts at www.ibm.com/planetwide
When you send information to IBM, you grant IBM a nonexclusive right
to use or distribute the information in any way it believes
appropriate without incurring any obligation to you.
© Copyright International Business Machines Corporation 2006. All
rights reserved.
US Government Users Restricted Rights -- Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
======================= END OF LEGAL NOTICES ========================

We recommend you review these release notes before you install

and use the IBM WebSphere DataStage Pack for SAP R/3.
This document is one source of complementary or late-breaking
information.
For this release, all changes to the documentation appear in this
readme file.
=====================================================================
CONTENTS
=====================================================================
1: Installation Notes
- New Unicode Statement
- Installation Prerequisites
* DataStage Product Requirements
* New SAP RFC SDK Product Requirements
* AIX Runtime Requirement
* SAP R/3 IDoc Client Component Requirement
- From the CD-ROM
2: Upgrading from an Earlier Version
3: New or Changed Behavior
4: Known Issues
5: Legal Notices

=====================================================================
1: INSTALLATION NOTES
=====================================================================
DataStage products include a simple installation program. Procedures
differ slightly based upon the product being installed and the
platform being used. However, specific instructions in the
installation program lead you through the details of the
installation.
NOTE Before installing a DataStage product, close any other
programs that may be running on your computer. Having other
programs running may cause installation errors.

UNICODE STATEMENT
-----------------
This release of the IBM WebSphere DataStage Pack for SAP R/3 is
designed to communicate with both SAP R/3 Unicode systems and SAP R/3
non-Unicode systems with respect to both inbound and outbound calls
for single-byte and multi-byte data.

INSTALLATION PREREQUISITES
--------------------------
DataStage Product Requirements
----------------------------------------
A full installation of the following valid products is required.
o IBM WebSphere DataStage Pack for SAP R/3
o IBM WebSphere DataStage version 7.5.2 with NLS installed
The IBM WebSphere DataStage Pack for SAP R/3 supports:
o Operating Systems:
- Microsoft Windows 2000 Service Pack 4
- Microsoft Windows Server 2003 Service Pack 1 (Standard, Enterprise)
DataStage Server only. Pack does not support DataStage Enterprise
Edition on Microsoft Windows platforms.
o DataStage version 7.5.2 with NLS installed
o SAP R/3 4.6C, R/3 Enterprise (Unicode), mySAP ERP ECC version
5.0 (Web AS 6.4) and ECC version 6.0 (Web AS 7.0)
Note: The IBM WebSphere DataStage Pack for SAP R/3 no longer supports
SAP R/3 versions 4.6B and 4.0B.

NEW SAP RFC SDK Product Requirements

-------------------------------------
This release provides Unicode support on all supported
platforms.
Before installing either the server or client components, download
from the SAP Service Marketplace:
1. For server: The latest version of both Unicode and
non-Unicode RFC SDK libraries specific to your DataStage
server platform. For platforms that have both a 32 bit and
 64 bit Unicode RFC SDK, download the 32 bit version.
2. For client: The latest version of both Unicode and non-Unicode
RFC SDK libraries for Microsoft Windows platform.
If the RFC SDK libraries are missing, the IBM WebSphere
DataStage Pack for SAP R/3 installer only detects this partially
and displays an appropriate warning message. The client component
will not proceed without this library. The server installer will
proceed after issuing a warning, however the installed server
components will not be functional.
To locate the libraries search for "RFC SDK" on the SAP Service
Marketplace. Only the librfc32.dll is required from non-Unicode
RFC SDK and all libraries including The International Component
for Unicode (ICU libraries) contained in Unicode RFC SDK's lib
directory are required to be copied to dshome/lib directory.
These libraries are required irrespective of whether you plan on
using the IBM WebSphere DataStage Pack for SAP R/3 against a
Unicode or non-Unicode SAP system.

AIX Runtime Requirement

-----------------------
On AIX for the IDoc extract pack runtime component, the latest
version of IBM XL C++ runtime libraries must be installed on your
AIX system. The latest version of the runtime library can be
downloaded from www.ibm.com/support:
http://www-1.ibm.com/support/docview.wss?uid=swg24012187.

SAP R/3 IDoc Client Component Requirement

-----------------------------------------
For the IDoc client component to provide the correct
description of the IDoc metadata, the SAP libraries that belong
to UNICODE RFC SDK release 640 for Windows, have to be installed
into the windows\system32 directory. The windows\system32
directory needs to be set into the system PATH environment variable.
If this RFC component is not present on the Client machine, then
the IDoc client component will communicate to SAP only in
non-Unicode, this can cause an invalid description of IDoc Unicode
metadata.

From the CD-ROM

---------------
The CD contains the following directories:
- client
This directory contains the user interface components. It is
installed by running the setup.exe program just like any
other DataStage custom GUI.
- packages
This directory contains the server side components.
 These are installed using the server setup.exe program or
by using the DataStage Package Installer.
- Readme
Contains this file.
- RFC
This directory contains files that must be installed on your
SAP R/3 system. Refer to the Integration Guide for how to install
the files.
- server
This directory contains the IBM WebSphere DataStage Pack for
SAP R/3 server components, including the IDoc server manager and
IDoc listener. These are installed by running the setup.exe
program. This install program will also install the DataStage
plug-in packages into each configured DataStage project.
- templates
This directory contains the prepackaged extraction jobs in
DataStage export files. There is one for ABAP extractions
and one for IDoc extractions.
- trans
This directory contains the cofiles and data files used with
the Transportation Management System.
Full installation and configuration instructions are included in
the integration guide, which is located in the client language
directory on the CD, for example client\enu\dsr3.pdf.
Note: If you have installed the Pack for SAP BW and the Pack for
SAP R/3, uninstalling either Pack will remove the "DataStage
Administrator for SAP client" icon from your desktop. To
start the application run "dsr3util.exe" located in your
DataStage Client install directory.

=====================================================================
2: UPGRADING FROM AN EARLIER VERSION
=====================================================================
An upgrade from an earlier release of the Pack is supported but in
certain situations the metadata may need to be refreshed. For example,
when upgrading your jobs from a non-Unicode SAP system to a Unicode SAP
system, you will need to refresh the metadata by selecting the
components (ABAP tables, IDocs or BAPIs) from the new SAP system.

=====================================================================
3: NEW OR CHANGED BEHAVIOR
=====================================================================
Support for all DataStage platforms.
Full Unicode support is included in this version of the IBM WebSphere
DataStage Pack for SAP R/3. The Pack has been tested to work for all
supported SAP versions, including both non-Unicode and Unicode SAP
versions.
In addition to adding Unicode support, other issues found in version
5.2 have been addressed in this release.

=====================================================================
4: KNOWN ISSUES
=====================================================================
The Pack plug-ins have not been optimized for parallel processing.
The following is a list of known issues that exist for this release:
PX Environment
------------------
All plug-in components may be freely used in the Enterprise (PX)
environment. The functionality is the same as the traditional
DataStage server environment, except as described below.
IMPORTANT!
The exception is the ability to launch IDoc extract jobs
automatically after a specified IDoc threshold is reached. This
feature of the IDoc Extract plug-in component is NOT available if the
plug-in is used in the PX (Enterprise) environment. Please configure
all IDoc Extract jobs to be scheduled and run directly via the
DataStage Director.
ecase 89923 Numeric SQL type on PX canvas may need to be set to
VarChar. If the SQL type is set as Numeric this results
in a date output of " 19960205." The date should be
"19960205", without the leading space and trailing '.'.
Changing the SQL type to VarChar results in the correct
format.

ABAP Extract
------------
ecase 18940 Generated ABAP program not inserted in the SAP
repository.

IDoc Extract
------------
ecase 66869 Unable to set "Automatic Cleanup and Archiving of IDoc
Files" option on DataStage Administrator for SAP.
Workaround: The PATH variable in the DataStage Windows
Server environment needs to be modified to put the MKS
Tool Kit path after the Windows path:
1. Right-click "My Computer" and select "Properties".
2. Click the "Advanced" tab.
3. Click "Environment Variables".
4. Select the "Path" variable from the System Variables
section.
5. Click "Edit".
6. Cut the MKS Tool Kit path from the beginning of the
entry, C:\PROGRA~1\MKSTOO~1\mksnt;
 and paste it at the end of the path.
7. Click OK in three separate windows and reboot the
machine.

All Components
--------------
This issue is generic and applies to all the components contained
in this release:
ecase 71193/39547 For additional information on IDOC and BAPI
authorizations and profiles contact your BASIS
administrator.

=====================================================================
5: LEGAL 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 (DBCS) information,
contact the IBM Intellectual Property Department in your
country/region or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan
The following paragraph does not apply to the United Kingdom or any
other country/region 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.
Any references in this information to non-IBM Web sites are provided
for convenience only and do not in any manner serve as an endorsement
of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product, and use of those Web sites is at
your own risk. 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 that has been exchanged, should contact:
IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
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 document 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.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating
environments may vary significantly. Some measurements may have been
made on development-level systems, and there is no guarantee that
these measurements will be the same on generally available systems.
Furthermore, some measurements may have been estimated through
extrapolation. Actual results may vary. Users of this document should
verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the
suppliers of those products, their published announcements, or other
publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility, or any
other claims related to non-IBM products. Questions on the
capabilities of non-IBM products should be addressed to the suppliers
of those products.
All statements regarding IBM's future direction or intent are subject
to change or withdrawal without notice, and represent goals and
objectives only.
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 fictitious, 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.
Each copy or any portion of these sample programs or any derivative
work must include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from
IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or
years_. All rights reserved.
Trademarks
The following terms are trademarks of International Business Machine
Corporation in the United States, other countries, or both:
IBM DataStage
Ascential DB2
Ascential AuditStage Informix
Ascential DataStage Iterations
Ascential Enterprise Integration Suite MetaBroker
Ascential MetaStage MetaStage
Ascential ProfileStage MVS
Ascential QualityStage OS/2
Ascential RTI WebSphere
Ascential Software
The following terms are trademarks or registered trademarks of other
companies:
Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Sun Microsystems, Inc. in the United States,
other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks
of Microsoft Corporation in the United States, other countries, or
both.
Intel, Intel Inside (logos), MMX and Pentium are trademarks of Intel
Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States
and other countries.
Linux is a trademark of Linus Torvalds in the United States, other
countries, or both.
Other company, product or service names might be trademarks or
service marks of others.
=====================================================================
END OF FILE
=====================================================================