Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 with Websphere 6.1 and Oracle Application Server 10g

An Oracle Red Paper September 2009

-OracleCONFIDENTIAL

ORACLE CONFIDENTIALITY STATEMENTTHIS DOCUMENT CONTAINS UNPUBLISHED, HIGHLY CONFIDENTIAL, AND PROPRIETARY INFORMATION OF ORACLE USA, INC. THE RECEIPT OF THIS DOCUMENT IS GOVERNED UNDER LICENSE TERMS WITH ORACLE USA, INC, WHICH PROHIBIT, AMONG OTHER THINGS, PUBLICATION, DISCLOSURE, COPYING, OR DISTRIBUTION OF THIS DOCUMENT OR ANY OF ITS CONTENTS WITHOUT THE EXPRESS WRITTEN CONSENT OF ORACLE USA, INC.

PURPOSE STATEMENT AND DISCLAIMER

“This document is provided for information purposes and should not be relied upon in making a purchasing decision.  The contents hereof are subject to change without notice.   This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose.  THIS DOCUMENT IS NOT PART OF A LICENSE AGREEMENT NOR CAN IT BE INCORPORATED INTO ANY CONTRACTUAL AGREEMENT WITH ORACLE CORPORATION OR ITS SUBSIDIARIES OR AFFILIATES.  

This document is intended for information purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described for Oracle’s products remains at the sole discretion of Oracle. Updates and enhancements are provided in accordance with Oracle’s Technical Support Policies at:

www.oracle.com/support/collateral/oracle-technical-support-policies.pdf

Failure to adhere to these instructions does not constitute a breach of Oracle’s

obligations.  We specifically disclaim any liability with respect to this document

and no contractual obligations are formed either directly or indirectly by this

document. This document may not be reproduced or transmitted in any form or

by any means, electronic or mechanical, for any purpose, without our prior

written permission."

www.oracle.com/support/collateral/oracle-technical-support-policies.pdf

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page i - Oracle CONFIDENTIAL -

Generating JD Edwards EnterpriseOne Serialized Objects for

Xe and ERP 8

Table of Contents

EXECUTIVE OVERVIEW.................................................................................................1Overview of Procedures for Installing and Running eGenerator to Generate Serialized Objects.................................................................................................................................2

Prerequisite......................................................................................................................2Installing eGenerator.......................................................................................................2

Post Installation Steps..................................................................................................3Generating Objects to the Database and Web Server......................................................3

Generating Objects Directly to a Database..................................................................4Generating Objects to the Web Server........................................................................9

Verifying the Generation Process..................................................................................11Checking Log Files....................................................................................................11Checking Database Acknowledgements....................................................................11

Appendix A: Generator Status Log Example................................................................12

EXECUTIVE OVERVIEW

To run the Web server, you must make sure that the server has access to a set of serialized JD Edwards EnterpriseOne™ JAS objects. These objects can be generated directly from JD Edwards EnterpriseOne™ objects using the appropriate set of JD Edwards EnterpriseOne specifications.

Note: In this document, JD Edwards EnterpriseOne is sometimes referred to as JD Edwards OneWorld when referencing installation documents from the Xe and ERP 8 releases.

To generate serialized objects for the Web server, you must install and use the eGenerator, a JD Edwards tool that turns JD Edwards EnterpriseOne™ specifications into Java code, which enables you to access JD Edwards EnterpriseOne™ applications in HTML. The JD Edwards EnterpriseOne™ forms and applications that you generate using the tool are HTML objects. JD Edwards EnterpriseOne stores the objects in a database and retrieves them at runtime.

To generate JD Edwards EnterpriseOne™ serialized objects requires a specific machine configuration. While it is possible to configure a web server to generate JD Edwards EnterpriseOne™ serialized objects, you should dedicate a separate generation machine for this process. The configuration of this machine depends on the release of JDEdwards EnterpriseOne you installed.

If you use WebSphere as the application server with your Web server, you must install WebSphere Express to generate serialized objects. If you use the Oracle Application Server with your Web server, you must install Oracle Application Server on the generation machine.

You should generate all objects so that JAS is working with the same specs as your JD Edwards EnterpriseOne™ Windows clients. The ability to successfully generate objects is key to implementing the Web server. Generating JAS objects is equivalent to building a package for JD Edwards EnterpriseOne™ clients; you must generate objects to ensure a complete and successful implementation.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 1 Oracle CONFIDENTIAL -

Complete the tasks in this document to install eGenerator and generate JD Edwards EnterpriseOne™ JAS objects from a set of JD Edwards EnterpriseOne™ objects.

Overview of Procedures for Installing and Running eGenerator to Generate Serialized Objects

You must complete the following tasks to run eGenerator:

Install a JD Edwards EnterpriseOne client workstation (prerequisite).

Install eGenerator.

Generate objects to the database and Web server.

Prerequisite

Ensure that you have installed and are running a JD Edwards EnterpriseOne client that is running at the same service pack level as the Web server. This document describes how to configure the JD Edwards EnterpriseOne client as the generation machine. For instructions on installing a JD Edwards EnterpriseOne client, see the JD Edwards EnterpriseOne Installation Guide for Microsoft Windows-Based Systems.

Installing eGenerator

This section contains the primary requirements for the installation of the generation client.

Before you install eGenerator, verify that the tasks below are completed for JD Edwards EnterpriseOne Xe or ERP 8:

Websphere Application Server:

JDK version is the same as the one installed on the Web server.

Oracle Application Server:

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 2 - Oracle CONFIDENTIAL -

Generation client. JDK version is the same as the one installed on the Web server.

For generator machine installation instructions, refer to the corresponding release of the JD Edwards EnterpriseOne HTML/JAS installation guide.

Post Installation Steps

1. After installing the client machine, open X:\JDEdwardsOneWorld\B7333\SYSTEM\Generator and copy the genapp.ini file from the deployment server and paste it in the following directories on the machine on which you installed the client:

C:\WINDOWS

and

C:\WINDOWS\system32

2. Copy the JAS.ini file from X:\websphere\appserver\installedapps\ HYENT2 \EA_JS_81_tr3.ear\webclient.war\WEB-INF and paste it in this directory:

d:\B7\system\Generator\WEB-INF

Note: HYENT2 is the JAS Machine Name.

3. Open the gen.bat file in the d:\peoplesoft\E810\System\generator directory and set JDK=d:\websphere\appserver\java and also set the same in System Variable.

4. In the generator machine’s JDE.ini file located in C:\WINDOWS, add the following line to the [Interactive Runtime] section:

webadmin=1

5. Log in to the JDV7333 environment in JD Edwards EnterpriseOne and type BV in Fast Path. Select R92TAM, XJDE001, Processing option DV7333 & Blank.

6. Run R98CRTGL.

7. The R92TAM generates the dddict and ddtext specs into the x:\B7 directory. When finished, copy the spec files (dddict.xdb, ddtext.xdb, dddict.ddb, ddtext.ddb) into the \spec directory under the path code of the environment that is used to generate serialized objects (for example: X:\B7\DV7333\spec).

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 3 - Oracle CONFIDENTIAL -

Note: Copy JDK folder from webserver from following path, For WAS : IBM\WebSphere\AppServer\java For OAS : product\10.1.3.1\OracleAS_1\jdk

Generating Objects to the Database and Web Server

You can generate objects to the Web server, or bypass the Web server and generate objects directly to a database.

Generating objects directly to the database has these advantages:

Objects can be generated before setting up the Web server.

Faster for all forms of generation.

Easier to maintain.

The disadvantage is that the initial setup can be more difficult.

If you want to generate objects to the Web server, see “Generating Objects to the Web Server” section below.

Generating Objects Directly to a Database In this mode, the eGenerator initializes a "mini" JAS Server instance on the generation machine. During generation, the eGenerator bypasses the JAS Server and stores the objects directly to the database.

1. Run the gen.bat file and press Enter till you receive the message “Generator Diagnostics completed successfully.”

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 4 - Oracle CONFIDENTIAL -

2. On the JD Edwards EnterpriseOne Login screen, make sure you have logged into a Java environment, for example JDV7333.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 5 - Oracle CONFIDENTIAL -

3. Enter your credentials and click the OK button.

The Generator screen appears.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 6 - Oracle CONFIDENTIAL -

4. Click the Connect button to establish the connection.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 7 - Oracle CONFIDENTIAL -

Note: Do not use the Serial Generation; by default, it takes Parallel generation.

5. Generate all of the following object files by clicking the File menu and selecting Core Objects:

Data Dictionary

Tables

Business View

NER

Application

Report

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 8 - Oracle CONFIDENTIAL -

eGenerator begins generating the core objects and their dependent data dictionary items.

6. Check the status logs and the database to ensure that these objects were generated:

Tables: F9860, F9865, F0005, F983051, F9210, F98980, F98950, F0092, F0101, F00950, F95921, F9060, F9060D, F9061, F9062, F9064, F0010, F0093, F986101, F00921, F00922, F0004, F00941, F0094, F95921, F9065, F0082, F00821, F0083, F0084, F9000, F9001, F9002, F9006

Views: V9001B

7. After generating the core objects, generate the required applications, forms, reports, NERs, data dictionary items, tables, business views, data structures, and grid tables according to your requirements. For detailed steps, see the “Generating JD Edwards OneWorld Serialized Objects” chapter in the JD Edwards Web Server Installation Guide for Oracle Application Server or WebSphere Application Server.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 9 - Oracle CONFIDENTIAL -

Generating Objects to the Web Server

1. Run the Gen.bat file.

2. On JD Edwards EnterpriseOne™ Login, log in to a Java environment, for example JDV7333.

Note: HYENT9 is WEBSERVER and Port is 81.

3. In the Enter JAS Server Name field, enter the name of the JAS server that you want to log in to.

The system retrieves the database path from your jas.ini file. eGenerator generates all objects to this Web server.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 10 - Oracle CONFIDENTIAL -

Note: If you are running multiple Web server ports on your generation machine, enter the following:

machine:port

where machine is the name of the generation machine and port is the port number.

4. If you want to generate specs from a remote location, select the Remote Spec Folder radio button and enter the machine name and path, for example:

\\ machinename \c$\B7333\DV7334\SPEC

Note: HYDEP9 is deployment server.

Tip: You can use this field to point to the latest specs on the deployment server and generate objects from the most recent, undeployed specs.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 11 - Oracle CONFIDENTIAL -

5. Click the Connect button.

The system connects to the Web server that you specified. A message appears on the status bar when the login is complete.

After logging in to a Web server, you can follow the same steps to generate objects.

See Also

For more detailed process of generation, see the “Generating JD Edwards EnterpriseOne Serialized Objects” chapter in the JD Edwards Web Server Installation Guide for Oracle Application Server or Websphere Application Server.

Verifying the Generation Process

Complete these tasks to verify that the generation was successful:

Check Log Files

Check Database Acknowledgements

Checking Log Files

eGenerator enables you to display the Status Log and Error Log files.

To display the Status Log:

On eGenerator, select the Logs drop-down menu and then select Status Log.

To display the Error Log:

On eGenerator, select the Logs drop-down menu and then select Error Log.

Checking Database Acknowledgements

The status log records whether an object is successfully inserted into the database. This enables the user to monitor the generation process and verify that objects are successfully generated.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 12 - Oracle CONFIDENTIAL -

These acknowledgments are not printed for data dictionary items or data structures because they are too numerous to be printed on the command line screen.

See Appendix A in this document for an example of status log content.

Appendix A: Generator Status Log Example

**Generator Status Log started at Fri Nov 20 15:36:31 IST 2009**

Generating application P01012 ...[ 2009-11-20 15:37:22.593 ] Attempting to generate: P01012_W01012A[ 2009-11-20 15:37:28.046 ] Generated: P01012_W01012A[ 2009-11-20 15:37:28.046 ] Attempting to generate: P01012_W01012B[ 2009-11-20 15:37:28.312 ] -->Database Ack: ER_P01012_W01012A successfully inserted into database[ 2009-11-20 15:37:28.312 ] -->Database Ack: P01012_W01012A successfully inserted into database[ 2009-11-20 15:37:30.312 ] Generated: P01012_W01012C

[ 2009-11-20 15:37:30.312 ] App generation finishedDatabase Ack: TABLE_F03012 successfully inserted into database[ 2009-11-20 15:37:31.796 ] -->Database Ack: NER_UpdateChangedGeoCode successfully inserted into database[ 2009-11-20 15:37:31.796 ] -->Database Ack: PODATAP01012 successfully inserted into database

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 13 - Oracle CONFIDENTIAL -

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8

Sep 2009

Oracle Corporation

World Headquarters

500 Oracle Parkway

Redwood Shores, CA 94065

U.S.A.

Worldwide Inquiries:

Phone: +1.650.506.7000

Fax: +1.650.506.7200

oracle.com

Copyright © 2006, Oracle. All rights reserved.

This document is provided for information purposes only and the

contents hereof are subject to change without notice.

This document is not warranted to be error-free, nor subject to any

other warranties or conditions, whether expressed orally or implied

in law, including implied warranties and conditions of merchantability

or fitness for a particular purpose. We specifically disclaim any

liability with respect to this document and no contractual obligations

are formed either directly or indirectly by this document. This document

may not be reproduced or transmitted in any form or by any means,

electronic or mechanical, for any purpose, without our prior written permission.

Oracle, JD Edwards, PeopleSoft, and Retek are registered trademarks of

Oracle Corporation and/or its affiliates. Other names may be trademarks

of their respective owners.

This document is for informational purposes only and may not be incorporated

into a contract or agreement.

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 14 - Oracle CONFIDENTIAL -

Generating JD Edwards EnterpriseOne Serialized Objects for Xe and ERP 8 Page 15 - Oracle CONFIDENTIAL -