BEA WebLogic Server User manual

BEAWebLogic
Adapter for
Manugistics™
User Guide
Release 7.0.3
Document Date: April 2003

Copyright
Copyright © 2003 BEA Systems, Inc. All Rights Reserved.
Copyright © 2003 iWay Software. All Rights Reserved.
Restricted Rights Legend
This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems
License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the
law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part,
be copied photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form
without prior consent, in writing, from BEA Systems, Inc.
Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth inthe BEA Systems License
Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR
52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS
252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR
supplement 16-52.227-86; or their equivalent.
Information in this document is subject to change without notice and does not represent a commitment on the part
of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT
WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT
WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE
RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS,
ACCURACY, RELIABILITY, OR OTHERWISE.
Trademarks or Service Marks
BEA, Jolt, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA Builder, BEA Campaign
Manager for WebLogic, BEA eLink, BEA Manager, BEA WebLogic Commerce Server, BEA WebLogic
Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Express, BEA WebLogic Integration, BEA
WebLogic Personalization Server, BEA WebLogic Platform, BEA WebLogic Portal, BEA WebLogic Server, BEA
WebLogic Workshop and How Business Becomes E-Business are trademarks of BEA Systems, Inc.
All other trademarks are the property of their respective companies.
BEA WebLogic Adapter for Manugistics User Guide
Part Number Date
N/A April 2003

BEA WebLogic Adapter for Manugistics User Guide iii
Table of Contents
About This Document
What You Need to Know......................................................................................v
Related Information............................................................................................. vi
Contact Us!.......................................................................................................... vi
Documentation Conventions.............................................................................. vii
1. Introducing the BEA WebLogic Adapter for Manugistics
Introduction ....................................................................................................... 1-1
How the BEA WebLogic Adapter for Manugistics Works...............................1-3
How Services in the BEA WebLogic Adapter for Manugistics Work ...... 1-3
How Events in the BEA WebLogic Adapter for Manugistics Work.........1-5
How the Adapter Interfaces with Manugistics Processes .......................... 1-7
2. Creating and Configuring Events
Creating an Application View Folder................................................................2-1
Creating an Event Adapter Application View...................................................2-3
Configuring an Event Adapter Application View............................................. 2-5
Deploying an Application View...................................................................... 2-10
Testing Events Using Application View Console........................................... 2-13
Testing Event Adapter Application Views Using WLI Studio....................... 2-15
3. Creating and Configuring Services
Creating a Service Adapter Application View..................................................3-1
Configuring a Service Adapter Application View ............................................3-3
Deploying an Application View........................................................................ 3-7
Testing Services Using Application View Console ..........................................3-9
Testing Service Adapter Application Views Using WLI Studio..................... 3-11

iv BEA WebLogic Adapter for Manugistics User Guide
4. Creating Schema Repositories
Introduction to Schemas and Repositories ........................................................4-1
Naming a Schema Repository ...........................................................................4-2
The Repository Manifest ...................................................................................4-3
Creating a Repository Manifest..................................................................4-4
Creating a Schema.............................................................................................4-5
5. Using Tracing
Levels and Categories of Tracing......................................................................5-2
Tracing and Performance...................................................................................5-3
Creating Traces for Services and Events...........................................................5-3
Creating Traces for a Service.....................................................................5-4
Creating or Modifying the Tracing Level for an Event..............................5-6
Creating Adapter Logs for an Event...........................................................5-9

BEA WebLogic Adapter for Manugistics User Guide v
About This Document
The BEA WebLogic Adapter for Manugistics User Guide is organized as follows:
Chapter 1, “Introducing the BEA WebLogic Adapter for Manugistics,”describes
the components of the BEA WebLogic Adapter for Manugistics, describes its
features, and presents a high-level description of how the adapter works.
Chapter 2, “Creating and Configuring Events,” describes how to create,
configure, and test an event adapter.
Chapter 3, “Creating and Configuring Services,” describes how to create,
configure, and test a service adapter.
Chapter 4, “Creating Schema Repositories,” addresses the schema repositories,
manifests, and schemas that describe the documents entering and exiting a
WebLogic Integration system.
Chapter 5, “Using Tracing.” addresses tracing for services and events.
What You Need to Know
This document is written for system integrators with programming backgrounds and
an understanding of Manugistics. Extensiveknowledge of Manugistics is not required,
but may be helpful in learning about the adapter.
This document provides details on working with the adapter tools to develop online
interconnections to Manugistics using BEA WebLogic Integration.

vi BEA WebLogic Adapter for Manugistics User Guide
Related Information
The following documents provide additional information for the associated software
components:
BEA WebLogic Adapter for Manugistics Installation and Configuration Guide
BEA WebLogic Adapter for Manugistics Release Notes
BEA WebLogic Server installation and user documentation, which is available at
the following URL:
http://edocs.bea.com/more_wls.html
BEA WebLogic Integration installation and user documentation, which is
available at the following URL:
http://edocs.bea.com/more_wli.html
Contact Us!
Your feedback on the BEA WebLogic Adapter for Manugistics documentation is
important to us. Send us e-mail at docsu[email protected] if you have questions or
comments. Your comments will be reviewed directly by the BEA professionals who
create and update the adapter documentation.
In your e-mail message, please indicate which version of the adapter documentation
you are using.
If you have any questions about this version of the adapter, or if you have problems
using it, contact BEA Customer Support through BEA WebSupport at www.bea.com.
You can also contact Customer Support by using the contact information provided on
the Customer Support Card, which is included in the product package.
When contacting Customer Support,be prepared to provide the following information:
Your name, e-mail address, phone number, and fax number
Your company name and company address

BEA WebLogic Adapter for Manugistics User Guide vii
Your machine type and authorization codes
The name and version of the product you are using
A description of the problem and the content of pertinent error messages
Documentation Conventions
The following conventions are used throughout this document.
Convention Item
boldface text Indicates terms defined in the glossary.
Ctrl+Tab Indicates that you must press two or more keys simultaneously.
italics Indicates emphasis or book titles.
monospace
text
Indicates code samples, commands and their options, data structures and
their members, data types, directories, and file names and their extensions.
Monospace text also indicates text that you must enter from the keyboard.
Examples:
#include <iostream.h> void main ( ) the pointer psz
chmod u+w *
\tux\data\ap
.doc
tux.doc
BITMAP
float
monospace
boldface
text
Identifies significant words in code.
Example:
void commit ()
monospace
italic
text
Identifies variables in code.
Example:
String expr

viii BEA WebLogic Adapter for Manugistics User Guide
UPPERCASE
TEXT Indicates device names, environment variables, and logical operators.
Examples:
LPT1
SIGNON
OR
{} Indicates a set of choices in a syntax line. The braces themselves should
never be typed.
[] Indicates optional items in a syntax line. The brackets themselves should
never be typed.
Example:
buildobjclient [-v] [-o name ] [-f file-list]...
[-l file-list]...
|Separates mutually exclusive choices in a syntax line. The symbol itself
should never be typed.
... Indicates one of the following in a command line:
That an argument can be repeated several times in a command line
That the statement omits additional optional arguments
That you can enter additional parameters, values, or other information
The ellipsis itself should never be typed.
Example:
buildobjclient [-v] [-o name ] [-f file-list]...
[-l file-list]...
.
.
.
Indicates the omission of items from a code example or from a syntax line.
The vertical ellipsis itself should never be typed.
Convention Item

BEA WebLogic Adapter for Manugistics User Guide 1-1
CHAPTER
1Introducing the BEA
WebLogic Adapter for
Manugistics
This section introduces the components of the BEA WebLogic Adapter for
Manugistics, describes its features, and presents a high-level description of how the
adapter works. It includes the following topics:
Introduction
How the BEA WebLogic Adapter for Manugistics Works
Introduction
The corporate world has already realized the value of supply chain management
software,butapowerfulsuiteof supplychain managementsoftware is only astart. The
real challenge is the integration of the software suite with the rest of your enterprise
and other organizations.
The BEA WebLogic Adapter for Manugistics enables an organization to fully
integrate its Manugistics NetWORKS products with virtually any other legacy
mainframesystem,DBMS,datawarehouse,EDI,B2B,ERP,SCM,CRMorfinancial
applicationonany platform.High-speed,low-impact,non-intrusiveaccess to and from
Manugistics exposes the critical business logic and data contained with Manugistics

1Introducing the BEA WebLogic Adapter for Manugistics
1-2 BEA WebLogic Adapter for Manugistics User Guide
for immediate integration with other applications. The BEA WebLogic Adapter for
Manugistics uses the Manuba batch process to import data to and export data from the
Manugistics database, or universal data model.
The BEA WebLogic Adapter for Manugistics is an off-the-shelf solution that
simplifies the process of real-time integration of Manugistics with other systems.
Adapter technology removes the need for costly point-to-point computing
environments that are often restrictive and provide little flexibility for change.
As the computing environment expands to include legacy systems, ERP packages,
SCM packages, CRM packages, EDI networks, B2B exchanges, and the Internet, the
cost and complexity of application integration maintenance grows. In some cases, the
point-to-point solution cannot be expanded at all, forcing the integration to be
re-engineered. By using the BEA WebLogic Adapter for Manugistics in combination
with BEA WebLogic Integration, true integration of Manugistics with all your various
disparate applications is not only possible, it is very easy.
Whether you are moving information into or out of Manugistics, the BEA WebLogic
Adapter for Manugistics provides a proven, easy to use, cost effective architecture that:
Protects your organization’s investment in legacy systems.
Reduces the cost of your integration projects.
Provides the infrastructure to manage change in an ever-changing business
environment.
Key features of the BEA WebLogic Adapter for Manugistics include:
Support for bi-directional message interaction with Manugistics.
Support for service (Manugistics inbound) and event (Manugistics outbound)
adapter integration operations with Manugistics presenting XML schemas to
WebLogic Integration Studio.
Full support of XML document transformation to populate XML documents
with the results of a Manugistics request, as well as to populate a Manugistics
request document with data from external XML documents.

How the BEA WebLogic Adapter for Manugistics Works
BEA WebLogic Adapter for Manugistics User Guide 1-3
How the BEA WebLogic Adapter for
Manugistics Works
The BEA WebLogic Adapter for Manugistics is integrated with the Application
Integration (AI) component inside of WebLogic Integration. The adapter provides
services and events for the Manugistics supply chain management solutions.
Manugistics NetWORKS provides forecasting solutions that aids in predicting future
customer demand, alerting of potential supply problems, finding patterns undetected
in demand and helping to manage inventory planning to create time-phased inventory
strategies.
The BEA WebLogic Adapter for Manugistics NetWORKS supports import into and
export from the Manugistics universal data model (UDM), which is a database that
servesas a central storage pointfor all supply chain storage and optimization data. The
adapter interfaces with the UDM through the Manugistics Manuba batch process.
Manugistics recommends import into and exportfrom the Manugistics database using
the Manuba process to ensure data integrity.
How Services in the BEA WebLogic Adapter for
Manugistics Work
Services configured in the BEA WebLogic Adapter for Manugistics allow you to use
data from order processing, enterprise resource planning (ERP), and enterprise-wide
data warehouse systems to update the Manugistics UDM. Relevant data for
Manugisticsincludesorderandsalesinformation,purchaseorders,inventorybalances,
and forecasts usually available in the external systems.The adapter uses the
Manugistics Manuba process to update the Manugistics database. The following
illustration depicts the service architecture.

1Introducing the BEA WebLogic Adapter for Manugistics
1-4 BEA WebLogic Adapter for Manugistics User Guide
Figure 1-1 BEA WebLogic Adapter for Manugistics Service Architecture
As data becomes available in applications such as Oracle, Siebel, or SAP, and is passed
to the adapter within the BEA WebLogic Integration environment, it is parsed by the
adapter to ensure its compatibility with the Manugistics UDM. Use the Manugistics
VIEWpoint client, a graphical user interface for the Manugistics platform, to configure
a batch mode import file to match the data passed from the adapter. For more
information on the how the adapter works with Manugistics, see “How the Adapter
Interfaces with Manugistics Processes” on page 1-7.

How the BEA WebLogic Adapter for Manugistics Works
BEA WebLogic Adapter for Manugistics User Guide 1-5
Manugistics provides the Manuba batch process for importing data into and exporting
data from the Manugistics UDM. The adapter invokes that Manuba process
automatically. Once the configuration file for the batch import process is configured,
the adapter reads the configuration file and creates a new file with the required format,
path, and file name. After Manuba is invoked, the data is imported into the UDM.
How Events in the BEA WebLogic Adapter for
Manugistics Work
Events configured in the BEA WebLogic Adapter for Manugistics allow you to use
forecast data generated by Manugistics to update order processing, enterprise resource
planning (ERP), and enterprise-wide data warehouse systems. Relevant data for the
Manugistics NetWORKS solutions includes order and sales information, purchase
orders, inventory balances, and forecasts usually available in the externalsystems. The
adapter uses the Manuba process to export data from the Manugistics UDM. The
following illustration depicts the service architecture.

1Introducing the BEA WebLogic Adapter for Manugistics
1-6 BEA WebLogic Adapter for Manugistics User Guide
Figure 1-2 BEA WebLogic Adapter for Manugistics Event Architecture
In this event architecture, which is an example showing the calculate model in the
Manugistics Demand Planner, you invoke the calculate model process to generate
forecast data using either the Manuba calculate model process or the VIEWPoint
interface. The BEA WebLogic Adapter for Manugistics event polls the UDM. Once
the UDM is updated with the forecast data, the adapter converts the data into XML and
passes it through WebLogic Integration so that it can be used to update systems such
as SAP and Siebel. For more information on the how the adapter works with
Manugistics, see “How the Adapter Interfaces with Manugistics Processes” on page
1-7.

How the BEA WebLogic Adapter for Manugistics Works
BEA WebLogic Adapter for Manugistics User Guide 1-7
How the Adapter Interfaces with Manugistics Processes
The BEA WebLogic Adapter for Manugistics relies on the Manugistics Manuba batch
process to import data to and export data from the UDM to ensure the integrity of the
data. The Manuba batch process requires a configuration file before it can be invoked
by the adapter.
Note: You must create the Manugistics configuration (.lst) file for use by the
Manuba process before you configure services and events. See your
Manugistics documentation for more information on creating configuration
files.
The configuration file contains information such as the userview. In VIEWpoint,
userviews are objects that display data and allow you to interact with the system. Any
time you work with data in a database table or in a what-if simulation, you are working
with a userview. In addition, the configuration file contains information about data
selection and process.
For example, a typical export process is as follows:
manuba fcst_export.lst fcst_export.log
The configuration file fcst_export.lst has the following components:
DESKTOP DEMANDPLANNING
SELECTION FCST_TYPE_1
USERVIEW FCST_EXPORT.
The USERVIEW FCST_EXPORT is in the Demand database and has all the format
patterns of the FCST table, the location of the file to be exported, and the file name.
The Manuba batch process uses this information to carry out the export of data from
the Manugistics database.
The BEA WebLogic Adapter for Manugistics receives data from systems such as SAP
and transforms the data into XML. Once it is in XML, the adapter can convert it to the
format that can be used by the Manugistics Manuba process to update the Manugistics
UDM. For events, the adapter can poll the Manugistics UDM and convert the data to
the appropriate XML format. It is then passed from WebLogic integration to update
external systems. The adapter converts the XML into a format required by a particular
ERP or legacy system, if necessary.

1Introducing the BEA WebLogic Adapter for Manugistics
1-8 BEA WebLogic Adapter for Manugistics User Guide
When you configure services, you must provide information about your Manugistics
system, such as the location of the Manuba batch file, that will allow the adapter to
invoke the Manuba process.

BEA WebLogic Adapter for Manugistics User Guide 2-1
CHAPTER
2Creating and
Configuring Events
An event adapter is the inbound interface from a Manugistics applicationto WebLogic
Integration Studio. This section describes how to create, configure, and test an event
adapter. It contains the following topics:
Creating an Application View Folder
Creating an Event Adapter Application View
Configuring an Event Adapter Application View
Deploying an Application View
Testing Events Using Application View Console
Testing Event Adapter Application Views Using WLI Studio
Creating an Application View Folder
Application views reside within WebLogic Integration. WebLogic Integration
provides you with a root folder in which you can store all of your application views.
You can create additional folders to organize related application views into groups.
To create an application view folder:
1. Log on to the WebLogic Integration Application View Console at
http://appserver-host:port/wlai

2Creating and Configuring Events
2-2 BEA WebLogic Adapter for Manugistics User Guide
Here, appserver-host is the IP address or host name where the WebLogic
Integration Server is installed, and port is the socket on which the server is
listening. The port, if not changed during installation, defaults to 7001.
Note: Iftheusernameisnotsystem, it must be included in the adapter group.
For more information on adding the administrative server user name to the
adaptergroup,see theBEAWebLogicAdapterfor ManugisticsInstallation
and Configuration Guide.
Figure 2-1 Application View Console Main Window
2. Click the new folder icon.
The Add Folder window opens.
Figure 2-2 Figure 2-2 Add Folder Window
a. Enter the folder name.
b. Click Save.
You have finished creating the application view folder.

Creating an Event Adapter Application View
BEA WebLogic Adapter for Manugistics User Guide 2-3
Creating an Event Adapter Application View
To create an event adapter application view, follow the steps in this section.
Note: You must create a schema repository and create schemas before you create an
event adapter application view. For more information, see Chapter 4,
“Creating Schema Repositories.”
To create an event adapter application view:
1. Log on to the WebLogic Integration Application View Console at
http://appserver-host:port/wlai
Here appserver-host is the IP address or host name where the WebLogic
Integration Server is installed, and port is the socket on which the server is
listening. The port, if not changed during installation, defaults to 7001.
2. Select the desired application view folder.
3. Click Add Application View.
The Define New Application View window opens.
Figure 2-3 Application View Console: Define New Application View
a. Enter a name and description for the application view.
b. Select BEA_MGISTICS_1_0 from the Associated Adapter drop-down list.

2Creating and Configuring Events
2-4 BEA WebLogic Adapter for Manugistics User Guide
c. Click OK.
The Configure Connection Parameters window opens.
Figure 2-4 Application View Console: Configure Connection Parameters
Note: You can access the Configure Connection Parameters window when the
application view is not deployed by selecting the Reconfigure connection
parameters link. If the application view is deployed, you can access the
window by first undeploying the application view.
a. Type the name of the BEA WebLogic Adapter for Manugistics session base
directory in the Session path field.
This directory holds your Manugistics schema information and contains the
subdirectory Manugistics/YourConnectionName.
For example, the session base directory might be
d:\bea\bse\sessions\default, with the schema repository, containing a
repository manifest and schemas, residing in
d:\bea\bse\sessions\default\Manugistics\ManugisticsProd.For
more information about schema repositories, see Chapter 4, “Creating
Schema Repositories.”
b. Select the session name, also known as the connection name, from the
Connection name drop-down list.
c. Click Connect to EIS.
The Application View Administration window opens.