Description |
UcmConf is a user friendly interface for modifications
of the UCM registry configuration data. It provides two
sections, Services
and Autostart.
1. Services This section defines the remote services that may be used in the Service(P) property of the UCM Active-X Control.
These definitions are required for remote communication with the AdrMode(P)
property set to ucmService only. With the ucmTCP addressing mode and for
local interprocess message transfer, no services need to be defined. Each entry in this
section consists of three fields:
| Entry |
Description |
| UCM Service |
The UCM service ID that can be used as Service(P) property in the Ucm.ocx control. |
| TCP/IP Port |
The TCP/IP port number or name that will provide the services identified
by UCM Service. When using a symbolic name, it must also be defined in the
TCP/IP services
file of the local and the remote system referenced by the Host IP Address
entry. Each line in the services file holds the server name, a port number and a
port type (type should always be ‘tcp’). To avoid conflicts with
standard TCP/IP ports, these numbers should have values > 5000
assigned by convention. Unitec software uses port
numbers in the rage 6800 to 6999, e.g. for a future
version of the license manager the port 6800 has been reserved and the CSS
spooler uses port 6801. To avoid conflicts with standard TCP/IP and Unitec
ports, you should use numbers in the range 5001 to 6799
or >= 7000. The server names and port numbers must match on
both systems. Example:
aServer 5001/tcp
The TCP/IP Port entry defaults to the value stored in UCM Service. It is
possible to have several different UCM Service’s using the same TCP/IP Port.
This will result in multiple TCP/IP socket connections, one for each UCM Service in
use. |
| Host IP Address |
The host IP address or name as defined in the TCP/IP hosts
file. |
2. Autostart
This section defines the programs that shall provide automatic, event driven
message processing service. Each entry in this section consists of two fields:
| Entry |
Description |
| MsgID |
Whenever UCM has to deliver a message of the defined MsgID
and does not find a process waiting for such a message (no UCM Active-X Control
with the InputID(P) property set to this message ID),
the program defined in the Program column will be started. |
| Program |
The full path of the executable that will process the UCM message.
It is important, that such programs do have an Ucm.ocx control with the InputID(P) set to the value of MsgID. |
| Hint: Use UcmConf to properly configure one client system in a
new network environment. Once you have verified correct operation, run the Windows regedit
and navigate to the location
HKEY_LOCAL_MACHINE\SOFTWARE\Unitec\Ucm\Services
Choose the export option to write the selected branch to e.g. services.reg.
Copy this file to the other client systems and double click on it from the Windows
Explorer. This will import the same settings into the new clients registry.
The same procedure can be applied to the AutoStart
definitions at
HKEY_LOCAL_MACHINE\SOFTWARE\Unitec\Ucm\AutoStart
|
|
