Tag Archives: Transformation Extender

Websphere Transformation Extender Partner Manager Tutorial- Define ODBC Data Source

Trading Manager uses a relational database to store information about tradingpartners, routing instructions, access privileges, document tracking and tradingrelationships. A sample Microsoft Access database is included with the PartnerManager installation.

1. From the Windows Start menu, select Settings → Control Panel →Administrative Tools → Data Sources ODBC.The ODBC Data Source Administrator dialog opens.

2. Select the System DSN tab, and then click the Add button.The Create New Data Source dialog opens.

3. Select Microsoft Access Driver (*.mdb) from the list box, and then click Finish.The ODBC Microsoft Access Setup dialog opens.

4. In the Data Source Name field, enter the following information:TradingManagerTutorial5. Click Select.The Select Database dialog opens.

6. Navigate to C:\install_dir\<tmgr_vn.n\pmgr and select the tmgrnn.mdb file.

7. Click OK.The Select Database dialog closes. The new entry, TradingManagerTutorial, isnow displayed in the ODBC Data Source Administration dialog in the SystemData Sources list box.

8. Click OK.The ODBC Data Source Administrator dialog closes and the System DataSource Name is defined.

Websphere Transformation Extender with Websphere MQ

How do you set a input or Output Card to post the transformed or incoming file to a Websphere MQ queue?

This will show how WTX can GET or PUT a untransformed or transformed input or output to a MQ queue.

Step 1: Open up WTX Design Studio and create a Transformation map with input and output card.

Step 2:  Specify the Map Location for the WTX input or output card (depending if you want the message to come from MQ or to put a transformed data to an MQ queue)

Step 3: Select the source to be Websphere MQ (server) and specify the Queue Manager name and Queue you want to place or put the message:

-QMN YOUR_QUEUE_MANAGER_NAME -QN YOUR_QUEUE_NAME

Test this by putting a message on that queue and running the transformation map.

Websphere Transformation Extender Launcher Monitor and Management Console

After you have created your WTX Launcher project as seen in the previous post you can get more information on your transformation in the Management Console in a text based interface and Launcher Monitor in a graphical interface.

Setup the Management Console setup:

1. Open the Management Console and Click on Launcher New, complete the following fields:

– Launcher Name :  a descriptive name for your Launcher.

– Host name: host name where your WTX launcher is running

– Login Name: the name of the Access User you created in the WTX Launcher Administration (make sure that the user has Granted access)

– Password: password for the User

2. Right click on the new Launcher you have created and click -> Connect

This is the information after I have completed 21 transformations

There is more information that can be retrieved looking at the Status, History and Configuration tabs.

Setup the Launcher Monitor

1. Open the Launcher Monitor click on Options->Select Launcher

2. Select the Appropriate Launcher by Name

3. Provide the Login Username and Password as specified in the Management Console.

4. Click on Connect to verify that the connection is valid and it will show the System Name and System File Name.

5. Click on OK and the following view can be seen as maps are being transformed.

So the small red dots show unsuccessful maps and green dots show successful maps transformed.

You can set up different colours for: Map Warnings, Map Error, Map Success and Map in Progress.

Websphere Transformation Extender Launcher Tutorial

So how do you set up Websphere Transformation Extender Launcher to automatically transform incoming files with the correct transformation map en produce an output map. With this the launcher also comes with the Launcher Management Console which provides you detailed information on the status of transformed files. The Launcher Monitor provides you a graphical interface of your transformed maps. I will show how they all are used and how they can provide you with almost any level of detail on transformations in your enterprise.

Below is the steps to configure Websphere Transformation Extender Launcher:

1. Open Integration Flow Designer.

2. Click on the purple circle icon and drag it onto the pallet. It will ask to navigate to a .mms file, that is a map file already create in WTX Design Studio.

3. Double click on the newly imported .mms map to see the input and output cards respectively.

4. Confirm that the map executes without errors click on System -> Build Maps

5. If no errors occurred click on System->Deploy-> Definitions
6. Double click on ‘Generate and Transfer Launcher Control File’ and save it to the following directory: C:/IBM/Websphere Transformation Extender 8.3/system

7. After you have set your system file location close the Definition window and click on System Deploy->THE_NAME_OF_YOUR_MAP

You will see the following message if the map was deployed successfully.

8. Click on Yes to see the deployed map, it mus look something like this:

Deploy Results for System LauncherTest (Version 8.3(23))
Script:   DeployTest
Date:     Wed Sep 15 12:29:37 2010
File:     C:\TXTest\Launcher.msd
Deploy has completed successfully.
Total # of errors:  0
Map Building:
Number of maps processed:    1
Number of successful builds:  1
Number of maps with errors:   0
Number of maps with warnings:   0
The following map built successfully:
C:\Documents and Settings\Administrator\My Documents\LauncherLab_Verify\FiletoFile.mms: FileTest
Launcher File Generated For: LauncherTest
Map File Transfers:
Copied C:\Documents and Settings\Administrator\My Documents\LauncherLab_Verify\FileTest.mmc to C:\TXTest\FileTest.mmc.
Launcher File Transfer:
Copied C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\SE5C.tmp to C:\IBM\WebSphere Transformation Extender 8.3\systems\LauncherTest.msl.

Deploy Results for System LauncherTest (Version 8.3(23))
Script:   DeployTest Date:     Wed Sep 15 12:29:37 2010 File:     C:\TXTest\Launcher.msd

Deploy has completed successfully.
Total # of errors:  0

Map Building:
Number of maps processed:    1
Number of successful builds:  1Number of maps with errors:   0Number of maps with warnings:   0

The following map built successfully:
C:\Documents and Settings\Administrator\My Documents\LauncherLab_Verify\FiletoFile.mms: FileTest

Launcher File Generated For: LauncherTest

Map File Transfers:
Copied C:\Documents and Settings\Administrator\My Documents\LauncherLab_Verify\FileTest.mmc to C:\TXTest\FileTest.mmc.
Launcher File Transfer:
Copied C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp\SE5C.tmp to C:\IBM\WebSphere Transformation Extender 8.3\systems\LauncherTest.msl.

9. Open up WTX Launcher Administrator

10. Click on the Access Tab and create a new user which you Grant access to All systems.

11. Click on the Deployment Directory tab and confirm that the Directory path is the same as where you created you msl file.

12. Now you are ready to start WTX service in your Windows service registry

13. Navigate to the file from which you imported the mms file in Step 2. Copy and paste the input the folder to see the output being created automatically by the launcher.