Attachmate Verastream Transaction Integrator Guide

 

Deploying to a Development Environment

The Transaction Designer creates interface objects during the project creation process. When you build a project you are creating the files necessary to interact with the host via the runtime service. The input and output values, parameters, and element properties for the interface objects are based on the values you specified in the client operation in the design tool.

What is an Interface Object?

You can generate two types of interface objects: Java objects (both ICA task files and task beans) and legacy Microsoft Visual Studio .NET 2003 Web services.

NOTE: Designer projects that contain REDEFINES cannot be used to generate ICA task files.

To deploy to a development environment

This procedure assumes that you have created and saved a project in Transaction Designer and then created a Web Builder project using that designer project.

  1. Confirm that the CICSClient or IMSClient, depending on your Transaction Designer project type, are installed on each machine where your client applications will be run.

    If you are building a server-based application to run on the same server where the run-time service is installed, after setting your classpath, no additional configuration is necessary.

  2. Select the project you want to deploy from the Web Builder project list.

  3. Right-click on the project name in the generated file list. Choose Explore to navigate to the generated jar file.

    Alternatively, you can select Explore from the Project menu.

  4. If you are deploying:
    Do this...
    Task Beans
    1. Copy install_dir\Attachmate\Verastream\TransactionIntegrator\Web Builder\
      Continued lineprojects\<project_name>\<project_name>.jar
      to the machine where you will compile your applications and from where they will be served.

      <Project_name>.jar contains the Java bean and the transaction runtime module classes necessary to run the application.

    2. Add <project_name>.jar to your classpath.
    ICA Task Files
    1. Create a sub-directory named ClientJars under the cicsclient or imsclient directory.

    2. Copy install_dir\Attachmate\Verastream\TransactionIntegrator\Web Builder\
      Continued lineprojects\<project_name>\<project_name>.jar
      to the sub-directory you created in step one.

      The jar file contains the XML task file and the transaction runtime classes necessary to run the application.

    .NET 2003 Web Services

    (.NET creates an installer to deploy your Web service. In .NET Visual Studio 2003, the target directory is NETTarget2003).

    1. Run this file: install_directory\Attachmate\Verastream\TransactionIntegrator\
      Continued lineMetaData\task_name\webservice\NETTarget\setup.exe
      to run the generated installer from the Transaction Designer computer.

      You can run the installer on a different server than where the Transaction Designer is installed by copying the contents of the NETTarget folder to the target server and running setup.exe.

    2. Test your Web services deployment by typing the following into the address field of your browser:

      http://server_name/project_name/?wsdl

    3. You can access the .NET Web service by adding a Web reference to your Visual Studio project.

    4. Copy your <project_name>.jar file into install_directory\Attachmate\Verastream\TransactionIntegrator\CICSClient\ClientJars.

      This file contains the information necessary to run the application.

  5. Develop and run your application.
Related Topics
Bullet Using Interface Objects in Applications
Bullet Building Resuable Interface Objects
Bullet Build a Web Builder Project
Bullet API Reference
  Attachmate