This document covers the following topics:
The deployment service is the (server-side) counterpart to the deployment wizard; see Server Mapping Deployment Wizard. It is a built-in service of the EntireX RPC server, which can be enabled/disabled by EntireX RPC server configuration settings.
Usage can be restricted to certain users or group of users, using EntireX Security; see Authorization of Client and Server.
You need to configure the deployment service only when server-side mapping files are used. There are also client-side server mapping files that do not need configuration here; see Server Mapping Files for COBOL in the Designer documentation.
The deployment service is used in conjunction with the
IDL Extractor for COBOL to deploy server-side mapping files with the deployment wizard;
COBOL Wrapper for RPC server generation to deploy server-side mapping files with the deployment wizard.
See also Deploying Server-side Mapping Files to the RPC Server.
The deployment service uses the same class and server names as defined
for the EntireX RPC server, and DEPLOYMENT as the service
name, resulting in
class/server/DEPLOYMENT
as the broker service. Please note DEPLOYMENT is a
service name reserved by Software AG. See broker attribute
SERVICE.
To enable the deployment service
For an RPC Server for CICS, the server-side mapping container (VSAM file) must be installed and configured. See Step 1: Define a Server-side Mapping Container - VSAMDEF.J (Optional) under Installing the z/VSE EntireX RPC Servers.
Set ERXMAIN Macro parameter DPLY=YES.
See DPLY under Configuring the RPC Server.
Define in the broker attribute file, under the RPC service, an
additional broker service with DEPLOYMENT as the
service name and values for class and server identical to those used for the
RPC service. For example, if your RPC service is named
CLASS = RPC SERVER = SRV1 SERVICE = CALLNAT
the deployment service requires the following additional service definition in the broker attribute file:
CLASS = RPC SERVER = SRV1 SERVICE = DEPLOYMENT
Optional. If you need to restrict the use of the deployment service to
a selected group of users, use EntireX Security and define security rules
for the
class/server/DEPLOYMENT
broker service. The service name DEPLOYMENT is a constant.
For a z/OS broker, see Resource Profiles in EntireX Security.
For a UNIX or Windows broker, see Authorization Rules.
Not applicable to a BS2000 or z/VSE broker.
To disable the deployment service
Set ERXMAIN Macro parameter DPLY=NO.
See ERXMAIN macro parameter DPLY.
The RPC Server for CICS will not register the deployment service in the broker.