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.
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.
|Note:||Users install this extension using JDeveloper's update center mechanism. For more information, see Installing Tuxedo Mainframe Transaction Publisher.|
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.
The following picture shows the wizard page for selecting COBOL copybook.
The following screenshot shows the wizard page for defining code generation details.
The following fields are used.
The following screenshot shows the wizard page for configuring the input and output fields from the COBOL copybook.
The following screenshot shows wizard page for entering information needed by mainframe transaction.
The following fields are used.
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 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.
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.
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.
|Note:||Tuxedo Mainframe Transaction Publisher allows users to manually install the OSB project by not selecting "Publish to Oracle Service Bus (OSB)?".|
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.
|Note:||JDeveloper Studio is available for download from Oracle Technology Network.|
The Tuxedo Mainframe Transaction Publisher is distributed in a single zip file named "
tuxedo.mtp.update.<version>.zip". Its current version is 22.214.171.124.
Do the following steps to complete the Tuxedo Mainframe Transaction Publisher installation.
After completing the installation, jar files will be installed in
|Note:||The zip file is located in
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.
Click "Help"- "About" - "Extension".
D:\oracle\jdeveloper\12.1.2_2>jdeveloper\jdev\bin\jdev -su -clean -console
osgi> ss tuxedo
Framework is launched.
id State Bundle
927 RESOLVED com.oracle.tuxedo.mtp_12.1.2
Do the following steps to uninstall the Tuxedo Mainframe Transaction Publisher from JDeveloper's menu bar.
Tuxedo Mainframe Transaction Publisher requires
|Note:||When users install Tuxedo Mainframe Transaction Publisher on Oracle JDeveloper 12.1.2 extension, a matisse related exception will be reported. This exception has no impact on the use of Tuxedo Mainframe Transaction Publisher.|
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.
It is required for users to add eGen libraries to OSB's classpath by doing the following steps.
The eGen libraries can be extracted from the updated zip file.
Users should add the followings to
# EGen Classpath for MTP
BASE_EGEN_LIBS_PATH=<location of the libraries>
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