Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The MixForward utility settings are stored in the mixforward.exe.xml file that must be located in the same folder as the MixForward.exe executable file for utility’s correct operation. The configuration file can be edited using the text editor (for instance, Notepad).

The configuration file allows setting up the following processes:

  1. connecting to POS terminal or third-party software.
  2. processing the data transfer protocol from the POS-terminal.
  3. logging the routing process.
  4. forwarding data to the IP-address and port of POS-server.
  5. receiving titles from multicast titles broadcast.

Image Removed

The table describes the configuration elements of MixForward utility.

...

Element name

...

Element description

...

Element attribute

...

Attribute description

...

Value range

...

InputPortType

...

POS-terminal data transfer protocol

...

-

...

-

...

RS232

UDP

TCP

TCPCLIENT

MSMQ

PLUGIN

WEBSERVICE

JMS

...

ServerPort

...

Local port number, if InputPortType is TCP or UDP

...

-

...

-

...

From 0 to 65535

...

MultiCast

...

Enables the function of receiving multicast messages if the UDP interface is selected in the InputPortType

...

-

...

-

...

True – function of multicast messages receiving is enabled

False – function of multicast messages receiving is disabled

...

Address to which multicast messages from external POS program will be sent in case of the UDP interface is selected in InputPortType parameter

...

ProtocolName

...

Current data transfer protocol from the POS-terminal

...

-

...

-

...

Depends on the number of plug-ins linked to MixForward

...

LogFileMaxSize

...

Maximum log file size, bytes

...

-

...

-

...

-

...

true - the log is enabled

false - the log is disabled

...

Enables or disables the creation of its own detailed log by the plugin (for debugging only!)

...

RS232_settings

...

A group of elements.

COM-port settings if InputPortType is RS-232

...

PortName

...

Available COM-port name

...

Depends on the number of available ports

...

BaudRate

...

Supported bit rate, bit/s

...

Depends on the number of supported bit rates

...

RtsEnable

...

Enable RTS option

...

0 – do not use RTS control signal

1 – use RTS control signal

...

DtrEnable

...

Enable DTR option

...

0 – do not use DTR control signal

1 – use DTR control signal

MSMQ_settings 

...

A group of elements.

MSMQ settings if InputPortType is MSMQ

...

true - messages are filtered by time
false - messages are not filtered by time

...

true - messages are deleted
false - messages are not deleted

...

A group of elements.

Sets JMS settings if InputPortType is JMS

...

A group of elements.

Specifies TCPCLIENT settings if InputPortType is TCPCLIENT

...

forwards

A group of elements.

Sets the correspondence between the routing id and POS-server IP-address/port

...

ip

...

POS-server IP-address

...

Depends on the POS-server network settings

...

port

...

POS-server port

...

Depends on the POS-terminal object settings

...

id

...

Routing id

...

Depends on the routing id value in the data package. If the id=”*”, then data from all POS-terminals is redirected to the POS-server

...

A group of elements.

Specifies PLUGIN settings if InputPortType is PLUGIN

For details, see 

...

Info
titleNote

If the events come in from several objects, the correspondence between the routing id and POS-server IP-address/port should be set for each of these objects. See the example below.

Image Removed

Note
titleImportant!
  If the routing id of a package has no match in the utility configuration file, and the id=”*” is not set, the package is deleted.