📄 useful.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML>
<HEAD>
<TITLE>
SAP Java Connector 3.0 Configuration and Requirements
</TITLE>
<LINK REL ="stylesheet" TYPE="text/css" HREF="./sap.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="SAP Java Connector 3.0 Configuration and Requirements";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="800" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="intro.html"><FONT CLASS="NavBarFont1"><B>Home</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="installation.html"><FONT CLASS="NavBarFont1"><B>Installation</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Configuration</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="index.html" target="_blank"><FONT CLASS="NavBarFont1"><B>API Documentation</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="examples.html"><FONT CLASS="NavBarFont1"><B>Examples</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="releasenotes.html"><FONT CLASS="NavBarFont1"><B>Release Notes</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
</TR>
<TR>
<TD COLSPAN=2 BGCOLOR="white" CLASS="NavBarCell2"> </TD>
</TR>
<TR><TD>
<HR>
<CENTER>
<h1>SAP Java Connector 3.0</h1>
</CENTER>
</TD>
</TR>
<tr><td> </td></tr>
<tr><td> </td></tr>
<tr><td><FONT SIZE="+2">
<B>Configuration and Requirements</B></FONT>
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Components of the SAP Java Connector</b>
</td></tr>
<tr><td>
The SAP Java Connector 3.0 runtime environment consists of 2 parts:
<ul>
<li>sapjco3.jar - java archive containing JCo's Java runtime classes
<li>{library prefix}sapjco3{shared library extension} - JNI runtime library
containing JCo's native code
</ul>
JCo's JNI runtime library contains the native code for the network communication.
There is only a loose coupling between the java JCo library and the JNI runtime library, however
the java library needs a specific minimum version of the JNI library. The one delivered with the
JCo distribution is sufficient but one may also install a later version.
<p>
<em>Note: JCo runtime is able to communicate with unicode and non-unicode SAP Systems.
Technically the JCo runtime is unicode enabled. If you are using a 32-bit JVM you will
need 32-bit JCo libraries, regardless if you are running on a 32-bit or 64-bit operating system.
</em>
</td></tr>
<tr><td>
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Runtime loading mechanism</b>
</td></tr>
<tr><td>
When an application references a JCo class for the first time it will be loaded by the associated
class loader. During this process JCo's static initializer will be executed. This routine will
search and load the JCo JNI library by using the following algorithm:
<ol>
<li>Try to load the sapjco3 library from the same directory where the
sapjco3.jar file or the JCo class files are located.<p>
<li>Search the sapjco3 library along the directory path defined in the
java.library.path system property from left to right and if found load
it from there.<br>
<em>Note: If this property is not set manually, the JVM will usually set the OS specific
library path environment variable as the default</em> java.library.path <em>system
property at startup.</em><p>
<li>Let the JVM handle the loading of the sapjco3 library by delegating
this task to its <code>System.loadLibrary(String)</code> method.
</ol>
<p>
<em>Note:</em>It is not required to move the JCo JNI library into windows system32 directory.
<p>
If the sapjco3 library cannot be found or loaded, you will get an <code>UnsatisfiedLinkError</code>
with details provided by the OS. <br>
This error message may be caused for one of the following reasons:
<ul>
<li>The sapjco3 library cannot be found by using the above described
algorithm, because you unintentionally installed it to the wrong directory or forgot
to specify its directory in the OS specific library path environment variable or alternatively
in the java.library.path system property.
<li>The version of the sapjco3 library found via the sapjco3.jar directory or
the java.library.path system property is too old .
<li>The sapjco3 library lacks the execute permission flag.
<li>The sapjco3 library does not have the same bit width as the JVM.
<li>The sapjco3 library is from a different JCo distribution and is not for use with
your operating system and/or your hardware processor.
<li>The sapjco3 library requires a higher operating system version.
</ul>
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Version dialog / Smoke installation test</b>
</td></tr>
<tr><td>
You can check if JCo is installed correctly by starting its About dialog. This can conveniently be done
by using the command<br><br>
<code> java -jar {sapjco-install-path}/sapjco3.jar</code><br>
or<br>
<code> java -classpath {sapjco-install-path}/sapjco3.jar com.sap.conn.jco.rt.About</code><br><br>
The command will pop up a dialog containing all relevant JCo version information. On non-windowing systems
you can get the same information printed to the console by typing<br><br>
<code> java -jar {sapjco-install-path}/sapjco3.jar -stdout</code><br>
or<br>
<code> java -classpath {sapjco-install-path}/sapjco3.jar com.sap.conn.jco.rt.About</code><br>
<code> -stdout</code><br><br>
There should be no exception or error thrown and all versions should be listed with their correct version
numbers and date. Otherwise please see the above chapter "runtime loading mechanism" for possible installation
or configuration errors.
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Network configuration</b>
</td></tr>
<tr><td>
JCo uses the CPI-C protocol based on TCP/IP for its low level network communication. Usually the TCP/IP protocol is a
communication service provided by the operating system. So, as a prerequisite for JCo to work, the TCP/IP
service must be configured.<br>
If you have a working SAPGUI installed on your machine all necessary TCP/IP configuration steps should have
been already made during its installation process. But if you install JCo from scratch on a new system, you
have to take care of the following:<p>
<ul>
<li>Make sure that the SAP application, message and gateway servers or alternatively the SAP router
can be reached physically by using their IP addresses (<code>ping <nnn.nnn.nnn.nnn></code>).
If this won't work please ask your network administrator for help.
<li>If desired, make sure that the SAP application, message and gateway servers or alternatively the SAP
router can also be reached by using their logical host names (<code>ping <hostname></code>).
If they cannot be reached this way please check your DNS (Domain Name Service) service entries or
maintain the respective host name in your local hosts file (for Windows systems:
<code><WinDir>\system32\drivers\etc\hosts</code>).
<li>If you would like to use the load balanced log on, check if the SAP message server service and its
TCP port is defined in the services file. There must be an entry of format <code>"sapms<SID> <portnumber>/tcp"</code>
in the services file where <code><SID></code> = 3-letter SAP System ID. (In Windows systems the
services file is usually stored at <code><WinDir>\system32\drivers\etc\services</code>.)
<li>If you would like to omit the message server host name in your log on parameters for a load
balanced log on, please maintain an entry of format <code>"<SID>=<hostname>"</code> in the file
<code>sapmsg.ini</code> where <code><SID></code> = 3-letter SAP System ID. The RFC library will try
to read a missing message server host name from this file. It will be searched in the current
working directory or in the directory specified by the shell environment variable
<code>RFC_LOGON_INI_PATH</code>.
</ul>
For more information on the SAP technical infrastructure, network communication and configuration please have a
look at the SAP Service Marketplace section "Network Integration" at
<a href="http://service.sap.com/network">http://service.sap.com/network</a>.
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Application configuration for Unicode SAP Systems</b>
</td></tr>
<tr><td>
If you would like to do RFC outbound calls from a Unicode SAP System to a JCoServer instance,
you have to set the Unicode option for your RFC destination in transaction <code>SM59</code>.
This option can be found on the Tab "Special Options", section "Character Width in Target System".<p>
For RFC outbound calls from a Non-Unicode SAP System to a JCoServer instance or for any inbound
RFC calls to Non-Unicode or Unicode SAP Systems you don't have to do any special configuration tasks.
</td></tr>
<tr><td> </td></tr>
<tr BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><td>
<b>Tracing mechanisms</b>
</td></tr>
<tr><td>
JCo's tracing mechanism can be turned on by setting the following java environment
properties at startup:<br><br>
<code> -Djco.trace_level=N (where 0 ≤ N ≤ 10 with 10 = most detailed trace)</code><br><br>
and optionally<br><br>
<code> -Djco.trace_path=<PATH></code><br><br>
If a trace path is set the JCo traces will be written to one or multiple files named
<code>JCO<date>_<time>.<no>.trc</code> in the specified <code>PATH</code> directory. Otherwise the JCo
traces will be written to the standard output stream (default is an output to the console).<br>
The same tracing behavior can be achieved by modifying the program code calling the JCo API
JCo.setTrace(int level, String path).<p>
The tracing mechanism on the RFC layer can be turned on by setting the java environment property at startup:<br><br>
<code> -Djco.jrfc=1</code><br><br>
The RFC layer trace files are named <code>jrfc<processID>_<threadID>.trc</code>
and will be written to the current working directory. If you would like to trace only a special
connection, you can turn on the RFC layer tracing individually by setting trace=1 in the
appropriate JCoDestination or JCoServer configuration.
</td></tr>
<TR>
<TD>
<hr>
</TD>
</TR>
<TR>
<TD>
<i >Copyright © 2008 SAP AG. All Rights Reserved.</i>
</TD>
</TR>
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -