Deployment Configuration Requirements

Service Interface Properties

Before deploying a COBOL Program service interface, ensure that you have set the Service Interface 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 Service Interface 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 Service 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 Service endpoint URL port number in your Service Interface properties.

JSON service interface invoked using CORS/AJAX

If you have a JSON service interface that you want to invoke using a CORS-supported browser via an AJAX request, you must update the Allowed Origin property with a value of * (asterisk). This enables your associated enterprise server region to accept all requests regardless of the origin.

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.