Using the Java Gateway in a Production - InterSystems Documentation

2
Using the Java Gateway in a Production
This chapter describes how to use the Java Gateway in a production. It discusses the following topics:
• Adding the Java Gateway Business Service
• Settings for the Java Gateway Business Service
• Calling Business Service Methods
• Creating a Business Operation
• Calling API Methods
• Using the Command Prompt
• Using the Java Gateway Wizard
• Error Checking
• Troubleshooting
2.1 Adding the Java Gateway Business Service
While it is possible to start the Java Gateway server from the command prompt, the simplest way to use the Java Gateway
with an Ensemble production is to add and configure the EnsLib.JavaGateway.Service class as a business service within
the production. You can only do this if the Java Gateway server is on the local machine where you are running Ensemble.
Otherwise, you need to start the Java Gateway server from the command prompt. For details, see “Using the Command
Prompt.”
Important:
You cannot add a Java Gateway business service to a production running on an OpenVMS operating system.
The service starts the gateway using pipes and command pipes, which are not operational on OpenVMS.
To add the EnsLib.JavaGateway.Service class as a business service in your production, use the [Ensemble] > [Production
Configuration] page of the Management Portal. The following steps summarize the configuration procedure:
1.
Click the add icon (
) next to the Services column to start the Business Service Wizard.
2. Click the All Services tab, and choose EnsLib.JavaGateway.Service as the Service Class. You may accept the default
values for the other settings.
3. Click OK to display the updated production diagram.
Using the Java Gateway 9