Ucm

Communication Manager

ucm(U)

Synopsis Environment Description Files See also

Synopsis

windows\System\Ucm.exe

Environment

Windows

Description

The Unitec Communication Manager Ucm.exe handles all UCM communication task in the Windows client environment. Incoming data is locally distributed in UCM message format. Outgoing messages are received and are transmitted through the winsock.dll standard communication interface. For maximum speed, local data transfer between Ucm and the application programs is accomplished by the use of OLE/COM technology. Benchmark tests have shown, that UCM is capable to distribute thousands of messages per second. The only limitation arises form network throughput.

Ucm is automatically started upon the first inter-system message transfer. To reduce application load time, you may however start Ucm at Windows startup time. Ucm is located in your Windows System directory.

Ucm shows a status icon in the system tray, normally located on the right side of the taskbar:

The green triangle indicates the communication output status, the red triangle indicates the input status.

Color	Status
grey	idle
red	communication start
green	communication end

The Ucm Monitor window can be opened by double clicking on the status icon:

UcmMonSt.gif (7885 bytes)

Selecting the Connections tab will show the current connection status:

UcmMonCon.gif (6505 bytes)

The information shown is:

Node	Description
	Each ID node represents a UCM communication space. The number shown represents the setting of the CommID(P) property in the contained UCM controls.
	Each IP node represents a TCP/IP socket connection to the Host(P) and Port(P) indicated. All contained controls use the same connection. The special wildcard entry '*' contains the controls that have not (yet) set their IP properties.
	Each Ax node represents one instance of an Active-X control Ucm.ocx.
	The I node shows the current input message ID settings in the InputID(P) property of the parent control. It contains input message and character statistic leafs.
	The O node shows the current output message ID setting in the OutputID(P) property of the parent control. It contains output message and character statistic leafs.
	Shows the number of messages sent or received.
	Shows the number of characters sent or received.

Selecting the Show Log button will open the message log window:

UcmMonLog.gif (6029 bytes)

Each message log entry has the following syntax:

TF[ID] Message data

where:

Message type: I for input, O for output, E for error

Status flag, meaningful for input messages only:

blank	message has been forwarded to one UCM Acive-X control
2..9	message has been forwarded to the number of controls indicated
*	message has been forwarded to more than 9 controls
-	message could not be forwarded, no control was ready to accept this message ID

Message ID as defined by the InputID(P) or OutputID(P) properties. Error message expose the number of the error occurred. For a list of all UCM errors, refer to the Error(E) event description.

Warning:

Pressing the Unload button when active UCM connections exist, may cause your programs or the operating system to hang. Whenever it is unsafe to unload Ucm.exe you will be prompted with a warning dialog.

Files

Windows Registry

UCM configuration at HKEY_LOCAL_MACHINE\SOFTWARE\Unitec\Ucm