Installation guide

11.3.1 - Configuration settings
Setting Description
Server
name
Specifies the name or IP address of the machine running the TCP server. The default value is localhost,
which is the machine that the emulator is running on.
Port
number
Must match the port number set in ShareScan Administration Console. Default value is 9325, which
matches the default for ShareScan.
Timeout
(seconds)
Value in seconds until the terminal times out if no pulses are received from ShareScan Manager. The
default value is 120 seconds.
Device IP Specifies the IP address of device.
CLID Emulates the type of data fields (client identification) you enter in a terminal.
Delimiter The field delimiter for the activity tracking and fake CLID and MID fields. This value matches the value
set up in ShareScan Administration Console, the default is ",", which matches the default used in
ShareScan.
MID Emulates the type of data fields (Multiplex Identification) you enter in a terminal.
XML name Inserts the XML name.
Value Inserts values.
Note: You can add, view, and clear the XML attributes.
Encryption
type
The type of encryption used to encrypt the XML data:
l None: Passes credentials to ShareScan without encryption.
l TripleDES: Enables you to encrypt the information sent from the application that is supplying the
credentials to ShareScan. You can do this by creating an encryption key that you store on the computer
where the Manager is running and on the Cost Recovery device. If TripleDES encryption is enabled, the
eCopyCRSKey.txt file must reside in the path location specified in the eCopyShareScan Administration
(Activity Tracking, Cost Recovery tab). After this file is generated by the Administrator Console, the file
is copied to the Cost Recovery Terminal so that it uses the same TripleDES key encryption value.
Key path You can browse for the path location of the encryption eCopyCRSKey.txt file. This file contains the
Initialization Vector (IV) key used to seed the encryption provider.
Protocol
version
You can choose which eCopy protocol to send and receive data between the Cost Recovery terminal and
ShareScan Manager. The following versions are available: v1, v2, and v3 (default).
Enter
credentials
Click to bring up a dialog to enter the following user credentials for use: Username, Password, Domain,
and UserID.
Note: If UserID is being used, UserName, Password, and Domain must be blank.
Save and
close
Saves all field data to tcpclient.ini. The emulator always tries to load any value held in this file, which
is located in the same folder as the emulator executable.
Note:
The text at the top of the status window (default value of Waiting for server messages) gives helpful tips about the
state of the emulator.
Once the emulator has been configured, it is ready for use.