BEA WebLogic Java Adapter for Mainframe Samples Overview

BEA WebLogic Java Adapter for Mainframe (WebLogic JAM) is designed to integrate applications running in a WebLogic Server environment with applications running in a mainframe environment. WebLogic JAM includes complete samples that are installed as part of the product installation. These samples are provided to demonstrate how WebLogic JAM integrates WebLogic and mainframe applications. This guide explains how to run the samples that are included with WebLogic JAM.

The following topics are described in this section:

• About the WebLogic JAM Samples

• How to Use the Samples

 

---

About the WebLogic JAM Samples

The samples included with WebLogic JAM allow you to see different capabilities of WebLogic JAM. The samples are much less complex than any standard production application and are not intended to be guides to application programming.

Samples have been included as a part of the WebLogic JAM software to:

• Verify that the product was installed correctly

• Demonstrate the way WebLogic JAM integrates WebLogic and mainframe applications

Samples are designed to run "out of the box" with minimal modification. Most tasks are preconfigured or configured during installation by the installer program. You are required to only enter configuration that applies to your specific environment.

Two types of samples are installed when you install WebLogic JAM:

• Verification Samples

• Programming Samples

Verification Samples

WebLogic JAM provides two installation verification samples, one for an IMS region and one for a CICS region. These samples allow you to verify the success of the WebLogic JAM installation as well as demonstrate WebLogic JAM integration in a WebLogic and mainframe environment. These samples are described in the BEA WebLogic Java Adapter for Mainframe Installation Guide.

Programming Samples

The samples that are categorized as programming samples demonstrate how WebLogic JAM can be used with your system.

• IMS Samples

  • IMS Application to WebLogic Server Sample JMS Topic

    This sample demonstrates making an asynchronous call through WebLogic JAM from IMS to a Java application running under WebLogic Server.

  • Java Client to IMS Sample Application

    This sample demonstrates a Java client calling remote services located in an IMS region.

  • Transactional Sample from WebLogic Server to IMS

    This sample demonstrates how a Java client makes calls to remote services located in an IMS region. The service calls that alter the data on the mainframe occur within the boundaries of two-phase commit transactions.

• CICS Samples

  • CICS Application to WebLogic Server Sample EJBs

    This sample demonstrates the functional capability provided by WebLogic JAM to invoke the services of an EJB (Enterprise Java Bean) deployed in a WebLogic Server from a CICS client.

  • Java Client to CICS Sample Application

    This sample demonstrates the invoking of CICS services from requests that originate from a Java client.

  • Transactional Sample from WebLogic Server to CICS

    This sample demonstrates making calls to remote services located in a CICS region from a Java client. The service calls that alter data on the mainframe occur within the boundaries of two-phase commit transactions.

• Explicit APPC Sample

  • Batch MVS COBOL Client to WebLogic EJB Sample

    The purpose of this sample is to demonstrate the functional capability of invoking the services of an EJB (Enterprise Java Bean) deployed in a WebLogic Server from the mainframe environment, specifically from a batch MVS client using explicit APPC.

 

---

About the Samples User

The samples are provided to demonstrate various capabilities and functions of WebLogic JAM. Samples users typically fulfill one of the following roles:

• Systems Programmer

• Mainframe Application Programmer

• Java Application Programmer

For a description of user roles, see the BEA WebLogic Java Adapter for Mainframe Home Page.

 

---

How to Use the Samples

While the WebLogic JAM samples contain precompiled source for the Java portion of the sample, you may choose to generate and compile source. Depending on your skill level, experience, and time-constraints, you may choose to work with the Java portion of the samples in the following ways:

• Run the sample

  Because of the contents shipped with the samples, in most cases, you can simply run the sample with minimal configuration to run on your system. The sample will use the supplied .class files.

• Compile source and run the sample

  Each sample provides build scripts that allow you to compile the source. This option allows you to see how the source is compiled and run the sample.

• Generate source, compile, and run the sample

  Each sample provides eGen scripts. This option allows you to use the eGen Application Code Generator to generate the source. You can then run the build scripts. By using this option, you can see how the eGen utility generates source and run the sample.

In general, each of the samples include:

• Java Files

  • Java .class files

  • Java source

  • eGen scripts

  • Build scripts

  • Preconfigured WebLogic Server domain

• Mainframe Files

  • Mainframe source

  • Sample JCL

  • IMS or CICS sample configurations

Java Sample Code

The philosophy of keeping the samples simple is demonstrated in the Java segments of the samples. For samples with Java clients and mainframe servers, stand-alone client classes are used instead of using client EJBs because the standalone clients are simpler to code, understand, deploy, and include in your applications. The servlets that can be generated by the eGen Application Code Generator are not used because you may have difficulty enhancing them to improve their presentation or functionality.

Mainframe Sample Code

Mainframe sample programs are minimal, but are sophisticated enough to demonstrate the features of WebLogic JAM. Mainframe samples are designed to take advantage of the "least common denominator" of IMS or CICS features that you might have available. For example, some of the IMS samples interact with the installation verification transaction, IVTNO, that is shipped with IMS. CICS samples use Temporary Storage (TS) queues and VSAM files to imitate the behavior of databases, rather than assume you have a database installed.

Note: JCL to compile the mainframe sample programs is included as examples to provide completeness. The sample JCL may not conform to your standards or installations. It may need to be modified or replaced to meet your needs.

Program definitions and other configuration for your CICS or IMS region may require coordination with your IMS or CICS system programmer.

Preconfigured WebLogic Server Domains

The WebLogic JAM installation includes a directory named config. This config directory contains subdirectories for two preconfigured WebLogic Server domains. These WebLogic Server domains are:

• verify

  WebLogic Server domain that is set up for running the installation verification

• examples

  WebLogic Server domain that is set up for examples of WebLogic JAM running with WebLogic Server and mainframe applications

 

---

Before You Run the Samples

Before you run the samples, the following tasks must be completed:

1. Install WebLogic Server.

   For information about installing WebLogic Server, see the BEA WebLogic Server documentation.

2. Install WebLogic JAM.

   For information about installing WebLogic JAM, see the BEA WebLogic Java Adapter for Mainframe Installation Guide.

3. Define the Logical Unit (LU) for the CRM and vary it active.

   For information about defining the Logical Unit for the CRM, see the BEA WebLogic Java Adapter for Mainframe Configuration and Administration Guide.

4. If using IMS, verify that the APPC communication to IMS is active.

   For information about APPC communication with WebLogic JAM, see the BEA WebLogic Java Adapter for Mainframe Configuration and Administration Guide.

5. If using CICS, the connection must be defined to the CICS region.

   For information about CICS connection when using WebLogic JAM, see the BEA WebLogic Java Adapter for Mainframe Configuration and Administration Guide.

After these tasks have been completed, determine which of the samples you want to run and refer to the corresponding section:

• Using the IMS Samples

• Using the CICS Samples

• Using the Explicit APPC Sample