Sybase Network Hardware R 3 User Manual

Installation Guide  
Adapter for SAP R/3  
Version 3.9  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Contents  
About This Book............................................................................................................................ v  
CHAPTER 1  
Example Log File..................................................................... 11  
Suggestions for Converting IDocs........................................... 11  
Example Conversion Tool Configuration File.......................... 12  
Converting BAPI Formats .............................................................. 14  
Upgrading Rules ............................................................................ 15  
CHAPTER 2  
Preparing the Installation Environment .......................................... 24  
Previous versions.................................................................... 24  
CIMRepository......................................................................... 25  
Temporary Installation Directory ............................................. 26  
Installing Adapter for SAP R/3 ....................................................... 26  
Understanding Environment Variables........................................... 32  
Installation Guide  
iii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Contents  
CHAPTER 3  
Uninstalling Adapter for SAP R/3................................................. 33  
Starting the Repository................................................................... 33  
Uninstalling Adapter for SAP R/3 3.9............................................. 34  
Uninstalling Shared Components................................................... 34  
Index ............................................................................................................................................. 37  
iv  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
About This Book  
Audience  
The primary user of this document is the system administrator who is  
responsible for the installation and configuration of the server used for  
New Era of Networks Adapter for SAP R/3 (Adapter for SAP R/3).  
How to use this book  
This document describes how to install Adapter for SAP R/3. These  
instructions provide information for both a new and an upgrade  
The guide is organized into the following chapters:  
“About This Book” provides documentation, technical support, and  
product education information.  
Chapter 1, “Migrating to Adapter for SAP R/3 Version 3.9” provides  
information to prepare for an upgrade installation.  
Chapter 2, “Installing Adapter for SAP R/3” provides steps to  
prepare for and run an adapter installation.  
Chapter 3, “Uninstalling Adapter for SAP R/3” provides the steps for  
uninstalling the product from the server.  
Related documents  
This section describes the available documentation for Adapter for SAP  
R/3.  
Cross-Platform Documentation The following documentation  
comprises the Adapter for SAP R/3 documentation set:  
Users Guide  
Feature Guide  
Installation Guide  
Related Documentation The following open transport documents and  
sample configuration files are referenced in this document set to supply  
you with specific information that supports this product:  
File Driver Configuration Guide, release 2.6  
MQ Series Driver Configuration Guide, release 2.6  
MSMQ Driver Configuration Guide, release 2.6  
Installation Guide  
v
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
JMS Driver Configuration Guide, release 2.6.1  
Tibco Driver Configuration Guide, release 2.6.1  
Other related documentation is available from New Era of Networks and  
Sybase. Refer to documentation from each of these companies for more detail  
about use of applications relevant to this product.  
Other sources of  
information  
Use the Sybase Technical Library CD and the Technical Library Product  
Manuals web site to learn more about your product:  
The Technical Library CD contains product manuals and is included with  
your software. The DynaText reader (included on the Technical Library  
CD) allows you to access technical information about your product in an  
easy-to-use format.  
Refer to the Technical Library Installation Guide in your documentation  
package for instructions on installing and starting the Technical Library.  
The Technical Library Product Manuals web site is an HTML version of  
the Technical Library CD that you can access using a standard web  
browser. In addition to product manuals, you will find links to  
EBFs/Updates, Technical Documents, Case Management, Solved Cases,  
newsgroups, and the Sybase Developer Network.  
To access the Technical Library Product Manuals web site, go to Product  
Sybase EBFs and  
software updates  
Finding the latest information on EBFs and software updates  
1
Point your web browser to the Sybase Support Page at  
2
Select EBFs/Updates. Enter user name and password information, if  
prompted (for existing web accounts) or create a new account (a free  
service).  
3
4
5
Select a product.  
Specify a time frame and click Go.  
Click the Info icon to display the EBF/Update report, or click the product  
description to download the software.  
vi  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
About This Book  
Creating a personalized view of the Sybase web site (including support  
pages)  
Set up a MySybase profile. MySybase is a free service that allows you to create  
a personalized view of Sybase web pages.  
1
Point your web browser to Technical Documents at  
2
Click MySybase and create a MySybase profile.  
Conventions  
The formatting conventions used in this manual are:  
Formatting example To indicate  
command names and  
method names  
When used in descriptive text, this font indicates  
keywords such as:  
Command names used in descriptive text  
C++ and Java method or class names used in  
descriptive text  
Java package names used in descriptive text  
Italic font indicates:  
myCounter variable  
Server.log  
myfile.txt  
Program variables  
Parts of input text that must be substituted  
Directory and file names.  
Book titles  
User Guide  
A backward slash (“\”) indicates cross-platform  
directory information. A forward slash (“/”)  
applies to information specific only to UNIX.  
sybase\bin  
Directory names appearing in text display in  
lowercase unless the system is case sensitive.  
“About This Book”  
File > Save  
References to chapter titles have initial caps and  
are enclosed within quotation marks.  
Menu names and menu items are displayed in plain  
text. The angle bracket indicates how to navigate  
menu selections, such as from the File menu to the  
Save option.  
The vertical bar indicates:  
parse|put|get  
Name|Address  
Options available within code  
Delimiter within message examples  
Monospace font indicates:  
create table  
Information that you enter on a command line  
or as program text.  
table created  
Example output fragments  
Installation Guide  
vii  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Formatting example To indicate  
Type the Name of the GUI field or button name that is the recipient of a  
attribute.  
procedural action.  
Click Apply.  
If you need help  
Each Sybase installation that has purchased a support contract has one or more  
designated people who are authorized to contact Sybase Technical Support. If  
you cannot resolve a problem using the manuals or online help, please have the  
designated person contact Sybase Technical Support or the Sybase subsidiary  
in your area.  
For more information on Support Services, education, and consulting services,  
refer to the Customer Services Reference Guide.  
viii  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C H A P T E R  
1
Migrating to Adapter for SAP R/3  
Version 3.9  
This chapter explains how to migrate data from an existing database used  
with a previous version of Adapter for SAP R/3 to a target database.  
Topic  
Page  
Process Overview  
1
Preparing for Upgrade  
3
Upgrading from Version 3.0.3 to Version 3.9  
Upgrading from Version 3.8 to Version 3.9  
Converting IDoc Formats  
Converting BAPI Formats  
Upgrading Rules  
3
2
3
5
14  
15  
Process Overview  
For Windows, Solaris, AIX, and HP-UX, the following procedures  
comprise the migration process:  
Transferring configuration information from the old configuration  
files to the new configuration files using Table 1-1 as a guide for key  
mapping.  
Running the IDoc format conversion tool (if applicable)  
Loading BAPI formats using the 3.9 adapter and map fields  
Installation Guide  
1
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Preparing for Upgrade  
Preparing for Upgrade  
Note Existing database refers to the database you are currently using.  
Target database refers to the database you will use with Adapter for SAP R/3  
version 3.9.  
Before migrating formats and rules from an existing database to your target  
database, verify the following:  
Existing database contains valid rules and formats.  
Integration Server is installed.  
Target database and temporary database are instantiated, contain no data,  
and allows sufficient space for rules and formats.  
Adapter for SAP R/3 version 3.9 is installed.  
Warning! When upgrading formats and rules to a target database, you  
must have three separate database instances: your existing database, a  
temporary database, and your target database. Do not attempt to rebuild  
your current database after exporting all the data.  
Upgrading from Version 3.0.3 to Version 3.9  
Upgrading from Adapter for SAP R/3 version 3.0.3 to version 3.9 consists of  
the following steps:  
Transfer user-specific configuration information from the version 3.0.3  
configuration files to version 3.9 configuration files.  
You can do this manually using the sample configuration files in the SAP-  
3_9/CFG folder or using the GUI. See “Changes to Configuration Keys”  
on page 3 for a table of changes to configuration keys between versions.  
Reload BAPI formats using Adapter for SAP R/3 version 3.9. You must  
crate new rules for these formats.  
Migrate IDoc formats using the procedure described in “Converting IDoc  
Formats” on page 5.  
2
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
           
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
Upgrading from Version 3.8 to Version 3.9  
Upgrading from Adapter for SAP R/3 version 3.8 to version 3.9 consists of the  
following steps:  
Transfer user-specific configuration information from the version 3.8  
configuration files to version 3.9 configuration files.  
You can do this manually using the sample configuration files in the SAP-  
3_9/CFG folder or using the GUI. See “Changes to Configuration Keys”  
on page 3 for a table of changes to configuration keys between versions.  
BAPI formats have not changed between versions 3.8 and 3.9. You can  
continue to use the BAPI formats you used with version 3.8.  
Migrate IDoc formats using the procedure described in “Converting IDoc  
Formats” on page 5.  
Changes to Configuration Keys  
If you use the GUI to import your pre-3.9 configuration files, some of the keys  
will be automatically mapped to the keys required by 3.9. You will have to  
make some manual changes to the configuration file before you use it.  
Alternatively, you can make all changes manually.  
Note Appendix A of the Adapter for SAP R/3 Users Guide contains a list of  
all currently valid configuration keys.  
The following keys and values must be changed in your configuration files.  
You can use the sample configuration files that are provided with the new  
installation. Manually transfer existing values for keys from your existing  
configuration files into the new configuration files based on the sample files  
provided.  
This list contains keys that are typically used in configuration files but may not  
be all of the keys you have used. See the Adapter for SAP R/3 Users Guide for  
a specific version for a complete list of configuration keys for that version.  
Table 1-1: Product Upgrade Keys and Mapping  
Version 3.0.3  
Version 3.8  
Version 3.9  
queue.mgr.name  
NNMQS_SES_OPEN_QMGR  
same as 3.8  
Installation Guide  
3
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Changes to Configuration Keys  
Version 3.0.3  
Version 3.8  
Version 3.9  
queue.in.name=TO_SAP  
NNOT_TIL_OPEN_TSI=TO_S same as 3.8  
AP  
queue.out.name=FROM_SAP  
failurequeue.name=FAILURE  
NNOT_TIL_OPEN_TSI=FRO  
M_SAP  
same as 3.8  
NNOT_TIL_OPEN_TSI=FAIL same as 3.8  
URE  
queue.empty_queue_wait_time transport.wait_time_milli  
_milli  
not used  
queue.empty_queue_wait_time transport.wait_time  
same as 3.8  
same as 3.8  
same as 3.8  
queue.exit_it_empty  
error.logfile  
transport.exit_if_empty  
no equivalent key  
Default error log is  
NNSYMessageLog.nml  
no.special.char  
no equivalent key  
sap.retry.count and  
sap.retry interval  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.8  
same as 3.8  
sap.reconnectAttempts  
sap.rfc.destination  
sap.client  
sap.destination  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
sap.trace  
sap.user  
sap.password  
sap.language  
sap.rfc.trace  
sap.logLevel  
same as 3.0.3  
same as 3.0.3  
sap.logFile  
Adapter.adapter  
NN.LinkMode  
same key but value has changed same as 3.8  
same as 3.0.3  
sap.linkMode  
sap.inboundMethod  
Adapter.batch.size  
sap.createIDocReport  
not used  
NN.InboundMethod  
NN.IDocBatchSize  
NN.CreateIDocReport  
NN.IDocTrace  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
same as 3.0.3  
NNLogFileName  
NN.VerboseLog  
MQS.QueueManagerName  
MQS.GetQueueName  
MQS.PutQueueName  
MQS.ErrorQueueName  
RFC.Destination  
same as 3.0.3  
sap.logFile  
same as 3.0.3  
sap.verboseLog  
same as 3.8  
NNMQS_SES_OPEN_QMGR  
NNOT_TIL_OPEN_TSI  
NNOT_TIL_OPEN_TSI  
NNOT_TIL_OPEN_TSI  
same as 3.0.3  
same as 3.8  
same as 3.8  
same as 3.8  
sap.destination  
4
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
Version 3.0.3  
RFC.ClientCode  
RFC.UserName  
RFC.Password  
Version 3.8  
Version 3.9  
sap.client  
same as 3.0.3  
same as 3.0.3  
sap.user  
same as 3.0.3  
sap.password  
sap.language  
sap.trace  
RFC.Language  
RFC.Trace  
same as 3.0.3  
same as 3.0.3  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
no equivalent key  
RFC.ReqWait  
sap.reqWait  
RFC.ConnectRetries  
NN.retry.count  
NN.retry.interval  
SAP.reqWait  
sap.connectRetries  
sap.retry.count  
sap.retry.interval  
sap.reqWait  
SAP.Destination.Out  
SAP.Destination.In  
SAP.retry.count  
SAP.retry.interval  
sap.destination.out  
sap.destination.in  
sap.retry.count  
sap.retry.interval  
Converting IDoc Formats  
You must convert the formats for both IDocs and BAPIs when you move  
between versions of Adapter for SAP R/3. Custom formats can continue to use  
names that begin with unique prefixes to differentiate them from standard  
formats.  
You need to migrate your IDoc formats to accommodate the following  
situations:  
SAP has modified an IDoc structure.  
Even if you made no changes to the adapter, this could happen when you  
moved to a new version of SAP.  
You have modified an IDoc structure.  
You must convert your modified IDocs when you upgrade to a new version  
of the adapter or a new version of SAP.  
You are migrating from version 3.0.3 to version 3.9 of the Adapter for SAP  
R/3.  
Installation Guide  
5
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Converting IDoc Formats  
The format conversion tool that ships with Adapter for SAP R/3 is a valuable  
resource for you to more easily migrate IDoc formats. Formats are dependent  
on the field mapping that you have done so you must also migrate those  
mappings. The purpose of the conversion tool is to preserve the field mappings  
used for output formats and transfer those current field mapping to the newly  
loaded format. The tool does this using two format export files as input to  
produce a new format export file; the new format export file combines the  
information from the two formats. This is intended to save you time because,  
after you use the tool to transfer you old field mappings, you need map only the  
new fields. Formats can be converted without doing rules at the same time, but  
rules cannot be converted without also converting the associated formats.  
To use the IDoc conversion tool, export your old IDoc output format and the  
new unmapped output format loaded using the version 3.9 adapter. Then edit  
the conversion tool configuration file to specify the names of the format export  
files and run the tool. IDoc formats required by version 3.9 into the IDoc  
conversion tool. The tool then creates one usable format based on the mapping  
of the two formats.  
After you have transferred the field mapping, you may validate the converted  
format by reformatting previously used messages and confirming that the  
output message fields contain the expected data. The New Era of Networks  
utility programs msgtest.exe and ruletest.exe can be used to validate your  
converted messages and rules.  
The IDoc conversion tool for Adapter for SAP R/3 provides the tools to do the  
following:  
Migrate IDoc formats from a 4.x Formatter database (database used by  
Adapter for SAP R/3 version 3.0.3) to a 5.4 Formatter database (database  
used by Adapter for SAP R/3 version 3.8).  
Update an extended IDoc format to a 5.6 Formatter database.  
Update a currently used IDoc format in a 5.x Formatter database to a  
newer version.  
If you are currently using map objects with formats for either of the last  
two scenarios, the conversion tool is not necessary because map objects  
preserve the field mapping from the original format. Map objects are  
available only with New Era of Networks formatters.  
Note The following procedures must be applied individually to each IDoc  
format that is being migrated. The conversion tool is able to handle only one  
IDoc type at a time.  
6
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
To migrate IDoc formats from a 4.x Formatter database  
Output formats used by the Broker for IDocs sent into SAP changed between  
version 3.03 and version 3.8 of the SAP adapter. The segment names used to  
begin with E2 or Z2 and terminate with a three-digit version number. Segment  
names now begin with E1 or Z1 to reflect that the IDoc is inbound into SAP.  
Three-digit version numbers have been dropped.  
Note New input formats can be used as loaded. No information from the old  
input format needs to be migrated.  
1
Do one or both of the following:  
a
Export only the outbound format from the 4.x Formatter database  
using the NNFie utility provided with Formatter 4.x.  
Example:  
C:\MQI\bin>nnfie -e absen1.oc.4x.exp -m  
SAP.OC.ABSEN1 -s nnfie  
b
Export the Rules associated with the format using the NNRie utility.,  
if you are converting rules.  
Example:  
C:\MQI\bin.nnrie -e absen1.4x.rules.exp -m  
SAP.OC.ABSEN1 -s nnfie  
Note When exporting extended IDoc formats from an 4.x Formatter  
database, the format name must be in quotation marks because names  
contain special characters. For example:  
nnfie -e format.exp -m “SAP.OC.MATMAS03^1” -s import  
2
3
Load the outbound format for the same IDoc into a temporary 5.6 database  
using version 3.9 of Adapter for SAP R/3.  
Export only the outbound format of the IDoc loaded in the previous step  
using the NNFie utility provided with Formatter 5.x.  
Example:  
C:\sybase\bin>nnfie -e absen1.oc.5x.exp -m  
SAP.OC.ABSEN1 -s nnfie  
4
Edit the configuration file for the conversion tool to indicate:  
Installation Guide  
7
Download from Www.Somanuals.com. All Manuals Search And Download.  
Converting IDoc Formats  
The names of the two format export files created in step 1 and step 3  
of this procedure.  
The name that you want to use for the converted format. (This name  
is arbitrary).  
5
To run the conversion tool, type the command using the following as an  
example:  
sap39idoccnvtool -file=<name of configuration file>  
The format export files and the configuration file used to load the 3.9  
schema should be placed in the SAP-3_9/bin folder. The command must  
be run from this same folder.  
6
7
Inspect the log file produced by the conversion utility for errors.  
Do one of the following:  
a
Import the format created by the conversion utility into the target  
database using the NNFie utility provided with Formatter 5.x.  
Example:  
C:\ConversionTests\>nnfie -i absen1.oc.conv.exp  
-g -s nnfie  
b
Import the Rules file created by the conversion utility using the  
NNRie utility provided with Formatter 5.x. This step is required only  
if step 1b was used.  
8
9
Review the formats to be sure the converted format has the correct  
mapping.  
If any formats have not been converted, you must change them manually.  
Test the format by using it as the target format for reformatting a test  
message.  
To update a newly extended IDoc format in a 5.x Formatter database:  
1
Export only the original outbound format using the NNFie utility provided  
with Formatter 5.x.  
Example:  
C:\sybase\bin>nnfie -e absen1.oc.5x.exp -m  
SAP.OC.ABSEN1 -s nnfie  
8
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
2
3
Load the outbound format for the newly extended IDoc into a temporary  
5.6 database using the 3.9 SAP adapter. (The example assumes an  
extended IDoc named ZABSEN1 was made from the base IDoc  
ABSEN1.)  
Export only the outbound format of the IDoc loaded in the previous step  
using the NNFie utility provided with Formatter 5.x.  
Example:  
C:\sybase\bin>nnfie -e zabsen1.oc.5x.exp -m  
SAP.OC.ZABSEN1 -s nnfie  
4
5
Edit the configuration file for the conversion tool to indicate:  
The names of the two format export files created in step 1 and step 3  
of this procedure.  
The name that you want to use for the converted format. (This name  
is arbitrary.)  
To run the conversion tool, type the command using the following as an  
example:  
sap39idoccnvtool -file=<name of config file>  
The format export files and the configuration file used to load the 3.9  
schema should be placed in the SAP-3_9/bin folder. The command must  
be run from this same folder.  
6
7
Inspect the log file produced by the conversion utility for errors.  
Import the format created by the conversion utility into the target database  
using the NNFie utility provided with Formatter 5.x.  
Example:  
C:\ConversionTests\>nnfie -i zabsen1.oc.conv.exp -g  
-s nnfie  
8
Test the format by using it as the target format for reformatting a test  
message.  
Note The way extended IDocs are treated is the major consideration for the  
conversion process between Adapter for SAP R/3 versions 3.8 and 3.9.  
Extended IDocs are no longer considered special situations.  
Installation Guide  
9
Download from Www.Somanuals.com. All Manuals Search And Download.  
Converting IDoc Formats  
To update a currently used IDoc format in a 5.x Formatter database:  
1
Export only the original outbound format using the NNFie utility provided  
with Formatter 5.x.  
Example:  
C:\sybase\bin>nnfie -e absen1.oc.5x.exp -m  
SAP.OC.ABSEN1 -s nnfie  
2
3
Load the outbound format for the new version of the IDoc into a temporary  
5.6 database using the 3.9 SAP adapter (the example assumes a new  
version of ABSEN was released - ABSEN2).  
Export only the outbound format of the IDoc loaded in the previous step  
using the NNFie utility provided Formatter 5.x.  
Example:  
C:\sybase\bin>nnfie -e absen2.oc.5x.exp -m  
SAP.OC.ABSEN2 -s nnfie  
4
5
Edit the configuration file for the conversion tool to indicate:  
The names of the two format export files created in step 1 and step 3  
of this procedure.  
The name that you want to use for the converted format. (This name  
is arbitrary.)  
To run the conversion tool, type the command using the following:  
Example:  
sap39idoccnvtool -file=<name of config file>  
The format export files and the configuration file used to load the 3.9  
schema should be placed in the SAP-3_9/bin folder. The command must  
be run from this same folder.  
6
7
Inspect the log file produced by the conversion utility for errors.  
Import the format created by the conversion utility into the target database  
using the NNFie utility provided with Formatter 5.x.  
Example:  
C:\ConversionTests\>nnfie -i absen2.oc.conv.exp -g -  
s nnfie  
8
Test the format by using it as the target format for reformatting a test  
message.  
10  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
Example Log File  
Source Control Record: SAP.OF.ABSEN1.CR  
Destination Control Record: SAP.OF.ABSEN1.CR  
Source Segment Name: SAP.OF.E2ABSE1  
Destination Segment Name: SAP.OF.E2ABSE1  
Field: SAP.E2ABSE1.BDEGROutMap: InMap: LEG.F1  
Field: SAP.E2ABSE1.MOABWOutMap: InMap: LEG.F2  
Field: SAP.E2ABSE1.ZEITYOutMap: InMap: LEG.F3  
Field: SAP.E2ABSE1.AGRUNOutMap: InMap: LEG.F4  
Field: SAP.E2ABSE1.BEGDAOutMap: InMap: LEG.F5  
Field: SAP.E2ABSE1.ENDDAOutMap: InMap: LEG.F6  
Field: SAP.E2ABSE1.ATEXTOutMap: InMap: LEG.F7  
Adjusting for Customization  
Make sure that the new format contains the correct default values for control  
records. (Default values in control records are optional.) The conversion tool  
transfers user-defined values and mappings, but it does not transfer default  
values.  
Note If the original format specified default values for the partner profile fields  
of the control record, then you must manually set the values to those literals.  
This applies to the literals named SAP.<IDOC TYPE>.* where * is one of the  
following: RCVPOR, RCVPRN, RCVPRT, SNDPOR, SNDPRN, SNDPRT.  
Suggestions for Converting IDocs  
Use descriptive names for the format export files.  
NNFie for 4.x uses the sqlsvses.cfg file, NNFie for 5.x uses the NNFie.cfg  
in the local directory (if one was created) or it searches for a copy of  
nnsyreg.dat file. The example commands assume the session name is  
nnfie.  
Use the which command to be sure that the expected version of nnfie.exe  
is being referenced.  
Installation Guide  
11  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Converting IDoc Formats  
The conversion tool can only convert one format at a time, so each export  
file must contain only one top-level format. (For example,  
SAP.OC.DEBMAS04)  
The easiest way to provide the information necessary for a user to log into  
the SAP system is to use a functioning configuration file for the inbound  
IDoc process. The value of SAPInConfig key should be the name of this  
file. (For example, the Schema mode configuration file used to load the  
IDoc with Version 3.9. It should be in the SAP-3_9/bin folder.)  
The saprfc.ini file is required. The file is in the location pointed to by the  
RFC_INI environment variable.  
The log file created by running the conversion tool reports errors and  
conversion information. The conversion information is a summary of error  
messages and a list of items that have been converted. It should indicate  
that some field mappings were preserved; for example, see the log file at  
the end of this section (sample log for a run of the conversion tool that  
preserves mappings).  
The import of the format generated by the conversion tool should use the  
-g option to ignore the conflicts that are reported when the same  
components are loaded in multiple converted format files. For example,  
the Input/Output Control “SAP.Length.3” or the control for some other  
length value may exist in multiple format definitions. The definitions are  
identical, so there is no need to reload the component. The NNFie.log  
reports instances that were ignored.  
Example Conversion Tool Configuration File  
#--------------------------------------------------  
# File Name: ConvTool.cfg  
# Sample configuration file for running the IDoc  
# format conversion tool.  
# The format of this file is important. Session names  
# MUST begin at the beginning of the line, the  
# associated keys MUST be below the session name  
# and indented by spaces or tabs. Comments are  
# preceded by #.  
#--------------------------------------------------  
NNConv  
# name of original format as seen in formatter  
12  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
# database  
FromFormat = SAP.OC.MATMAS03^1  
# name of format (loaded using new version of SAP  
# adapter) as seen in 5x formatter  
ToFormat = SAP.OC.MATMAS03.ZMATMAS_EXTENSION  
# must provide connection parameters used by 3.9 SAP  
# adapter to connect to SAP use inbound idoc or Schema  
# mode configuration file to get needed params to  
# connect to SAP  
SAPInConfig = in.cfg  
# 1=411 0=5x (they could go 5x to 5x)  
SourceFrom411 = 1  
# release of user’s SAP system  
SourceSAPRelease = 4.6B  
# name of export file of format to convert (ONLY one  
# format!)  
SourceExtract = matmas_ext.4x.mapped.exp  
# name of export file of format freshly loaded in 5.x  
# via GUI (ONLY one format!)  
RawExtract = matmas_ext.39.raw.exp  
# desired name of converted format export file  
OutputExtract = matmas_ext.39.conv.exp  
# conversion log file  
LogFile = format_conversion.log  
#####################################################  
# the following keys are for Rules related components  
#####################################################  
# name of rule export file (from 411) [Optional]  
# RulesIn = matmas_ext.rules.4x.exp  
# desired name of converted rule export file (into 5x)  
# [Optional]  
# RulesOut = matmas_ext.rules.conv  
# User may specify a new name for Message Type within the  
# Application Group in 5x database (the name is no  
# longer limited to 32 characters in length, but may be  
# up to 128 characters in length).  
# After the input format is imported into the 5x  
# database, the user would need to manually rename the  
# format to match the new expanded name created using  
# this key.  
Installation Guide  
13  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Converting BAPI Formats  
# example:  
# name in 4x database: LEG.I.ORIGINAL_LIMITED_SIZE_NAME  
# renamed in 5x database to  
# LEG.I.MODIFIED_FORMAT_NAME_OF_LARGER_SIZE  
# ToRuleInputMessage=SAP.IC.MATMAS03.ZMATMAS_EXTENSION  
# defaults to same name [Optional] or change rule name  
# RuleNameOut =  
# eof  
Converting BAPI Formats  
You must convert the formats for both IDocs and BAPIs when you move  
between versions of Adapter for SAP R/3. Custom formats can continue to use  
names that begin with user-defined prefixes to differentiate them from standard  
formats.  
BAPI formats and rules that you used for version 3.8 of the adapter will work  
with Adapter for SAP R/3 version 3.9. BAPI formats from version 3.0.3 or  
earlier are not supported and should be reloaded using the version 3.9 adapter.  
New rules must be created for these formats.  
The term New Formatter Database references any database created using  
MQSI version 2.0.2, WMQI version 2.1, or e-Biz Integrator versions 3.2x or  
3.6x.  
The term Old Formatter Database references a database built on earlier  
versions of these products.  
To use BAPI formats used in pre-3.9 versions  
Reload all BAPIs into the New Formatter Database.  
Note New Rules must be created for all formats that are reloaded into a  
new database.  
14  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
CHAPTER 1 Migrating to Adapter for SAP R/3 Version 3.9  
Upgrading Rules  
Review the rules that you are currently using with Adapter for SAP R/3. If they  
need to be converted for use with version 3.9:  
For converting IDoc rules, see “Converting IDoc Formats” on page 5.  
For converting BAPI rules used with 3.0.3 formats, manually convert your  
rules.  
Installation Guide  
15  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Upgrading Rules  
16  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
C H A P T E R  
2
Installing Adapter for SAP R/3  
This chapter describes how to prepare for and run an installation on a  
Topic  
Page  
Preparation  
17  
23  
23  
24  
24  
26  
32  
Required Software  
Running Executables Before Installing the Adapter on Windows  
Preparing the Installation Environment  
Installing Adapter for SAP R/3  
Understanding Environment Variables  
Note Review the printed Release Bulletin included with this package for  
last-minute updates to this Installation Guide.  
Preparation  
This section describes the areas you must consider before you run the  
installation procedure.  
Integration Server Support  
Transport Support  
Platform and Compiler Support  
Disk Space and Memory Requirements  
Required Software  
Installation Environment  
Installation Guide  
17  
Download from Www.Somanuals.com. All Manuals Search And Download.  
     
Preparation  
Integration Server Support  
Adapter for SAP R/3, version 3.9, supports the following integration servers:  
e-Biz Integrator, version 3.6  
MQSeries Integrator, version 2.0.2  
WebSphere MQ Integrator, version 2.1  
Note MQSeries Integrator version 2.0.2 does not support multi-byte data.  
Settings for Integration Servers  
The following combinations of integration server, OT driver, schema loader,  
and serializer can be used with Adapter for SAP R/3, version 3.9.  
Table 2-1: Settings for Integration Servers  
Schema  
Integration Server Open Transport Driver Loader  
Serializer  
MQSI 2.0.2  
MQSeries  
NNT56 Schema  
Loader  
NCF Serializer  
XML Serializer  
NCF Serializer  
XML Serializer  
WMQI 2.1  
e-Biz Integrator 3.6  
EMQ  
NNT56 Schema  
Loader  
MQSeries  
MSMQ  
Flat File  
Transport Support  
Adapter for SAP R/3, version 3.9, uses Open Transport (OT). Open Transport  
supports the following transport drivers:  
18  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
                               
CHAPTER 2 Installing Adapter for SAP R/3  
Table 2-2: Server transport support  
Driver  
Flat File  
MQSeries  
MSMQ  
Tibco  
Version  
2.6  
Supported Platforms  
NT, Solaris, HP-UX, AIX  
NT, Solaris, HP-UX, AIX  
NT  
2.6  
2.6  
2.6.1  
2.6.1  
NT  
JMS  
NT, Solaris  
Supported Platforms and Compilers  
“Supported Platforms and Compilers” on page 19 identifies the operating  
systems and compilers required for this product. Use this table to identify the  
software required for installation.  
Installation Guide  
19  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Preparation  
Table 2-3: Server  
Operating System  
DBMS  
Compiler  
Windows NT 4.0 (Service  
Pack 6a or higher)  
Sybase ASE 12  
Sybase ASE 12.5  
Microsoft SQL Server 2000  
Microsoft SQL Server 7  
Oracle 8i r3 (8.1.7)  
Oracle 9i  
Microsoft Visual  
C++, version 6.0  
Windows 2000 (Service  
Pack 2 or higher)  
DB2 UDB 7.1  
DB2 UDB 7.2  
Sybase ASE 12  
Sybase ASE 12.5  
Oracle 8i r3 (8.1.7)  
Oracle 9i  
Solaris 8  
SparcWorks  
C++, version 6.0,  
update 1  
DB2 UDB 7.1  
DB2 UDB 7.2  
Sybase ASE 12  
Sybase ASE 12.5  
Oracle 8i r3 (8.1.7)  
Oracle 9i  
HP-UX 11.00  
HPaC++,version  
A.03.15  
DB2 UDB 7.1  
DB2 UDB 7.2  
Sybase ASE 12  
Sybase ASE 12.5  
Oracle 8i r3 (8.1.7)  
Oracle 9i  
AIX 4.3.3  
VisualAge C++,  
Professional  
version 5.0.2  
DB2 UDB 7.1  
DB2 UDB 7.2  
Installation Environment  
Previous Releases  
If you have a previous version of New Era of Networks Adapter for SAP R/3  
installed, it is suggested that you uninstall that version before installing the  
current release. However, if you plan to continue to use your older version of  
20  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
                       
CHAPTER 2 Installing Adapter for SAP R/3  
the software, it can remain on the same server. Installation of the current release  
does not overwrite the previous installation and does not affect any files you  
might have added.  
CIM Repository  
The CIM (common information model) repository shares installation  
information across Sybase and New Era of Networks products, tracking  
version and path information for each product installation. If the repository is  
already installed, you do not need to install a new CIM Repository. However,  
the repository must be running before you can install products.  
If a CIM repository does exist:  
on the local machine on which you are installing, and the repository is  
running, the installer uses that repository by default. The Repository  
Information window does not appear.  
on the local machine on which you are installing and the repository is not  
running, the installer tries to start the existing repository. If it cannot start  
the repository, a warning message appears stating that a repository was  
found but could not be started. The Repository window will appear for you  
to provide the repository information and start the repository.  
on a remote machine, the Repository Information window appears even if  
the repository is running on the remote machine. If you want to use an  
existing repository, start it manually and provide the information required  
by the installer for the existing repository.  
If a CIM repository does not exist or cannot be found by the installer, a window  
appears, prompting you to install a new CIM Repository or use an existing  
repository.  
Installation Guide  
21  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Preparation  
To start a repository  
If the repository is already installed, you must provide the server, port number,  
and user information for the existing repository. The system populates the  
screen with default values for the server, port number, and user information,  
but you can modify the values if necessary.  
Use platform specific commands to start the repository:  
a
On Windows, enter the following:  
cd <install dir>\CIMRepository-3_0_0\bin  
repository.bat  
b
On UNIX, enter the following:  
cd <install dir>/CIMRepository-3_0_0/bin  
./repository.sh  
Temporary Installation Directory  
The installer uses a temporary location during the installation process. The  
default temporary location on Windows is defined in the system environment  
variables and is usually set to C:\temp. The default temporary location on  
UNIX is /var/tmp.  
If enough space is not available in the default temporary location, the installer  
might not start, or it might start, but notify you that sufficient space is not  
available. Either case requires providing sufficient space in the temporary  
directory. You can do one of the following:  
Move or delete files to provide space on the default temporary directory.  
Launch the installer using a different temporary directory.  
To install on a temporary directory other than the default directory:  
Use platform specific commands to specify an install directory:  
a
On Windows, enter the following:  
setup -is:tempdir <full path to alternate temp  
directory>  
b
On UNIX, enter the following:  
setup -is:tempdir <full path to alternate temp  
directory>  
22  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 2 Installing Adapter for SAP R/3  
Note Do not use spaces or special characters in your UNIX path.  
Disk Space and Memory Requirements  
Disk space  
NT: 183 MB for adapter and temporary directory used during installation  
UNIX: 208 MB for adapter and 160 MB for temporary directory  
256 MB for product files  
Memory  
Required Software  
“Supported Platforms and Compilers” on page 19 identifies the operating  
systems and compilers required for this product. Use this table to identify the  
software required for installation.  
The following must be installed or configured on the server before installing  
the adapter:  
Windows operating system  
SAP R/3, version 3.1H or higher; 4.0B or higher to work with XML  
formats.  
DBMS server database application.  
Compiler if you plan to write any of your own code.  
One of the integration servers listed in “Integration Server Support” on  
page 18.  
Internet Explorer version 5.5, Service Pack 2.  
Installation Guide  
23  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Running Executables Before Installing the Adapter on Windows  
Running Executables Before Installing the Adapter on  
Windows  
You must run the following executables or .msi files from the Adapter for SAP  
R/3 Server CD before you install the Adapter for SAP R/3 on Windows.  
From your CD-ROM drive, open the vbruntime-6_0 folder and double-  
click on vbrun60sp4.exe to install Visual Basic runtime. This is used by  
the GUI. When the install is finished, click OK.  
From your CD-ROM drive, open the mmc-1_2 folder and double-click on  
immc2.exe to install the Microsoft Management Console, which is used by  
the GUI. When the install is finished, click OK.  
From your CD-ROM drive, open the mdac-2_6 folder and double-click on  
the mdac_typ.exe file to install the proper version of MDAC. When the  
install is finished, click OK.  
For Windows NT, from your CD-ROM driver, open the msvc-6_0 folder  
and double-click on the vcredist.exe file to install the proper version of  
MSVC runtime. When the install is finished, click OK.  
After you have completed installing these four applications, you can continue  
with the next steps to complete the install.  
Note If you are installing Adapter for SAP R/3 on the same machine as your  
database server, you may not have to install a separate database client; instead,  
you can connect directly to the database server.  
Preparing the Installation Environment  
Previous versions  
If you have a previous version of Adapter for SAP R/3 installed, it is suggested  
that you uninstall that version before installing the current version. However,  
if you plan to continue to use your older version of the software, it can remain  
on the same server. Installation of the current version does not overwrite the  
previous installation and does not affect any files you may have added.  
24  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
CHAPTER 2 Installing Adapter for SAP R/3  
CIMRepository  
The Common Information Model (CIM) Repository shares installation  
information across Sybase and New Era of Networks products, tracking  
version and path information for each product installation. If the repository is  
already installed, it is not necessary to install a new CIM Repository. However,  
the repository must be running before you can install products. After the  
installation has been completed, you can stop the CIM Repository to save  
resources.  
If a CIM Repository does exist:  
on the local machine and is running, the installer uses that repository by  
default. The Repository Information window does not appear.  
on the local machine and is not running, the installer tries to start the  
existing repository. If it cannot start the repository, a warning message  
appears stating that a repository was found but could not be started. The  
Repository Information window appears and you can provide the  
repository information and start the repository.  
on a remote machine, the Repository Information window appears even if  
the repository on the remote machine is running. To use an existing  
repository, start it manually and provide the information required by the  
installer for the existing repository as detailed in “To start a repository” on  
page 25.  
If a CIM Repository does not exist or cannot be found by the installer, a  
window displays with the prompt to either install a new CIM Repository or use  
an existing repository.  
To start a repository  
If the repository is already installed, you must provide the server, port number,  
and user information for the existing repository. The system populates the  
screen with default values for the server, port number, and user information but  
you can modify the values if necessary.  
1
To start the repository on Windows, enter the following:  
cd <install dir>\CIMRepository-3_0_0\bin  
repository.bat  
2
To start the repository on UNIX, enter the following:  
cd <install dir>/CIMRepository-3_0_0/bin  
./repository.sh  
Installation Guide  
25  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
Installing Adapter for SAP R/3  
Temporary Installation Directory  
The installer uses a temporary location during the installation process. The  
default temporary location on Windows is defined in the system environment  
variables and is usually set to C:\temp. The default temporary location on  
UNIX is /var/tmp.  
If enough space is not available in the default temporary location, the installer  
may not start or may start but notify you that sufficient space is not available.  
You can do one of the following:  
Move or delete files to provide space.  
Launch the installer using a temporary directory on a different drive  
(Windows) or location (UNIX).  
To install on a temporary directory other than the default directory:  
1
For Windows, enter the following:  
setup -is:tempdir <full path to alternate temp directory>  
For Unix, enter the following:  
2
./setup -is:tempdir <full path to alternate temp directory>  
Note Do not use spaces or special characters in your UNIX path.  
Installing Adapter for SAP R/3  
For all installation instructions, <install dir> refers to the default installation  
directory.  
If installing on Windows, the default is C:\Sybase.  
If installing on Unix, the default is /user/u/Sybase. When installing on  
Unix, do not use spaces or special characters in the path.  
26  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
CHAPTER 2 Installing Adapter for SAP R/3  
If the installation directory does not exist, you can either create the directory or  
the installer will create the installation directory when installation begins. If  
you get a memory error while installing, see “Temporary Installation  
Directory” on page 26.  
Note Before you begin the installation, the repository must be running unless  
you plan to install a new one. If you plan to use an existing repository, you can  
verify whether the repository is running by doing one of the following:  
On Windows, go to Task Manager > Processes. If dbsrv7.exe is listed as  
running, the repository is active.  
On Unix, type ps -ef | grep dbsrv7  
To install Adapter for SAP R/3 using the InstallShield Wizard:  
These installation instructions assume you are logged onto the server with  
administrative rights/user permissions. When installing on UNIX, it is best to  
perform the install directly on the target machine in the Common Desktop  
Environment (CDE) single window mode. Use the CD-ROM to install Adapter  
for SAP R/3.  
1
2
Insert the CD-ROM and go to the step for your operating system:  
Start the installer.  
a
On Windows NT and 2000  
1
2
3
Verify that you have installed all prerequisite software.  
Select Start>Run from the Windows Start menu.  
In the Run dialog box, browse to locate the setup file:  
<CD-ROM drive>:\setup.exe  
4
Click OK.  
The Installer Welcome window appears.  
Got to step 3 of the main procedure.  
5
b
On Solaris:  
1
Mount the CD-ROM.  
For example:  
pfs_mount <CD DEVICE> /mnt_point  
Set the IP address:  
2
Installation Guide  
27  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Installing Adapter for SAP R/3  
export DISPLAY=<IP address:0.0>  
To change to the /mnt_point directory, enter:  
%cd mnt_point  
3
4
To start the installer, enter:  
%./setup  
The Installer Welcome window appears.  
Got to step 3 of the main procedure.  
5
c
On AIX:  
1
Mount the CD-ROM.  
For example:  
pfs_mount <CD DEVICE> /mnt_point  
Set the IP address:  
2
3
4
export DISPLAY=<IP address:0.0>  
To change to the /mnt_point directory, enter:  
%cd mnt_point  
To start the installer, enter:  
%./setup  
The Installer Welcome window appears.  
Got to step 3 of the main procedure.  
5
d
On HP-UX:  
1
Mount the CD-ROM.  
Some of the files that are being installed might have names  
longer than 31 characters or have mixed-case file and directory  
names, so you must enter the following mount commands:  
nohup pfs_mountd &  
nohup pfsd &  
pfs_mount <cd device> /mnt_point  
2
3
Set the IP address:  
export DISPLAY=<IP address:0.0>  
To change to the /mnt_point directory, enter:  
28  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
CHAPTER 2 Installing Adapter for SAP R/3  
%cd mnt_point  
4
5
To start the installer, enter:  
%./setup  
The Installer Welcome window appears.  
Got to step 3 of the main procedure.  
3
4
To initiate the installation process, click Next on the Installer Welcome  
window.  
The Installer window appears.  
To specify an installation directory, choose one of the following:  
a
To accept the default directory, click Next.  
b
To use a different directory, click Browse, select the directory, and  
click Next.  
Note For optimum performance, install all Sybase and New Era of  
Network products into the same directory.  
5
To configure the repository, do one of the following:  
a
If your repository is running, the Select Products To Install window  
appears. Go to step 7.  
b
If you do not have a repository installed or it is installed on a remote  
machine, the Repository Information window appears. Go to step 6.  
Note  
You can verify whether the repository is running by doing one of the  
following:  
On Windows, go to Task Manager > Processes. If dbsrv7.exe is listed  
as running, the repository is active.  
On Unix, type ps -ef | grep dbsrv7  
6
In the Repository Information window, do one of the following:  
To install a new repository, go to step 6a.  
To use an existing repository, go to step 6b.  
Installation Guide  
29  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
Installing Adapter for SAP R/3  
Figure 2-1: Repository Information  
a
To install a new repository, based on requirements detailed in  
“CIMRepository” on page 25:  
1
2
3
Choose Install a new repository.  
The Repository Connection Information is not visible in the  
Repository Information window.  
Click Next.  
The Repository Installation window displays the repository  
components to be installed.  
Click Next.  
The Repository Installation window displays the progress of the  
installation. Installation of a new repository may take a few  
minutes.  
When the repository installation is complete, the Select Products  
To Install window appears.  
b
If the CIM Repository is already installed and the Repository  
Information window appears:  
1
Choose Use an existing repository.  
30  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
CHAPTER 2 Installing Adapter for SAP R/3  
2
3
Accept the defaults for Repository Connection Information if  
possible. The defaults are shown in Figure 2-1 on page 30.  
Note If you use an existing repository, the repository must be  
running to continue the installation.  
Click Next.  
The Select Products to Install widow appears.  
7
From the Select Products to Install window, accept the default settings and  
click Next.  
The Installation Summary window appears displaying the products that  
will be installed and the approximate disk space that they will take.  
8
9
Click OK.  
The Installation Summary window displays the progress of the  
installation.  
Click Finish when the following message appears:  
The InstallShield Wizard has successfully installed  
New Era of Networks Adapter for SAP 3.9.  
Note If you get a NULL error message at the end of the installation, ignore  
the message.  
If you are installing on Solaris 7, you might receive error messages when  
finishing the installation. The product installed correctly; you can ignore  
the errors.  
10 For Windows, reboot the machine.  
Adapter for SAP R/3 and the Sybase shared components are located in the user  
specified installation directory <install dir>. The Adapter for SAP R/3  
software is located in <install dir>\SAP-3_9.  
Installation Guide  
31  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Understanding Environment Variables  
Table 2-4: /<install dir>/SAP-3_9  
Subdirectory  
Description  
/bin  
contains wrapper scripts for executables  
and shared libraries  
/CFG  
contains sample configuration files  
contains ctg message and error files  
contains data files  
/NNSYCatalogues  
/share  
Understanding Environment Variables  
Required environment variables are set by wrapper scripts at runtime. The GUI  
executable installation defines system environment variables of  
SAP39_ROOT and CGC39_ROOT with a value of <install dir> and the  
variable RFC_INI with a value of <install dir>\CFG\saprfc.ini. Complete  
configuration information is supplied in Adapter for SAP R/3 Users Guide and  
should be used after verifying the installation and before using Adapter for  
SAP R/3.  
32  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
C H A P T E R  
3
Uninstalling Adapter for SAP R/3  
This chapter explains how to uninstall Adapter for SAP R/3 version 3.9.  
To uninstall Adapter for SAP R/3 version 3.8, use the installer that was  
provided with that version. Call Sybase Technical Support for instructions  
on uninstalling a version earlier than 3.8.  
Topic  
Page  
33  
Starting the Repository  
Uninstalling Adapter for SAP R/3 3.9  
Uninstalling Shared Components  
34  
34  
Starting the Repository  
The CIM repository that shares Sybase and New Era of Networks product  
information must be running to uninstall products. This ensures the  
repository is updated with the accurate list of installed products. Using  
other means to uninstall products does not update the respository, which  
becomes an issue during reinstallation.  
To start the repository on Windows, enter the following:  
cd <install dir>\CIMRepository-3_0_0\bin  
repository.bat  
To start the repository on UNIX, enter the following:  
cd <install dir>/CIMRepository-3_0_0/bin  
./repository.sh  
Installation Guide  
33  
Download from Www.Somanuals.com. All Manuals Search And Download.  
         
Uninstalling Adapter for SAP R/3 3.9  
Uninstalling Adapter for SAP R/3 3.9  
A separate uninstaller is provided to remove Adapter for SAP R/3 version 3.9.  
The scripts to start the uninstaller are located in <install dir>\SAP-3_9.  
For Windows, uninstall.bat  
For Unix, uninstall.sh  
To uninstall Adapter for SAP R/3 version 3.9:  
1
Move any custom or other files that you want to save from the SAP-3_9  
directory to another directory.  
2
At the command prompt, enter the following:  
a
For Windows:  
cd <install dir>\SAP-3_9  
uninstall.bat  
b
For Unix:  
cd <install dir>/SAP-3_9  
uninstall.sh  
The InstallShieldWizard starts to uninstall Adapter for SAP R/3  
version 3.9.  
3
4
Follow the wizard until uninstall is complete.  
Manually remove the remaining <install dir>\SAP-3_9 directory.  
Uninstalling Shared Components  
You must first uninstall Adapter for SAP R/3 version 3.9 and any other New  
Era of Networks or Sybase products that use these shared components. You  
will receive a message when you attempt to uninstall any component that is  
required by another product. Shared components must be uninstalled in the  
order they are listed in step 4.  
To uninstall shared components:  
1
Copy <install dir>\JRE_1_3 directory to a temporary location and change  
the PATH environment variable to include the temporary directory.  
34  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
       
CHAPTER 3 Uninstalling Adapter for SAP R/3  
This provides a correct version of the JRE for running the uninstallers.  
Note  
If you do not copy JRE_1_3 to a temporary location, you will not be able  
to uninstall all of the shared components.  
2
To verify that Java version 1.3.1 or higher is being used, enter the  
following:  
java -version  
3
4
Enter the following command:  
cd <install dir>\uninstallers  
Repeat the steps 5 through 9 for each shared product in the following  
order:  
AgentManager-3_0_0  
ConfigUtils  
jConnect  
ThirdParty  
JRE_1_3  
ASAAgent  
CIMRepository-3_0_0  
EPASA-7_0_3  
5
Run the following command. Note that the command is written for  
Windows. For Unix, substitute a forward slash for the backward slash:  
java -jar <Shared Product>\<Shared Product File>.jar  
For example:  
java -jar AgentManager-3_0_0\AgentManager-  
3_0_0.jar  
The InstallShieldWizard starts to uninstall the shared component.  
To begin the installation, click Next on the initial Uninstaller window.  
The Repository Information window appears.  
6
7
Accept the defaults for the Repository Connection Information and click  
Next.  
Installation Guide  
35  
Download from Www.Somanuals.com. All Manuals Search And Download.  
   
Uninstalling Shared Components  
8
9
On the Feature Select window, select all items to be removed and click  
Next.  
When the selected components are uninstalled, click Finish.  
10 After repeating steps 5 through 9 for all of the shared products, delete the  
copy of JRE_1_3 that you had moved to a temporary directory.  
11 Manually remove the remaining <install dir> directory.  
36  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  
Index  
B
book organization  
C
changes to configuration keys  
CIM Repository 25, 30  
compilers  
converting format  
integration servers  
5
e-Biz Integrator 18  
MQSeries 18  
MQSI 2.1 18  
HP aC++ 20  
SparcWorks C++ 20  
VisualAge C++ 20  
configuration key changes  
conventions vii  
conversion tool configuration file 12  
3
L
converting IDoc formats  
D
database  
existing  
target  
2
MQSeries Integrator 18  
MQSI 2.0.2 18  
MSMQ 18  
2
databases  
DB2 UDB 20  
Microsoft SQL Server 20  
Sybase ASE 20  
default directory 26  
documentation set  
NCF Serializer 18  
E
e-BIz Integrator 18  
EMQ 18  
operating systems  
AIX 20  
HP-UX 20  
Solaris 20  
Windows NT 20  
F
Flat File 18  
Installation Guide  
37  
Download from Www.Somanuals.com. All Manuals Search And Download.  
 
R
repository running 27, 29  
S
SAP  
installing 27  
uninstalling 34, 35  
T
temporary directory 26  
transport  
supported 18  
U
uninstall  
SAP 3.8 33  
SAP 3.9 33  
shared components 35  
upgrading  
1
BAPI formats 14  
from 3.0.3  
from 3.8  
2
rules 15  
W
WebSphere MQ Integrator 18  
X
XML Serializer 18  
38  
Adapter for SAP R/3  
Download from Www.Somanuals.com. All Manuals Search And Download.  

Sharp Mouse 100 EVIK User Manual
Shoprider Mobility Aid GR889 User Manual
Soleus Air Air Conditioner SG TTW 12HC User Manual
Sony Digital Camera 4 412 225 221 User Manual
Sony Security Camera SSCFB560 User Manual
Sony Speaker SAW2500 User Manual
Spectra Laser Level 15PL User Manual
Spin Master Games Lip Gloss Maker User Manual
Sub Zero Cooktop CT15I S User Manual
Sunbeam Frozen Dessert Maker GL5500 User Manual