Tutorial: EJB Service Interface

Walks you through the process of defining an Enterprise Java Bean (EJB) service interface using the Interface Mapping Toolkit (IMTK), deploying it to an enterprise server instance, and generating and running a client to access it.
Restriction: This topic applies only when the Enterprise Server feature is enabled.
Restriction: This topic applies to Windows environments (local development) only.

Before You Begin

Before beginning this tutorial, be sure that you have completed all tasks outlined in the Prerequisites section of the Tutorials: Interface Mapping Toolkit topic.

In addition, the following prerequisite software must be installed and configured:

JDK 1.8
To successfully deploy and access a Java service, you must have the Java Development Kit (JDK) and a Java application server installed. The Java JDK version 1.8 is installed automatically with Visual COBOL. No further configuration is required.
JBoss EAP 7.1
This tutorial provides instructions for using JBoss Application Server version EAP 7.1 with cumulative patch 4. Therefore, to complete the tutorial successfully, install and configure the JDK and JBoss software as required.

Using any text editor, edit the standalone.xml file, located in your JBoss installation's standalone\configuration (Windows) or standalone/configuration (UNIX) directory, as follows:

Disable the jca subsystem
Edit the <archive-validation> child of the <subsystem xmlns="urn:jboss:domain:jca:5.0"> element to read as follows: 
<archive-validation enabled="false" fail-on-error="true" fail-on-warn="false"/>
Add the mfcobol-notx.rar resource adapter
Replace the existing resource-adapters subsystem element in its entirety with the following subsystem definition: 
<subsystem xmlns="urn:jboss:domain:resource-adapters:5.0">
	<resource-adapters>
		<resource-adapter>
			<archive>mfcobol-notx.rar</archive>
			<transaction-support>NoTransaction</transaction-support>
			<connection-definitions>
				<connection-definition class-name="com.microfocus.cobol.connector.spi.CobolNoTxManagedConnectionFactory" jndi-name="java:/eis/MFCobol_v1.5" pool-name="CobolConnectionFactory">
					<pool>
						<min-pool-size>2</min-pool-size>
						<max-pool-size>10</max-pool-size>
					</pool>
					<security>
						<application/>
					</security>
				</connection-definition>
			</connection-definitions>
		</resource-adapter>
	</resource-adapters>
</subsystem>

Overview

In this tutorial, we take you through the following tasks:
  • Review the code in the COBOL demonstration application to become familiar with how it works
  • Create a project for the ScheduleDemo application and EJB service interface
  • Define a Java/EJB service interface to access the COBOL application
  • Deploy the service interface to an enterprise server instance as an EJB
  • Generate and deploy a JSP client to access the service
  • Deploy the resource adapter to JBoss
  • Run the JSP client, accessing the service

Sequence

Complete this tutorial by following the instructions in the following topics in the order listed here. The bottom of each topic provides Previous topic and Next topic navigational links to help you proceed through the tutorial in its proper sequence:

  1. Demonstration Application
    Describes the BookDemo application used in this tutorial.
  2. Create the ProgramEJB Project
    Walks you through the process of creating a Visual COBOL project for the BookDemo application.
  3. Set Build Configuration Properties for ProgramEJB
    Walks you through the process of setting Build Configuration properties for the ProgramEJB project.
  4. Add Demonstration Files to ProgramEJB
    Walks you through the process of adding BookDemo demonstration files to the ProgramEJB project.
  5. Create an EJB Service Interface
    Walks you through the process of creating a Java Enterprise Java Bean (EJB) service interface for the BookDemo application.
  6. Define Service Interface Operations
    Walks you through the process of defining details for the AccessBooks service interface.
  7. Configure ESDEMO
    Walks you through the process of creating a deployment folder and configuring ESDEMO to use it.
  8. Deploy the Java Interface
    Walks you through the steps required to associate an enterprise server instance with your project, build the project, set deployment properties, deploy the service interface, and verify the deployment results.
  9. Generate and Deploy a JSP Client
    Walks you through the process of generating a JSP client for the AccessBooks service interface, and deploying it to your JBoss application server.
  10. Deploy the Resource Adapter to JBoss
    Walks you through the steps required to deploy the Micro Focus resource adapter to JBoss.
  11. Run the JSP Client
    Walks you through the process of running the generated JSP client to access the new service.
Parent topic: Tutorials: Interface Mapping Toolkit
Related concepts
Tutorials: Interface Mapping Toolkit