Table of Contents Previous Next PDF

Tuxedo Mainframe Transaction Publisher

Tuxedo Mainframe Transaction Publisher
This document includes the following topics:
Tuxedo Mainframe Transaction Publisher simplifies the process of exposing mainframe transaction in Oracle Service Bus (OSB) by providing a graphical user interface.
Let us consider this scenario, where users want to expose their mainframe transaction in OSB. The proxy service uses WSDL and the business service uses WTC.
The tool generates POJO code based on the input COBOL copybook. These generated codes can be used by users to access mainframe transaction.
Using Tuxedo Mainframe Transaction Publisher
Tuxedo Mainframe Transaction Publisher includes two parts: Generator and Publisher. They are implemented as JDeveloper extensions and reside in a single JAR file.
Tuxedo Mainframe Transaction Publisher is a project based tool. Users select the project and right click to bring up context menu.
Tuxedo Mainframe Transaction Generator
Tuxedo Mainframe Transaction Generator is implemented through the JDeveloper hook. Users access this function by clicking the "Tuxedo Mainframe Transaction Generator" menu item.
By selecting this function, a graphical user interface base wizard window will be brought up to guide users to do the following things.
Eventually, Tuxedo Mainframe Transaction Generator generates seven artifacts that are organized in two parts.
Select COBOL Copybook
The following picture shows the wizard page for selecting COBOL copybook.
Define Code Generation Details
The following screenshot shows the wizard page for defining code generation details.
The following fields are used.
Transaction ID
Name of the mainframe transaction. This is used in code and artifacts generation to name the OSB project, artifacts, and data mapping classes.
POJOs Package
This is used as Java package name for the mapping classes.
This is used as WSDL and schema namespace in the WSDL and XSD OSB artifacts.
Configure Transaction Input and Output
The following screenshot shows the wizard page for configuring the input and output fields from the COBOL copybook.
Enter Transaction Details
The following screenshot shows wizard page for entering information needed by mainframe transaction.
The following fields are used.
Tuxedo transaction resource name
Name of the generated Tuxedo transport/WTC import that will be generated.
Tuxedo transaction remote name
Name of the Tuxedo service on the remote Tuxedo domain as exported from there.
Tuxedo remote domain
ID of the remote Tuxedo/TMA domain.
Tuxedo network address
Network address for the Tuxedo/TMA remote domain.
OSB local domain
ID of the OSB domain.
OSB network address
Network address of the OSB domain.
WebLogic target server
Name of the WLS server.
Users are allowed to set the defaults value for the mainframe transaction details according to user needs through the JDeveloper's "Preference" menu item from the "Tools" drop down menu.
Tuxedo Mainframe Transaction Publisher
Tuxedo Mainframe Transaction Publisher is implemented through the UI hook. Users access this function by selecting the Tuxedo Mainframe Transaction Publisher menu item.
By selecting this function, a welcome wizard page will be displayed to do the following things.
Pack Artifacts
In this step, the artifacts generated by Tuxedo Mainframe Transaction Generator are packed. The following wizard page tells users the name of the packaged JAR file, and where it will be generated.
Publish to OSB
The following wizard page helps users to publish the generated artifacts to OSB. This Tuxedo Mainframe Transaction Publisher function allows users to specify the OSBs URL, administrator's name, and administrator's password.
Installing/Uninstalling Tuxedo Mainframe Transaction Publisher
To ensure successful installation of the Tuxedo Mainframe Transaction Publisher, a pristine JDeveloper should be used. Users should install the pristine JDeveloper at a new location; they should neither import any preference from other installations nor use JDeveloper to start from installer.
After installation, users use the following commands to start the JDeveloper.
Installing Tuxedo Mainframe Transaction Publisher
The Tuxedo Mainframe Transaction Publisher is distributed in a single zip file named "tuxedo.mtp.update.<version>.zip". Its current version is
Do the following steps to complete the Tuxedo Mainframe Transaction Publisher installation.
After completing the installation, jar files will be installed in MW_HOME/JDeveloper/jdev/extension/tuxedo directory.
The zip file is located in $TUXDIR/udataobj. To find out "", open the JDeveloper and click the "Help" menu item in the menu bar, and select "Check for Updates" from the drop down menu that is brought up.
Checking Installation Status
After the installation, when the updater asks to restart JDeveloper, choose not to. Then users go to the command line and re-enter jdeveloper/jdev/bin/jdev -clean -console to verify whether the installation is successful.
Users can check the installation status using any of the following ways.
Using graphical user interface
Click "Help"- "About" - "Extension".
Using command lines
Listing 1 Using Command Lines to Check Installation Status
D:\oracle\jdeveloper\12.1.2_2>jdeveloper\jdev\bin\jdev -su -clean -console
osgi> ss tuxedo
Framework is launched.
id State Bundle
Uninstalling Tuxedo Mainframe Transaction Publisher
Do the following steps to uninstall the Tuxedo Mainframe Transaction Publisher from JDeveloper's menu bar.
Installation Notes
Tuxedo Mainframe Transaction Publisher requires
Setting up JDeveloper Project
Users must set up the "Library and Classpath" for every project before using Tuxedo Mainframe Transaction Publisher; otherwise, the compilation of the generated class fails.
To do the setup, right click the project to bring up context menu and select "Project Properties". Then select "Add JAR/Directory" and add the eGen libraries.
Setting up Oracle Service Bus (OSB)
Installing EGen Libraries for OSB
It is required for users to add eGen libraries to OSB's classpath by doing the following steps.
Edit <domain_path>/bin/ and eGen libraries to the classpath.
The eGen libraries can be extracted from the updated zip file.
Users should add the followings to
Listing 2 Adding Information to
# EGen Classpath for MTP
BASE_EGEN_LIBS_PATH=<location of the libraries>
Importing Shared Resources to OSB
An OSB project with some shared resources is used by Tuxedo Mainframe Transaction Publisher generated OSB resources. The file with complete OSB project is in $TUXDIR/udataobj/mtp_shared_sbconfig.jar.
System Administration > Import Resources
Enter the mtp_shared_sbconfig.jar location.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.