1
Introduction

The Oracle Application Server InterConnect Adapter for J.D. Edwards OneWorld XE (J.D. Edwards OneWorld XE adapter) enables you to use J.D. Edwards business functions with your system. This book discusses procedures for setting up the J.D. Edwards OneWorld XE adapter and some J.D. Edwards specific information.

This chapter discusses the following:

• J.D. Edwards Communication Architecture

• Software Requirements

• Platforms

• Required Files

• Customizing the jdeinterop.ini File

J.D. Edwards Communication Architecture

The J.D. Edwards OneWorld XE adapter provides access to J.D. Edwards business functions. J.D. Edwards communicates between client and server machines using a proprietary messaging architecture called JDENet. This is implemented using TCP/IP as a transport, with a default port of 6009.

Calls to J.D. Edwards business functions require two messages. For an Oracle Application Server InterConnect (OracleAS InterConnect) user, these two messages are wrapped in a single call to the business function. The first message responds with the location of the server that processes the business function. This is accomplished by performing a lookup in a set of tables called Object Configuration Mapping.

The second message sends a formatted message buffer containing the arguments to pass to or from J.D. Edwards to the appropriate server, and waits for a reply. The buffers are formatted according to the type definitions of the underlying C++ structures.

Software Requirements

Table 1-1 lists the systems to which the adapter connects:

Table 1-1 Supported Systems

Component Support	Required Components
J.D. Edwards OneWorld XE adapter	XE (B73.3.3) Note: To avoid the issues with Windows servers and remote control, you need service pack 16 or higher on XE.
J.D. Edwards Enterprise server	Windows 2000, Windows NT, UNIX
JDK	1.4.1

The J.D. Edwards ACBREL1 custom package is required to use the J.D. Edwards OneWorld XE adapter.

See Also: Chapter 6, "Custom Package Creation and Installation" Oracle Application Server InterConnect Installation Guide for hardware requirements

Platforms

The J.D. Edwards OneWorld XE adapter supports the following platforms:

• Windows NT - Version 4 with service pack 6 or above

• Windows 2000-with service pack 1 or above

• Solaris 8-- compatible with the C++ workshop compiler version 6.0 on Solaris

• HP-UX, Version 11.0

Required Files

J.D. Edwards OneWorld XE adapter uses the following .jar files at both runtime and design time:

• Connector.jar

• Kernel.jar

• JDEJAccess.jar

• JDEActionalInterop.jar

Kernel.jar and Connector.jar must be copied from the machine where J.D. Edwards OneWorld is installed to the machine where J.D. Edwards OneWorld XE adapter is installed.

The files must be copied to the following directories:

...\oai\9.0.4\lib\Kernel.jar
...\oai\9.0.4\lib\Connector.jar

Customizing the jdeinterop.ini File

The Connect.jar and Kernel.jar files use the jdeinterop.ini file to configure connections parameters to the J.D. Edwards OneWorld machine. You must edit ...\oai\9.0.4\config\JDE\jdeinterop.ini to include some settings the server may need. The default drive for the file is c:, however, you can change this location. Information is organized by section, for example, [JDENET]. Sections are listed in the order they are found in the software.

Note: Make sure you include the following path to the jdeinterop.ini file in the J.D. Edwards Configuration Editor: ...\oai\9.0.4\config\JDE\jdeinterop.ini.

See Also: "Configuration Editor"

[JDENET]
Setting Typical Value Purpose

EnterpriseServerTimeout = 90000 - The timeout value for a request to the enterprise server.

maxPoolSize = 30 - The JDENET socket connection pool size.

[SERVER]
Setting Typical Value Purpose

glossaryTextServer = JDED:6010 - The enterprise server and port that provide glossary text information. This is the server that returns text descriptions for errors. This is often the same host and port as the JDEdwards OneWorld application server. There may be more than one glossary server for different supported language encodings.

codePage = 1252 - The encoding scheme.

• 1252 English and Western European

• 932 Japanese

• 950 Traditional Chinese

• 936 Simplified Chinese

• 949 Korean

[LOGS]
Setting Typical Value Purpose

log = c:\jas.log - This is the file used by interoperability components to log significant information.

debuglog = c:\jasdebug.log--Location of debug log file.

Debug = FALSE

[DEBUG]
Setting Typical Value Purpose

JobFile = c:\Interop.log--Location of error file.

DebugFile = c:\InteropDebug.log--Location of debug file.

log = c:\net.log--Location of log file.

debugLevel = 0 - 12--Debug levels.

The following table describes debug levels:

Debug Level	Description
0	None. Logging is turned off and only errors are written to the JobFile.
2	Errors (error messages).
4	System Errors (exception messages).
6	Warning Information.
8	Minimum Trace (Key operations. For example, Login, Logoff, Business Function calls).
10	Trouble Shooting Information (Help).
12	Complete Debug Information (Logs everything).

The odd values are reserved for future levels to be added. By default, you typically do not need to trace. However, tracing is useful for debugging:

NetTraceLevel= 0

The following table describes trace levels:

Trace Level	Description
0	No trace.
1	Refers to the Record process ID, thread ID, and the available socket status when a new connection is added and the socket pool is searched.
2	Includes all the information in Trace Level 1, and also traces every call made in the connection manager class.
3	Includes all information in Trace Level 2, and also traces getPort() calls and getHost() calls.

By default, you do not need to trace. However, tracing is useful for debugging.

[INTEROP]

Setting Typical Value Purpose

enterpriseServer = JDED - This value is the name of the host server. Make sure this value is the same value you enter in the Host Name field in the JDE Credentials and Default Credentials panels in the Configuration Editor.

port = 6010 - This value is the port number that is used to exchange data. Make sure this value is the same value you enter in the Port Number field in the JDE Credentials and Default Credentials panels in the Configuration Editor.

inactive_timeout = 1200000 - The timeout value for a transaction in auto commit mode. If the user is inactive for this amount of time (in milliseconds), the interop server logs off the user. You can change this value to a shorter period of time.

manual_timout = 300000 - The timeout value for a transaction in manual commit mode.

Repository c:\Oracle\Ora904\oai\9.0.4\lib - Points to the location of the repository directory. This must point to the directory containing the JDEActionalInterop.jar file. This repository directory is %OAI_INSTALL_DIR%\lib where %OAI_INSTALL-DIR% is the OracleAS InterConnect installer directory, ...\oai\9.0.4.

[CORBA]
Setting Typical Value Purpose

Multithread = 1 - Set to 1 for multithread support for CORBA.

Objects = CORBA::Connector;CORBA::OneWorldVersion - The objects for the CORBA server to create at startup. Also replaces the -DIORFILENAME = command line option, for example: CORBA::Connector=connector.ior.