WebSphere MQ Workflow 3.4.0 Java Generic API Test / Prototyping Tool

[prev][next][parent][TOC]

Installation

Prerequisites:

To use the IBM WebSphere MQ Workflow 3.x Java Generic API Test and Prototyping Tool, you must have installed and configured the IBM WebSphere MQ Workflow Java APIs. For details, see the IBM WebSphere MQ Workflow 3.x Installation Guide for the prerequisites you need for the Java APIs (for example, Java Runtime Environment JRE, etc.).

Installation / Configuration:

  1. Copy the WebSphere MQ Workflow Java API Test Tool / Prototyping Tool ( fmctogat.jar) into the "bin\java3xxx"-directory where you installed MQ Workflow 3.x or any other directory.
  2. Add the WebSphere MQ Workflow Java API Test Tool / Prototyping Tool to your classpath.
  3. For example:  set classpath=<ToolDirectory>\fmctogat.jar;%classpath%       (OS/2 / Windows platforms)
                  or
                  export CLASSPATH=<ToolDirectory>/fmctogat.jar:$CLASSPATH    (UNIX / OS/390 platforms)
  4. If you plan to run scenarios in C-API-Syntax or if you plan to use the tool macro Agent.locateViaPropertyFile,  install (copy) the JGATT.properties file into the directory where your console window is running. Then modify the properties to your needs.
  5. Verify the classpath settings of the tool by invoking the MQ Workflow Java API Test Tool / Prototyping Tool in a console window.
  6. For example:  java com.ibm.workflow.api.tool.JGATT
                  or
                  jre -classpath <path> com.ibm.workflow.api.tool.JGATT
    As a result, you get a report from the tool showing its invocation possibilities.

  7. Troubleshooting:

  8. If the steps 1 to 4 are o.k., but an java.lang.NoClassDefFoundError exception occurs when running a scenario, or any other unexpected errors occur, check the classpath for other missing paths of classes:
    Component Required classpath settings Remarks
    API on MQWF Java agent fmcojagt.jar of MQWF
    API on MQWF thin client fmcojapi.jar of MQWF
    java classes.zip of JDK  (< JDK 1.2)
    jre rt.jar of JDK/JRE (< JDK 1.2)
    jre (in conjunction with NLS) rt.jar;i18n.jar of JDK/JRE (< JDK 1.2)
    Corba vbjapp.jar;vbjorb.jar of Inprise VisiBroker for Java
    Corba vbjcosnm.jar of  Inprise VisiBroker for Java for COS_LOCATOR