3.3.1 Configurations of the message communication service
The message communication service is required for using the AJS3 linkage function. You need to configure and start the message communication service on both the host running CPA and the host running CPA Option for AJS3.
- Organization of this subsection
(1) Changing the port number of the message communication service
Installing CPA Option for AJS3 causes the services file to have a definition on the port number to be used by the message communication service. The port number must correspond with the port number that is defined for cpamsgsrv on the connected CPA host. For details on the port number, see 3.5 Port number.
To change the default port number, edit the services file.
To change the default service name for the port number, edit the message communication service definition file (iescconf.xml). For details on the message communication service definition file, see E.2 Message communication service definition file.
- Definition to be included in the services file
cpamsgsrv 22260/tcp # JP1 Client Process Automation
- Important
-
-
The message communication service fails to start with the error KNAO0950-E when the port number is not defined in the services file.
-
Ensure that every CPA host that will use the AJS3 linkage function is also configured to have the services file defining the same port number.
-
(2) Starting the service
You do not need to start the service manually because the installer ensures that the service starts automatically. However, you need to start the service manually if you change the startup type from Automatic to a different one after the installation process. To start the service:
-
Open Control Panel and select Services, or select Administrative Tools and then Services.
-
Select the JP1/CPA Message service.
-
Click the Start button.