Deployment Configuration Requirements

Describes Web Service property settings and enterprise server region configuration requirements for successful deployment of the different types of supported COBOL Program service interfaces.
Restriction: This topic applies only when the Enterprise Server feature is enabled.

Web Service Properties

Before deploying a COBOL Program service interface, ensure that you have set the Web Service properties appropriate for the type of service interface. Generally, you can accept the default properties; however, you might need to make some adjustments.

See To set deployment properties for instructions on making changes to Web Service properties.

Enterprise Server Requirements

Enterprise Server provides a default enterprise server region, ESDEMO, that is configured to run COBOL program-based services. However, if you want to create and configure an enterprise server region to use specifically for your service, follow the steps outlined in To create a new enterprise server, and use the ESTemplate.xml template.

Web Services and J2EE listener
You need to adjust the Web Services and J2EE listener configuration of your enterprise server region. The Endpoint URL port number is 9003 by default and must match the port number specified for the Web Services and J2EE listener of the associated enterprise server region. If you change the Endpoint Address in your project, be sure to update the Port listener property of your enterprise server region to match. See To set a fixed port in a listener endpoint address for details.
Note: If you decide to use a port other than 9003, be sure to update the Endpoint URL port number in your Web Service properties.
Other Considerations
Before deploying a service interface, ensure that you have addressed each of these items:
  • Start the enterprise server region.
  • If your enterprise server region runs in 64-bit, and you deploy from a Windows 32-bit system, then the service driver program is not compiled and the compiled service driver program is not included in the deployment package. However, the COBOL source for the service driver program is always included in the deployment package. You must recompile the COBOL source for 64-bit; then copy the compiled program to the enterprise server region. See Compiling Native COBOL Programs for 64-Bit for instructions.
  • If your enterprise server region is running on a remote UNIX installation of Enterprise Server, you can still deploy to that enterprise server region; however, after you deploy, you must then compile the generated driver program for your service on the platform where Enterprise Server is running. See To compile a service driver program on a remote UNIX machine for instructions.