Documentation for POS PSIM 1.0.1.

Previous page Setting up the MixForward utility  Configuring data reception from plug-ins Next page

The MixForward utility is configured using the mixforward.exe.xml configuration file. The configuration file is located in the same directory with the MixForward.exe executable file. You can edit the configuration file using any text editor.

Attention!

When you update POS PSIM, the mixforward.exe.xml configuration file is overwritten and all settings are returned to default values.

The configuration file allows you to set up the following processes:

  1. Connection to a POS terminal or third-party software.
  2. Processing of the data transfer protocol from a POS terminal.
  3. Maintaining routing LOG files.
  4. Forwarding data to the IP address and port of POS server.
  5. Receiving the packages with captions from multicast captions broadcast.

The table describes the configuration elements of MixForward utility.

Element name

Element description

Element attribute

Attribute description

Value range

InputPortType

Used data transfer interface from a POS terminal 

NA

NA

RS232

UDP

TCP

TCPCLIENT

MSMQ

PLUGIN

WEBSERVICE

JMS

ServerPort

Number of a local port processed by the utility if UDP interface is selected in InputPortType

NA

NA

From 0 to 65535

MultiCast

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

NA

NA

true—reception of multicast messages is enabled

false—reception of multicast messages is disabled

MultiCastIP

Address to which multicast messages from external POS program are sent if UDP interface is selected in InputPortType

NANAIP address to which multicast messages are sent

ProtocolName

Name of the used data transfer protocol

NA

NA

NA

LogFileMaxSize

Maximum size of LOG files in bytes

NA

NA

NA

LogInputEnables or disables the log of received dataNANA

true—log of received data is enabled 

false—log of received data is disabled

PingTimeThe period of forwarding of a test package in secondsNANAUp to 60 seconds
PrivateLog

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

NANot available for all pluginstrue—the plugin will keep its detailed log
false—the plugin won't keep its detailed log

RS232_settings

A group of elements.

Specifies the settings of COM port if RS-232 inteface is selected in InputPortType

PortName

Name of an available COM port

Depends on the number of available COM ports

BaudRate

Supported data transfer rate in bit/s

Depends on the number of supported data transfer rates

RtsEnable

Enable RTS option

0—RTS control signal isn't used

1—RTS control signal is used

DtrEnable

Enable DTR option

0—DTR control signal isn't used

1—DTR control signal is used

MSMQ_settings 

A group of elements.

Specifies the settings of MSMQ if InputPortType is MSMQ

ReconnectTimeoutThe time after which an attempt is made to restore connection, if messages are not receivedUp to 60 seconds
NoTimeFilterEnables or disables messages filtering by time

true—messages are filtered by time
false—messages aren't filtered by time

DeleteMessagesEnables or disables message deletion after they are read

true—messages are deleted
false—messages aren't deleted

Queue.PathPath to the queueNA
Queue.TerminalNumber of the terminal that is inserted for the specified queueNA
JMS_settings

A group of elements.

Specifies the settings of JMS if InputPortType is JMS

UrlURL addressNA
LoginLoginNA
PasswordPasswordNA
HttpStreaming Settings


A group of elements.

Specifies the settings of transferring XML files via HTTP protocol




HttpStreaming useEnables or disables the mode of transferring XML files via HTTP protocol

true—the mode of transferring XML files via HTTP protocol is enabled

false—the mode of transferring XML files via HTTP protocol is disabled

ipIP address of the POS serverDepends on the network settings of the POS server
portPort of the POS serverDepends on the settings of the POS-terminal object
TcpClients_Settings

A group of elements.

Specifies the settings of TCPCLIENT if InputPortType is TCPCLIENT

IpAddressConnection addressNA
PortConnection portNA
MessageCommand to send (optional)NA
IntervalInterval of sending the Message command in ms (optional)NA
IdTerminalTerminal id for the node, to be specified in the forwards section (optional)NA

forwards

A group of elements.

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



ip

IP address of POS server 

Depends on the network settings of POS server 

port

Port of POS server

Depends on the settings of the POS-terminal object

id

Routing id

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

PluginSettings

A group of elements.

Specifies the settings of the Liko, SecurOS and LogisticsSystemPlugin plugins if InputPortType is PLUGIN

For details, see Configuring data reception from plug-ins

NANANA

Note

If several POS terminals send data, the number of established connections is equal to the number of recipient addresses and for each POS terminal it is required to determine whether the routing ID matches the IP address and port of the POS server.

Example of several POS terminals sending events:

Attention!

If the routing id of a package has no match in the utility configuration file, and the id=”*” isn't specified, the package is deleted.
  • No labels