01 Incentage Training 0.0 Jump Start

Incentage Education
Jump Start
Teacher Edition
PART NUMBER: EDU-JS108-E, Rev 4.10, 11-Aug-08
ABSTRACT: This document provides an outline of the Incentage Middleware

Suite. It documents the installation procedure and prepares for the first
usage.
APPLICABILITY: This document is recommended for integrator trainees new

to the Incentage Middleware Suite. It is also recommended as a guide for
project managers and consultants responsible for integrating solutions with
Incentage.
MATERIAL: Education CD Part 0.0 containing the environment used in

chapter 6.
PREREQUISITE TRAINING: None
STATUS: Released
REVISION HISTORY:
Revision Date Comment Author

V1 14-Apr-2002 First Draft Felix Huber
V2 14-Jun-2002 First Version Christian Stillhard
V3 16-Jul-2002 Full revision Christian Stillhard
V4 25-Mar-2003 Glossary, Further Exercises, minor changes Christian Stillhard
V4.1 8-Jul-2003 Corrections Felix Huber
V4.2 10-Mar-2004 Added Incentage Processing Steps Felix Huber
v4.3 17-May-2004 Partial revision Markus Köppel
v4.4 2-Jul-04 Corrections, removed PATH setup Christian Stillhard
v4.5 31-Jan-05 Adapted to installation package Florian Specker
V4.6 1-Feb-05 Minor wording changes Christian Stillhard
V4.7 20-Jul-06 Minor changes John Pickering
V4.8 11-Feb-08 Processing multiple messages screenshot Ruby Phull
V4.9 04-Aug-08 Minor corrections Daniel Roth
V4.10 11-Aug-08 Minor changes Florian Specker
Incentage Education Jump Start
This document is proprietary. It is an unpublished work protected under the

Federal copyright laws.
© Incentage Corporation 2002-2008. All rights reserved.
Responsible Department: Education
Responsible Person: christian.stillhard@incentage.com
APPROVAL: This document has been approved by Incentage Services

Management for worldwide usage.
The following are trademarks of Incentage:
Incentage
Incentage Education Table of Content
TABLE OF CONTENTS
1 PREFACE 1-1
1.1 Goal 1-1

1.2 Audience 1-1
1.3 Guide to this Training Module 1-1
1.4 Icons 1-2
2 INCENTAGE MIDDLEWARE SUITE 2-3
2.1 Goal 2-3

2.2 Overview 2-3
2.2.1 Component 2-4
2.2.2 Modules 2-5
2.2.3 Configuration of a Component 2-6
2.3 Incentage Processing Steps 2-7
2.4 Defining Rules 2-9
2.5 Test Questions 2-10
3 INCENTAGE INSTALLATION ENVIRONMENT 3-11
3.1 Goal 3-11

3.2 Incentage Installer 3-11
3.3 Software Involved 3-11
3.4 Operating System Notes 3-12
3.5 Incentage Installation Steps Summary 3-12
3.6 Questions 3-13
4 INSTALLING JAVA 4-14
4.1 Goal 4-14

4.2 Overview 4-14
4.3 Installation 4-14
4.4 Test the Java Installation 4-15
5 INSTALLING INCENTAGE 5-16
5.1 Goal 5-16

5.2 Setup 5-16
5.3 Configuration 5-17
5.4 Test the Installation 5-19
5.5 Upgrading Incentage 5-19
© copyright Incentage AG, 2002-20087 i

Incentage Education Table of Content
6 CONVERTING THE FIRST MESSAGE 6-20
6.1 Goal 6-20

6.2 Take Over an Environment 6-20
6.3 Test Questions 6-21
7 FURTHER EXERCISES 7-22
7.1 Goal 7-22

7.2 Process Multiple Messages I 7-22
7.3 Process Multiple Messages II 7-23
Figure 2-1 Incentage Building Blocks......................................................................................... 2-3
Figure 2-2 Distributed Architecture ............................................................................................ 2-4
Figure 2-3 Component Architecture Overview....................................................................... 2-5
Figure 2-4 Component Startup and Initialisation .................................................................... 2-6
Figure 2-5 Example CCD.............................................................................................................. 2-7
Figure 2-6 Incentage Processing Steps ..................................................................................... 2-8
Figure 2-7 Rules Repository .......................................................................................................... 2-9
Figure 3-1 Incentage Installer.................................................................................................... 3-11
Figure 3-2 Incentage Runtime Environment .......................................................................... 3-12
Listing 4-1 Java Version Information ........................................................................................ 4-14
Figure 2: Incentage Installer...................................................................................................... 5-16
Figure 3: Installation completed............................................................................................... 5-17
Figure 4: Thank you for installing Incentage! ......................................................................... 5-17
Figure 5: Incentage Configuration Manager ........................................................................ 5-18
Figure 6: Libraries selection........................................................................................................ 5-18
Figure 7: External library paths .................................................................................................. 5-19
Figure 6-1 Login for the ManagementConsole ..................................................................... 6-20
Figure 6-2 Start the Component............................................................................................... 6-21
Figure 7-1 Message Count......................................................................................................... 7-23
© copyright Incentage AG, 2002-20087 ii

Incentage Education Preface
1 Preface
1.1 Goal
This document provides an outline of the Incentage Middleware Suite. It
documents the installation procedure and prepares for the first usage.
1.2 Audience
The primary audience for the Incentage Education Jump Start volume is:
Integration project managers: Those who are responsible for the

management of a project deploying Incentage Middleware Suite.
Integration project team members: Those responsible for carrying out the
tasks required to achieve the project objectives.
The secondary audience for the Jump Start volume includes:
Data Conversion Engineers: Those responsible for entering rules and

converting the business logic into the conversion rules.
Sales support specialists: Those responsible for selling Incentage Middleware

Suite.
1.3 Guide to this Training Module

The JumpStart module consists of a theoretical and an applied part. In the first
two chapters you will study the Incentage architecture and the technology
behind this multiplatform software.
The other chapters guide you through the installation of Incentage on a
computer and you will finally process the first message.
© copyright Incentage AG, 2002-20087 1-1

Incentage Education Preface
1.4 Icons
Whenever this icon appears, you are supposed to follow the steps or find out yourself how to
do something. This indicates a hands-on exercise that requires you to use your notebook.
This icon indicates important information to be read.
This icon introduces a section consisting of test questions. You either have the answers in
your handout or you are supposed to fill in the correct answer yourself.
This icon highlights an important hint. Read this very carefully as it is a recommendation
about the proper usage of the Incentage Middleware Suite.
Table 1-1 Icon Meaning

Incentage Education Incentage Middleware Suite
2 Incentage Middleware Suite
2.1 Goal
The goal of this chapter is to provide an outline of the Incentage Middleware
Suite architecture to enable integrators who are not familiar with Incentage to
properly use it and understand solution designs based on the Incentage
Middleware.
2.2 Overview
Incentage consists of three building blocks:
1. Incentage component: It performs the actual processing of

the data. Multiple components can be chained to form a
flow.
2. Incentage ManagementConsole: The graphical user interface (GUI) to

configure, manage, and supervise the components.
3. Incentage RulesStudio: A GUI to create, edit, document, and manage the

business logic – the conversion rules.
Figure 2-1 illustrates the building blocks of the Incentage Middleware Suite.
Incentage
Appl. A Appl. B
Component
Status
Commands
Mapping Reporting
Rules DB
Configuration
Rules Editor Management Console
Figure 2-1 Incentage Building Blocks
The next sections will give you a detailed view of the three building blocks.

2.2.1 Component
The Incentage Middleware Suite provides highest flexibility with
a component oriented architecture. The connection between
two or more applications is represented by an Incentage flow
and consists of a set of components.
Appl. A Appl. C
MA MB
Incentage Incentage
Component Component
Transaction Mgmt.
Configuration
Machine C
Status
Incentage
Component
MD
Incentage Incentage
Component Component
Appl. A Appl. C
Figure 2-2 Distributed Architecture
The components are combined as needed and allow the realisation of arbitrary
Integration topologies.
An Incentage component is a self-contained application that provides all the

functionality necessary to process data from a certain protocol, with certain
syntax to another syntax and protocol. Depending on it’s configuration it can
perform tasks like data conversion, routing, data enrichment, etc. Because a
component is equipped with transaction management, a status, and various
supporting facilities it can run on any machine. Figure 2-2 illustrates the
distributed architecture of Incentage. The shaded boxes represent different
machines.
The processing of messages is done by the components. They run

independently of any centralized controller and therefore avoid a critical point
of failure.

2.2.2 Modules
An Incentage component is subdivided into modules. It is
important to understand this module structure. It is used in many
different contexts. The module structure is the basis of the
flexibility of Incentage. It allows custom configuration, a flexible
version management, development by different persons, decoupling of the
components from their presentation, and more.
The following picture illustrates one instance of an Incentage component

consisting of (multiple) Sources, a Converter, and (multiple) Targets, controlled
by the Component Control.
Transaction
Msg Coordinator Rep DB
Input Output
Input Output
Source Convertor Target
Log
Control
Remote Control
Service
Component Control
Figure 2-3 Component Architecture Overview
The Converter is optional. It is possible to directly connect the Source module

with the Target module.
The Source module consists of an Adapter and a Parser.
The Target module consists of a Builder and an Adapter.
Note that it is possible for the converter to replicate messages and route them
to different target modules.
It is also possible to use multiple source modules allowing one converter to be

fed by multiple sources using multiple data structures.

The Message Coordinator is responsible for transaction semantics in the

component. It coordinates the committing of input and output media and the
reporting database.
The component is multithreaded, separating the processing of messages and

the communication with the Control Service. The processing of messages is
driven by the Processor module.
2.2.3 Configuration of a Component

The configuration of a component is specified in a component
configuration descriptor (CCD). This descriptor is an XML
document and describes
• Which modules the component consists of
• Which classes implement the modules
• The configuration of the modules
The following picture shows the role of the CCD when starting up a component:
JAVA
JAVA
JAVA
classes
classes
classes
Load
appropriate
classes
Generic Configured
Component Customized
Executable Component
Component
Configuration
Descriptor
Figure 2-4 Component Startup and Initialisation
An installation of an Incentage component consists of a generic executable

(GCE), a collection of Incentage classes and a CCD.
The GCE is started and reads in the CCD. From the CCD the GCE recognizes
which component it needs to start and loads the appropriate class(es). These
classes are then initialised with the settings stored in the CCD. The result is a fully
customized and configured component.

The advantages of this concept are:
• Deployment of a component is very easy. You only need to copy the

class repository, the GCE and a CCD to the machine.
• Version updating can be done partially. You need to add the JAVA
classes to the repository and modify the CCD to support the new
version.
An example of a CCD (not complete):
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE IncentageCCD SYSTEM "ccd.dtd">
<Component
ModuleName=”ISOConverter1”
ModuleVersion=”1.3.2”
ModuleImplementation=”component”>
<ComponentSettings/>
<Log
ModuleName=”FileLog”
ModuleImplementation”log2file”>
<LogSettings>
<LogPath>log/isoconverter/1/log/</LogPath>
<LogLevel>2</LogLevel>
</LogSettings>
</Log>
<Processor
ModuleName=”Processor”
ModuleImplementation=”processor”>
<Realtime=”on”>
<ErrorTolerance Level=”3”>
<Input …>
…
<Source …> … </Source>
<Source …> … </Source>
…
</Input>
<Converter …>
…
</Converter …>
<Output …>
…
</Output>
</Processor>
</Component>
Figure 2-5 Example CCD
2.3 Incentage Processing Steps

In Incentage there are five main steps that the data takes from its source to its
target representation. The steps cover all the way from the source application
or media to the target application or media.
The following picture explains the steps. Feel free to take the illustration on the
next page out of the file and place it onto your table so that you can keep an
eye on it.

Processing Reading Message Parsing Message Conversion Building Message Writing Message
Steps
Incentage
Input Adapter Parser Converter Builder Output Adapter
Module
Reading message Analysing syntax of Restructering, Creating a string from Writing message to
from protocol or messages. Creating mapping, converting, the message object media or sending via
Description media. Splitting message object with formatting the following a certain a protocol.
batches of messages fields. Business message object. syntax
objects are created.
Id F ie ld Id F ie ld
1:F01BCITITMMAXXX6438407 Aer akkk ll
:16R:GENL Id F ie ld Id F ie ld
Rii jjcs 84
:28E:1/ONLY Id F ie ld Id F ie ld
Apo cmwo 82
:20C::SEME//253310748 Id F ie ld Id F ie ld
Aer akkk ll
Visual :23G:NEWM :28E:1/ONLY Aer akkk ll Rii jjcs 84
:69A::STAT//20030329/20030331 :20C::SEME/ Id F ie ld
Id F ie ld
Rii jjcs 84 Apo cmwo 82
:22F::SFRE//DAIL :23G:NEWM Apo cmwo 82 Aer akkk ll
:97A::SAFE//253310748} Id F ie ld Id F ie ld Rii jjcs 84
:97A::SAFE//253310748} Id F ie ld Id F ie ld
Apo cmwo 82
:97A::SAFE//253310748}
Message type is Based on the Complex builders

extracted from the message type, the usually use the
Message type message string and correct entry point is message type to
assigned to the used to convert. lookup meta data in
message object. the data dictionary
Message Conversion Message

Meta Data Dictionaries Rules Dictionaries
Figure 2-6 Incentage Processing Steps

2.4 Defining Rules

In order to convert messages, you need to be able to define
conversion rules. You can do this using the Incentage Rules
Studio. This is a GUI that allows you to view, create and modify
the rules. The Rules Studio is only available for Windows and
requires the Microsoft Office environment.
As the Incentage Middleware is built upon Java that runs on both, Windows
and Unix, the RulesStudio and the Middleware are loosely coupled through XML
documents. This means that you can save the rules into XML documents that
are fully compatible to any operating system.
Figure 2-7 illustrates the rules repository.
Rules Studio
Test Windows
Production any Java capable OS
Rules Repository
*.xml
Message Incentage Message

Component
ccd.xml
Figure 2-7 Rules Repository
It is recommended to apply version management to the rules repository, i.e. its

XML documents containing the conversion logic.

2.5 Test Questions

What is an example of an Incentage component?
a. File Input Adapter.
b. The combination of the Rules Studio and the

Converter.
c. The combination of Input Adapter, Parser, Converter, Rules

Studio, Builder and Output Adapter.
d. The combination of Input Adapter, Parser, Converter, Builder

and Output Adapter.
The correct answer(s) are/is:
Which statements are correct?
a. The converter is not mandatory for a valid Incentage

component.
b. An Incentage component may have multiple output modules

but only one input module.
c. The ccd.xml contains the conversion rules.
d. The rules repository runs on Windows only.

Incentage Education Incentage Installation Environment
3 Incentage Installation Environment
3.1 Goal
In this chapter you get an overview on the Incentage runtime environment. This
allows you to quickly install Incentage and understand the steps.
3.2 Incentage Installer

The Incentage Middleware Suite is equipped with a fully
functional installer that guides you through the installation of
the software step by step.
Figure 3-1 Incentage Installer
The next section gives an overview over the building blocks of an Incentage
installation.
3.3 Software Involved

Incentage is a Java application. This means that it does require
a Java Virtual Machine (JVM) to run with. Consequently the
JVM – also called Java Runtime Environment (JRE) – is the first
thing that needs to be installed. You can see the role of the JVM
in Figure 3-2. Note that the JVM is the glue between the operating system (OS)
and Incentage. This independence from the OS means Incentage can run on
every platform for which a JVM is available.

Incentage
EMail
ODBC Security
MQSeries XML
Java Virtual Machine
OS
: Libraries (jar files)
: java.exe & java libraries ( jar files)
: Binaries (.class files) & ressources
Figure 3-2 Incentage Runtime Environment
Incentage consists of a core system (red in Figure 3-2) and additional libraries
(the yellow and blue boxes). All this software consists of Java .class or .jar files
and can be found in the Incentage Installation directory.
To run Incentage a set of start scripts (batch files in Windows) are used.
The scripts start the JVM, load Incentage and include the required libraries. The
scripts provide you with a single entry point to the Incentage Runtime
Environment.
3.4 Operating System Notes

Incentage – as a Java application – can run on almost any operating systems.
As long as a recent Java VM is in your PATH, the installation is identical on all
supported operating systems. This tutorial is based on an installation on a
Microsoft Windows 2000 / XP system.
Refer to the chapter "Software Requirements" in the document “INCENTAGE

Soft- and Hardware Requirements” for more details.
3.5 Incentage Installation Steps Summary

In summary, an Incentage installation will consist of the following steps:
1. Install Java. Test the Java Installation.
2. Run the Incentage Installer.

3. Run the Incentage Configuration Manager.
4. Test the installation.
The next chapters will explain these steps in detail.
3.6 Questions
What is the advantage of Incentage being a Java
application?
a. No operating system is required.
b. The Java Virtual Machine has something to

glue together.
c. Incentage can run on any popular operating system.
Which statements are correct?
a. Incentage runs inside an application server that needs to be

set up in order to run Incentage.
b. Installing Incentage only requires four steps.
c. No manipulation of the operating system configuration is

required.
b, c

Incentage Education Installing Java
4 Installing Java
4.1 Goal
The goal of this chapter is to learn und understand how to install Java in order to
make your computer ready for an Incentage installation. You will understand
what is necessary to install Java, what main components belong to Java and
how you can test whether the Java installation was successful.
4.2 Overview
Incentage requires Java from Sun Microsystems. Make sure to
install a supported version to profit from Java optimizations and
bug fixes. Information about the newest release of Java can be
found on the internet on http://java.sun.com/j2se/.
Refer to the chapter "Software Requirements" in the document “INCENTAGE

Soft- and Hardware Requirements” for more details.
4.3 Installation
Java has become a very popular platform and is widely
used. Therefore you should first see whether you already
have Java installed:
Open a Dos Prompt and type:
java.exe –version
If the result you get looks like this, you can skip the next steps and proceed
with the last point, the testing of the Java installation:
C:\>java -version
java version "1.4.2_04"
Java(TM) 2 Runtime Environment, Standard Edition (build
1.4.2_04-b02)
Java HotSpot(TM) Client VM (build 1.4.2_04-b02, mixed mode)
Listing 4-1 Java Version Information
Note, that it is sufficient if the first three numbers match (1.4.2). The sub
release (04) is not relevant.
If you don’t have Java installed, execute j2re-1_4_2_04-windows-i586-i.exe,

which you can find on the accompanying CD. This will start the installation of
the Java Runtime Environment.
Install Java to your program files directory.

Incentage Education Installing Java
4.4 Test the Java Installation

If you have just installed Java you can skip this test. Otherwise open a Dos
Prompt, navigate to C:\ and type the following command:
C:\>java –version
Now you should get the version information as shown in Listing 4-1.

Incentage Education Installing Incentage
5 Installing Incentage
5.1 Goal
This chapter guides you through the process of installing Incentage on a
Windows machine. The installation on UNIX machine is described in a separate
document.
5.2 Setup
Locate the file setup.jar on the CD.
Run setup by double-clicking it, or by running java -jar

setup.jar on the command line if the file associations for .jar
files are not configured accordingly. Follow the wizard to
install Incentage:
Figure 2: Incentage Installer
On the first page (see Figure 11) of the Installer, the directory where Incentage
should be installed to, can be specified. Incentage does not rely on being
installed in a specific directory, so you are free in the choice of this directory.
Good practice is C:\incentage or C:\Program Files\incentage. Click "Next" to
start the installation.

Figure 3: Installation completed
Click "Next" after the installation has succeeded. Incentage is installed now;
you will configure it in the next section. Click "Launch ConfigurationManager" to
jump directly to the configuration.
Figure 4: Thank you for installing Incentage!
5.3 Configuration
Before proceeding to starting the ManagementConsole the
new installation must be configured. If the Incentage
ConfigurationManager is not yet running (because it was not
launched from the final installation screen), start it now by
double-clicking ConfigMgr.bat in the directory where Incentage
was installed.

Figure 5: Incentage Configuration Manager
Chose the Java Virtual Machine Incentage should use. The default value is the
Java VM in your system path. If the instructions above to install Java were
followed, all default values of this page can safely be accepted. Click "Next".
Figure 6: Libraries selection
Some libraries exist in more than one version. For example, MQ Series 5.3 needs
different drivers than version 5.2. Select the appropriate version or choose
"Default" if the version is unknown or the library is not used.

Figure 7: External library paths
On the last page of the ConfigurationManager, installation-specific paths for

some libraries can be specified. For example, DB2 is often installed in
C:\Program Files\SQLLIB; of its subdirectories the BIN and the FUNCTION
directories contain platform-specific code the DB2 library needs to load. Leave
the fields empty if you do not need these libraries. Click "Finish" to exit the
Incentage ConfigurationManager.
The Configuration Manager can be started at any time if there is a need to

reconfigure the installation of Incentage.
5.4 Test the Installation

Double-click on run_mc.bat in the directory you installed Incentage to. If the
ManagementConsole opens you have successfully installed Incentage.
Congratulations!
You can create a shortcut on your desktop to have the Incentage

Management Console “at your fingertips”.
5.5 Upgrading Incentage

Upgrading an existing installation of Incentage is not different
that the installation you just completed. It involves exactly the
same steps: execute setup.jar, and run the Incentage
Configuration Manager.

Incentage Education Converting the First Message
6 Converting the First Message
6.1 Goal
This chapter enables you to take over an Incentage environment, start it and
process a message.
6.2 Take Over an Environment

Follow the steps below:
Unzip the file Incentage_Training_0.0_JumpStart_Exercise.zip

from the CD provided by your teacher onto your C drive.
After this, you will have the environment on C:\IMS\EDU_JumpStart.
Start the management console by double-clicking on its shortcut.

If it does not start, check the correctness of the shortcut: does it really point to
the right directory where the management console can be found?
Login with username admin and leave the password field empty.
Figure 6-1 Login for the ManagementConsole

Add the component by loading the ccd.xml into the management console.
You can do this by selecting the menu [Flow], [Add component from file…].
Chose the ccd: C:\IMS\EDU_JumpStart\ccd.xml.
Select the component in the tree view on the left side.
Right-click on the component and select [Run component process] button.

The component is now ready. This is indicated by a change of the Icon.
Right-click on the monitor icon in the tree and choose [start]. The component
is started and the rules are loaded into the converter. All lights in the tree
should become green.

Incentage Education Converting the First Message
Figure 6-2 Start the Component

Use the Windows Explorer to rename the input file from
C:\IMS\EDU_JumpStart\in\message.done to message.in. As soon as you
have done this, this message will be processed.
Check the output directory C:\IMS\EDU_JumpStart\out. It contains now the

processed output message.
Congratulations! You have processed your first message with Incentage.
6.3 Test Questions

Fill in the correct answers!
The [Run component process] command:
a. Reads the ccd.xml and generates the

component.
b. Reads the rules repository and generates the component.
c. Reads the ccd.xml and generates the module.
Selecting the [start] menu item:
a. Reads the ccd.xml.
b. Reads the rules repository and processes any message available in

the input areas.
c. Reads the rules repository and waits for a message to be processed
d. Processes one message.
b and c

Incentage Education Further Exercises
7 Further Exercises
7.1 Goal
This chapter contains further exercises to illustrate the processing of messages
with Incentage.
These exercises are optional and not required in order to proceed with the
training.
7.2 Process Multiple Messages I

This exercise will show how to process multiple messages. The messages are all in
the same file.
Ensure that the component is running (green icons). If they

are not, follow the steps described in section 6.2.
Open the directory C:\IMS\EDU_JumpStart\in\ in the

Windows Explorer.
Open the file message.done with an editor. You will see the following
message:
SOM
999MessageType=MT1
Amount=13'400.30
Amount_Cur=EUR
Valuta=19.06.2002 10:43:22
EOM
Duplicate the message by marking the whole content of the file, copying it,
and pasting it to the end of the file. Now the content of the file should look as
follows:
SOM
999MessageType=MT1
Amount=13'400.30
Amount_Cur=EUR
Valuta=19.06.2002 10:43:22
EOM
SOM
999MessageType=MT1
Amount=13'400.30
Amount_Cur=EUR
Valuta=19.06.2002 10:43:22
EOM
Save the file.
Rename the file message.done into message.in.

Incentage Education Further Exercises
Note the numbers of processed messages in the ManagementConsole. The

count increases by two. Incentage has interpreted the content of the file
and recognised that there are two messages.
Figure 7-1 Message Count
Repeat the steps with more messages in the same file.
7.3 Process Multiple Messages II

In this exercise you will process a batch of files that contain messages. You will
automate the processing of the batch.
Ensure that the component is running (green icons). If they

are not, follow the steps described in section 6.2.
Open the directory C:\IMS\EDU_JumpStart\in\ in the

Windows Explorer.
Mark the file message.done. Press Ctrl+C to copy the file. Press Ctrl+V to
paste the file. Repeat pressing Ctrl+V until there are about ten copies of the
file.
To rename all the files to *.in, we use a batch file that allows to rename all the
files in one go.
Create a new text document (Right-click in the Explorer, choose [New] –

[New Text Document].
Open the text document in the Editor and enter the following text:
rename *.done *.in
Save the file, close the editor and rename the file to “rename.bat”.
Double-click on the file rename.bat. All files are renamed and the messages
are processed. Note the message count in the Management Console.

01 Incentage Training 0.0 Jump Start

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

01 Incentage Training 0.0 Jump Start

Uploaded by

Copyright:

Available Formats

Incentage Education

PART NUMBER: EDU-JS108-E, Rev 4.10, 11-Aug-08

ABSTRACT: This document provides an outline of the Incentage Middleware

APPLICABILITY: This document is recommended for integrator trainees new

MATERIAL: Education CD Part 0.0 containing the environment used in

PREREQUISITE TRAINING: None

Revision Date Comment Author

This document is proprietary. It is an unpublished work protected under the

© Incentage Corporation 2002-2008. All rights reserved.

Responsible Department: Education

Responsible Person: christian.stillhard@incentage.com

APPROVAL: This document has been approved by Incentage Services

The following are trademarks of Incentage:

1.1 Goal 1-1

2 INCENTAGE MIDDLEWARE SUITE 2-3

2.1 Goal 2-3

3 INCENTAGE INSTALLATION ENVIRONMENT 3-11

3.1 Goal 3-11

4 INSTALLING JAVA 4-14

4.1 Goal 4-14

5 INSTALLING INCENTAGE 5-16

5.1 Goal 5-16

© copyright Incentage AG, 2002-20087 i

6 CONVERTING THE FIRST MESSAGE 6-20

6.1 Goal 6-20

7 FURTHER EXERCISES 7-22

7.1 Goal 7-22

Figure 2-1 Incentage Building Blocks......................................................................................... 2-3

Figure 2-2 Distributed Architecture ............................................................................................ 2-4

Figure 2-3 Component Architecture Overview....................................................................... 2-5

Figure 2-4 Component Startup and Initialisation .................................................................... 2-6

Figure 2-5 Example CCD.............................................................................................................. 2-7

Figure 2-6 Incentage Processing Steps ..................................................................................... 2-8

Figure 2-7 Rules Repository .......................................................................................................... 2-9

Figure 3-1 Incentage Installer.................................................................................................... 3-11

Figure 3-2 Incentage Runtime Environment .......................................................................... 3-12

Listing 4-1 Java Version Information ........................................................................................ 4-14

Figure 2: Incentage Installer...................................................................................................... 5-16

Figure 3: Installation completed............................................................................................... 5-17

Figure 4: Thank you for installing Incentage! ......................................................................... 5-17

Figure 5: Incentage Configuration Manager ........................................................................ 5-18

Figure 6: Libraries selection........................................................................................................ 5-18

Figure 7: External library paths .................................................................................................. 5-19

Figure 6-1 Login for the ManagementConsole ..................................................................... 6-20

Figure 6-2 Start the Component............................................................................................... 6-21

Figure 7-1 Message Count......................................................................................................... 7-23

© copyright Incentage AG, 2002-20087 ii

Integration project managers: Those who are responsible for the

The secondary audience for the Jump Start volume includes:

Data Conversion Engineers: Those responsible for entering rules and

Sales support specialists: Those responsible for selling Incentage Middleware

1.3 Guide to this Training Module

© copyright Incentage AG, 2002-20087 1-1

This icon indicates important information to be read.

Table 1-1 Icon Meaning

© copyright Incentage AG, 2002-20087 1-2

2 Incentage Middleware Suite

1. Incentage component: It performs the actual processing of

2. Incentage ManagementConsole: The graphical user interface (GUI) to

3. Incentage RulesStudio: A GUI to create, edit, document, and manage the

Rules Editor Management Console

Figure 2-1 Incentage Building Blocks