eCopy Identification Service Terminal Emulator

eCopy Identification Service Terminal Emulator appears when you click Test in Configuring Service: Identification.

To configure the emulator, launch the dialog by clicking the Config button on the main dialog.

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. The default value is 9425, which matches the default for ShareScan.
Timeout (secs)	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.
ID device credentials	The following ID device credentials are required: Username: The login name of the user. Password: The user’s password (optional). Domain: The Domain name you are a member of.
XML attributes	The following ID device credentials are required: XML name: Insert name for the attribute of the XML entry. Value: Insert value that is matched with the XML label. You can add, view, and clear XML attributes: Add XML: Press this button to add the name or value pair to the XML attribute. This is added to the stream on the bottom of the dialog, that is, aaa=111, bbb=222, and so on (additional attributes that have been entered or saved that exist if the text is longer than the dialog box). View XML: Press this button to view the XML file that is sent to server. This includes the username, password, domain, email address and extra attributes added. Clear XML: This button clears all of the additional attributes to be passed to server.
Encryption type	The type of encryption used to encrypt the XML data: None: Passes credentials to ShareScan without encryption. 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 Identification Service device.
Key path	Browse for the path location of the eCopyKey.txt encryption file. This file contains the Secret key value used for TripleDES encryption.
Save and close	Saves all field data.

Once the emulator has been configured, it is ready for use.

The text at the top of the status window (a default value of Waiting for server messages) gives helpful tips about the state of the emulator.

Terminal Emulator settings

Setting	Description
Status Window	Displays the time-stamped status messages.
Connect	Connects to ShareScan using the server name and port configured in the configuration dialog. This button is disabled once a connection has been established.
End	Only enabled once a connection has been established as disconnects from the TCP server. If clicking on the End button in the emulator, the user is not logged out and an error message is displayed. Ensure that you add a SendManagerStartedForIdentificationLogout string type registry key under HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Tungsten\ShareScan\ShareScanManager hive with true value.
Clear	Clears all text in the status window.
Keep connection alive	When checked, the TCP connection between the Emulator and Server is kept alive. If not checked, it terminates the TCP connection after the logon packet is sent to server and no timer or pulsing events occurs.
Original XML Format	When checked, the original XML format is used.
Top Most	When checked, the emulator is always displayed on top of any window. When unchecked, the emulator retains its normal order.
Seconds left until lock	Displays a running countdown in seconds until the emulator times out. When the emulator times out, it disconnects from the TCP server. Maximum timeout is 120 seconds.
Config	Enables the configuration dialog.
NetStat	Enables a command prompt window that runs the netstat –a –p TCP command.
Exit	Closes the application.