WinRVM Options

 Table of ContentsManual Mode | Unattended Mode | Interactive Mode | Reimagine Mode | Options | Version history | FAQ

To access the WinRVM options click "File | Options...".
or press F4 then click the desired tab at the top.

screenshot:

Contents:

General Options 
RVM Communication Options
 
Unattended Mode Options 
Host Options 
Manual Mode Options 
EPPSi Mode Options  
Interactive Mode Options
Reimagine Mode Options
Misc Options
Barcode Options 
Prompt for file names 
POS Options 
Chat Options
Data collection times 
Internet 1 
Internet 2 
FTP server configuration 
Modem Options 


Note: WinRVM's settings are saved in the "current user" setting of the registry. If you configure WinRVM then log into a different Windows user account, your settings will be different!

General Options

screenshot:

screenshot:



POS (Point-of-Sale) related:

Enable POS support

If checked, WinRVM will send data to the store's POS system whenever an RVM prints a voucher. This requires a special POS-version of RVM software.
This setting is disabled by default. If disabled, the remainder of the POS settings are ignored.
If this feature is enabled and WinRVM detects an RVM that doesn't support POS, the following error message will be displayed:
    RVM [port] software doesn't support POS, but POS is enabled in WinRVM!

If enabled, all POS events are logged to "POSlog Month nn.txt" in the CF1500 folder which looks like this:

06/01/06 03:27:55 030000,27270015603275490010,0010
06/01/06 03:27:55 POS:OK
06/01/06 03:28:03 030000,27270015603280380020,0020
06/01/06 03:28:03 POS:OK
06/01/06 03:28:08 030000,27270015603280770025,0025
06/01/06 03:28:08 POS:OK

If "Log additional debugging messages" enabled in the General Options, WinRVM will also display POS events in the main WinRVM window.

Max retries

If WinRVM is unable to send a message to the POS system it will retry to send the message this many times. The default value is 60.
WinRVM will buffer up to 300 messages. The buffered messages are saved to the file "POS msgs to retry.txt" in case WinRVM is restarted.
If a message to the POS system fails and more than 300 are buffered, the oldest 10 messages are purged.

retry int (sec)

If WinRVM is unable to send a message to the POS system it will retry to send the message every so many seconds. The default value is 60 seconds.

IP addr

This is the IP address of the primary POS system. The default value is 127.0.0.1.

alt IP addr

This is the alternate IP address of the POS system. Some POS systems have a backup server in case the main server dies. If enabled, WinRVM will toggle between the two IP addresses if the POS system does not respond.
Leave blank if no alternate POS system exists. The default value is blank.

port

This is the TCP/IP port number of the POS system. The default value is 3040. The same port number is used for the primary and alternate POS IP addresses.

Require numeric POS packet

[Added in pocket WinRVM 1.5.5, WinRVM 1.9.6.].
If enabled and the RVM sends a POS packet (defined by the barcode or "[POS]" field on the voucher) that is not numeric, WinRVM will log "Error, invalid POS msg from RVM (not numeric)".

Using Bluetooth AP for POS  ( only)

This should only be enabled if a Bluetooth Access Point is used to connect to the POS system.
If enabled, WinRVM will reconnect to the Bluetooth connection if it can't connect to the POS system, such as after the pocket PC is powered off or reset.
The default is disabled.

BT name   ( only)

This is the name of the bluetooth dial-up connection. It is only used when the above check-box is enabled. To determine the name of the bluetooth connection, see the "connect via" field in the internet connection options.
The default is "BT Network Access".

Reboot if fail this many in a row

If WinRVM is unable to send this many messages in a row to the POS system, WinRVM will reboot itself as an attempt to fix the connection problem. The default value is 5.

Barcode related:

Use ASCII barcode transmission format (default is ASCII format)

If unchecked, WinRVM will attempt to use the binary transmission format which is twice as fast as the traditional ASCII format, and increases the RVM's barcode capacity from 2845 to 4345 barcodes (UPC-formatted tables), 2519 to 3104 (EAN-formatted tables).
Note: this option was removed from WinRVM 3.1.9 and later and acts as if this options was unchecked.

Use eDAS 2007 recmod format when sending barcodes to RVM, otherwise use individual barcode files named:

This feature supports the eDAS 2007 barcode format. Summary:

When sending barcodes to an RVM, WinRVM first gets the serial number from the RVM. WinRVM then searches RVMINFO.TXT for a match. If the RVM serial number is found, WinRVM searches SITEINFO.TXT for the matching site ID and prompts the user for verification such as:

Northeast eDAS Site Info file
Created 06/27/2007

Store:  280621
Stop & Shop 621, Southbury, CT

Continue? Yes/No


When the technician selects "Yes", WinRVM unzips the appropriate barcode table(s) (siteidX.TBL, serialno+siteidX.TBL) from \cf1500\barcodes.zip
and sends it to the RVM. The unzipped barcode table(s) are deleted to save space when the tech visits the next store.

Note: it doesn't matter what barcode filename format is selected in the General Options when "eDAS 2007 format" is enabled.
This feature is used in the NorthEast U.S. market only.


If unchecked, WinRVM will use send an individual barcode file based on the following selections: [added in ver 1.1.5]

Note: If you want to send barcodes remotely you have to send individual barcode files with the appropriate barcode naming convention. 

Number of zip backups to keep  ( only) [added in pocket WinRVM 1.5.4]

The default is 90, 0 is allowed, max 1000. Note that this number is per backup folder location (SD/CF card, internal flash).
If the number is reduced, WinRVM will ask "Purge old zip backups now (may take a few minutes)?"
Versions of WinRVM prior to 1.5.4 had this value internally set to 90 and it couldn't be changed.

Space should not be an issue for most pocket PCs. The largest site (15 RVMs) generates zip files around 164K. 90 backups = 14.7MB.
This could be a problem for the old iPAQ 2110 with only 22MB of storage.

Restrict barcode clients to barcodes of lengths  [added in WinRVM 3.2.3]

Default values: "6,8,10,13".
This only applies to "barcode client" RVM versions such as Interactive and NexCycle.
If the RVMs scans a barcode with an invalid number of barcode digits, a message will be logged such as "Invalid # of barcode digits: 11". This prevents the RVM from paying 5 cents for a 10 cent bottle whose barcode was incorrectly read (an invalid number of digits) due to the wildcard barcode match. Note: if the barcode is misread and the number of barcode digits is 6,8,10, or 13, the container will be paid 5 cents.

Get error log when retrieving barcodes from RVM

If checked, WinRVM will also retrieve the RVM's error log when barcodes are retrieved from an RVM. 
The error log will be transmitted to the host during a scheduled data collection
The log file is saved in cf1500\upload\ssssss17.uld, where ssssss=6-digit RVM serial number.
Note: requires 11/7/97 or later RVM software.

Get POS log when retrieving barcodes from RVM
[Removed in WinRVM ver 1.8.7., pocket WinRVM ver 1.5.2] The POS log will be automatically retrieved if the RVM supports this feature.

If checked, WinRVM will also retrieve the RVM's POS log when barcodes are retrieved from an RVM. 
The log will be transmitted to the host during a scheduled data collection
The log file is saved in cf1500\upload\ssssss90.uld, where ssssss=6-digit RVM serial number.
Note: requires POS-enabled RVM software.
[Added in pocket WinRVM ver 1.2.9s.]

Get card reader Log from RVM
[Removed in WinRVM ver 1.8.7., pocket WinRVM ver 1.5.2] The card reader log will be automatically retrieved if the RVM supports this feature.

If checked, WinRVM will also retrieve the RVM's card reader log when barcodes are retrieved from an RVM. 
The log will be transmitted to the host during a scheduled data collection
The log file is saved in cf1500\upload\ssssss91.uld, where ssssss=6-digit RVM serial number.
The card reader log is also uploaded from the RVM after each customer is paid in Unattended Mode. This data is appended to "CardReaderLog Month nn.txt" and "CardReaderLogToSend.txt" and then deleted from the RVM.
When making a scheduled call "CardReaderLogToSend.txt" is sent then deleted.
If WinRVM receives a message from an RVM that a card was read, this setting is automatically enabled (requires WinRVM 1.7.0, pocket WinRVM 1.4.3).
Note: requires card reader-enabled RVM software.
Note: in WinRVM versions prior to 1.9.6 no card reader log was saved if WinRVM was not configured to upload the card info to an online database via the "MySQL server" setting in the Interactive Mode Options.

Format of the card reader log uploaded by WinRVM:
card number, date (MM/DD/YY), time (HH:MM:SS), aluminum containers, steel containers, PET containers, glass containers, total points, donate to charity (Y/N), meter reading, RVM serial number

Sample file:
435258444663,02/21/07,14:29:54,0,0,3,0,9,N,19,050120
35258444663,02/22/07,15:21:30,0,0,1,0,1,N,20,050120
903600302184319704,02/23/07,09:38:36,0,0,1,0,1,N,21,050120
5424181014014463,02/23/07,09:39:35,0,0,1,0,1,Y,22,050120
461502841087,02/23/07,10:02:45,0,0,1,0,1,N,23,050120
41579543,02/23/07,10:03:16,0,0,1,0,1,Y,24,050120

Note: in WinRVM versions prior to 1.9.6 and pocket WinRVM version prior to 1.5.6 the RVM's serial number is not included at the end of each line.

Get coupon counts when retrieving barcodes from RVM
[Added in pocket WinRVM ver 1.0.8. Removed in WinRVM ver 1.8.7., pocket WinRVM ver 1.5.2. Reinstated in WinRVM ver 1.9.2, pocket WinRVM 1.5.4]  

The coupon counts will be automatically retrieved if the RVM supports this feature.

If checked, WinRVM will also retrieve the RVM's coupon counts when barcodes are retrieved from an RVM. The coupon counts will be transmitted to the host during a scheduled data collection
Note: requires special coupon-enabled RVM software.

Get non-participating barcodes when retrieving barcodes from RVM

If checked, WinRVM will also retrieve the RVM's non-participating (unknown) barcode list when barcodes are downloaded from an RVM via "Retrieve from RVM | barcodes and counts". The barcodes are saved in cf1500\upload\ssssss03.uld, where ssssss=6-digit RVM serial number.
Example file 04083003.ULD for RVM 040830:
120130FFFF,4
4963400020,4

The barcode is followed by a number representing the container type. See the Table of commodity values for more info.
For more details see "Retrieve from RVM | Non-participating barcodes".
The non-participating barcodes will be transmitted to the host during a scheduled data collection (named ssssss03.uld).
Also see Save list of unknown barcodes scanned by RVM.

Support 3-way enhanced capacity glass RVM instead of regular 3-way RVM   [added in ver 1.3.5, pocket WinRVM 1.0.9]

This option was added for Hawaii and is also used in Iowa. WinRVM can increase the barcode capacity of a glass RVM by three times (from 4345 to 13,035 barcodes) by fooling the glass RVM into thinking it is a 3-way RVM and loading 3 barcode tables (all glass). WinRVM will load clear glass barcodes into the RVM's 'can' barcode table, green glass barcodes into the RVM's 'pet' barcode table, brown glass barcodes into the RVM's glass barcode table. With this new scheme the RVM can't hold more than 4345 barcodes of a single color. No RVM software changes are required, however, we must turn off the aluminum and PET sensors via parameters so the machine will automatically search all 3 barcode tables for a barcode match. 

You must Uncheck "use ASCII barcode transmission format" (this allows more than 2845 barcodes per table to be loaded to the RVM - requires RVM software version 11/20/01 or later) .

For info on how to configure an RVM, see WinRVM ver 1.3.5.

For glass RVMs, only send barcodes whose color is accepted by the RVM  [added in ver 1.3.6, pocket WinRVM 1.0.9]

This option was added for Hawaii and is currently only used there.  If the glass barcode table is too large to fit into a single barcode table in the RVM memory, you can configure WinRVM to only load the green glass barcodes to an RVM that only accepts green bottles (or brown glass barcodes to an RVM that only accepts brown, etc.) If an RVM only accepts clear and green bottles, then only the clear and green barcodes will be sent to the RVM if this feature is enabled.

When sending barcodes to a non-3-way enhanced capacity glass RVM, WinRVM will:
- Determine which glass colors are accepted by the RVM (by uploading the RVM's silo table).
- Take the barcodes that match the colors accepted by the RVM from the default barcode file (such as gbarcode.tbl) and create the temporary barcode file named "Appropriate Glass.tbl".
- Send the temporary barcode file to the RVM.

This feature works with both "Send to RVM | Barcodes (individual file)" and "Send to RVM | Barcodes (via recmod)".
Note: with this method you're still limited to a maximum of 4345 barcodes. In Hawaii, this currently allows clear and green barcodes to fit into the RVM, but brown and green won't fit - to do this you would need to reconfigure a brown/green RVM as a 3-way enhanced capacity glass RVM, then change the REJECT_TYPES parameter to select which glass colors the machine is not to accept (in this example, clear) so you'd set REJECT_TYPES=16.

Save list of unknown barcodes scanned by RVM (barcode-client versions only)  [added in ver 3.1.9]

This feature was added for the France Interactive LCM RVM. When enabled (default is enabled) these barcodes are saved to \cf1500\UnknownBarcodes.txt. File format: barcode,commodity.
Note: barcodes are not right-padded with F, all barcodes and commodities are saved to the same file. This file is sent in with a scheduled data collection if this option is enabled. Example file:
123456,2
1111111111,0

The file UnknownBarcodes.txt will be sent in during a scheduled data collection. Note: this file is never deleted, it simply grows.
Also see Get non-participating barcodes when retrieving barcodes from RVM.

View Unknown barcode list   [added in ver 3.1.9]

Views the list of unknown barcodes scanned by a barcode-client RVM (contents of the file \cf1500\UnknownBarcodes.txt).

Sort barcodes for barcode-client RVMs    [added in ver 3.2.7]

Disable this for maximum speed. Defaults to disabled.

Enable supplemental barcodes in RVM when sending barcodes [added in WinRVM 1.9.2, pocket WinRVM 1.5.4]

Default is enabled. If enabled, prior to sending barcodes to the RVM the new option file supplemental.opt will be sent to the RVM unless the RVM is a PET-only RVM.
The "#T" line in supplemental.opt determines which RVM types this file will be sent to. Supplemental.opt is contained in the
RVM data files or can be downloaded separately from inside this zip file.
Note: this feature could be used to set other parameters in the RVM besides enabling supplemental barcodes, if desired.

The file supplemental.opt contains:
*Enabling supplemental barcodes
#TA,G,AP,AG,GP,L
SUPPLEMENTAL=100 ;non-zero = enable supplemental barcodes, defines scan time x10ms (100)
SUPPLEMNTMODE=0 ;Supplemental barcode search mode: 0=search for UPC first, 1=search for supplemental ONLY
USE_LASER=3 ;Enable laser scanner? (non-zero = yes & defines number of scan attempts) (3)

Don't prompt for meter reading for flex/LCM RVMs [added in WinRVM 3.3.3]

Current flex RVMs don't have a mechanical meter, so don't bother prompting the user in manual mode. Default is enabled.

Don't prompt for meter reading for any RVMs [added in WinRVM 3.3.5]

If enabled and WinRVM is in manual mode, WinRVM will no longer prompt for a meter reading after downloading the RVM's barcode counts nor when uploading barcodes to a barcode-client RVM. This setting can be used in markets such as Australia that don't care about the "HM" line in Q files. Default is disabled. The following warning will be given if you try to enable this feature: "Disabling the meter reading prompt isn't recommended except for unusual cases such as in Australia".

Download barcodes prior to sending barcodes [added in WinRVM 3.7.2]

This fixes the following problem:
When a new barcode table is sent to the RVM, if the total number of barcodes in the RVM memory for the current commodity (including barcodes that are no longer being accepted), is more than 4345 (the RVM's max capacity per commodity) the RVM will delete its barcode table and use just the barcodes from the just-received barcode table, purging any unused barcodes. When this happens the following message is logged:
W140: Barcode table full, reloaded
And crucially, any existing barcode counts are reset and lost forever. With this change, at least you'll get the final barcode counts prior to having the counts reset. Default is enabled.

Folder locations:

Q files

Folder where Q files are saved (including backup Q files), default is \BB. This folder will be created if it doesn't exist.

RVM Tables

Folder where all RVM tables reside, default is \CF1500. When WinRVM is run it creates this folder if it doesn't exist.

Video Files

Folder where video and photos to be used in Interactive Mode reside, default is \CF1500\video. When WinRVM is run it creates this folder if it doesn't exist.

Verify option file operation

If checked, WinRVM will read back parameters to verify option file/parameter changes.
The default is checked.

Misc:

Log to file

This option should be enabled if WinRVM is configured for Unattended Mode. All operations will be logged to the file WinRVMlog.txt. Use the "View | WinRVM log" menu to see the last 32K of the log.
The default is checked.

[added in ver 1.2.5] For debugging purposes, WinRVM now saves an entire year's worth of log entries, separated by month (sample file name: "WinRVMlog Month 04.txt" for February). Note that these log files are saved on the WinRVM PC's hard disk only - they are not transmitted to the host.

Number of months to keep log   [added in ver 1.2.5]  ( only)

Defines how many months of "monthly logs" to keep. The default value is 11.
Note: if this setting is changed to a lower number, the previous month's logs will not be deleted until the month changes.

This setting was removed in WinRVM versions 1.5.4 and later...the software internally defaults to 11.

Automatically center store info on vouchers   [Added in WinRVM ver 1.4.6, pocket WinRVM ver 1.1.7]

If enabled, WinRVM will center the store name and number fields at the top of the Cybertech text vouchers (cash, charity, counters, weight ticket). This setting is enabled by default.
If all your RVM have graphics printers, you should disable this feature.
Do not use with Hecon printer voucher files as the voucher file will become corrupted unless using WinRVM ver 1.5.5 or pocket WinRVM ver 1.29 or later.
Do not edit a Hecon voucher using Total Commander on the pocket PC as this will corrupt the voucher and cause the RVM to go out of service for "no response from printer" after attempting to print the first voucher.
This should be enabled for bag ticket versions with a Hecon X56 printer, otherwise the bag ticket will become corrupted and print gibberish.

Support 'distributor report' RVM software    ( only)

This option should only be checked if connected to an RVM that is using the special "distributor report" software. If the RVM software is updated in this type of RVM, WinRVM will automatically load the distributor report template file (IND_DIST.VOU) to the RVM. This saves the user the step of having to manual send the file via the "Send to RVM | Printer tickets/coupons... | Distributor report" menu.
When checked, the menu text for "Send to RVM | Printer tickets | Counters ticket" is changed to "Distributor counts ticket" and WinRVM will send the file dist.vou instead of counters.vou when this is selected.
The default is unchecked.

Log detailed timing info at end of each line  ( only) [added in pocket WinRVM 3.1.3]

For debugging purposes, this logs time increments less than a second since the last log entry at the end of each line surrounded by [] such as:
<999998> 02/08/11 16:37:15 -- Parsing C:\cf1500\ERRLIST [0.015]
<999998> 02/08/11 16:37:15 -- Entering manual mode [0.046]

Log additional debugging messages  [added in pocket WinRVM 1.1.8]

When enabled, WinRVM logs additional debugging information such as:

even more  [added in WinRVM 1.9.5]( only)

When enabled, WinRVM logs even more additional debugging information such as:
    debug: WaitForSpecificResp() RVMSN_:
    debug: WaitForSpecificResp() SITENM:
    debug: WaitForFlagClear() REQUST:WHO
This is for software engineering debugging purposes only and should normally be left disabled to avoid cluttering up the event log with debugging messages.
The default is unchecked.

Support LED message table (for Japan)      [added in ver 1.1.7]     ( only)

This option should only be checked for Fuji RVMs in Japan to enable the "Send to RVM | LED display message (Japan only)" menu item.

Windows XP look and feel     [added in ver 1.2.7]    ( only)

If enabled, WinRVM will use Windows XP-style user interface elements (buttons have rounded corners, highlight when the mouse hovers, filled with color gradient), etc. when run on Windows XP. WinRVM must be restarted if this setting is changed. Default value is enabled.
If you have Windows XP and it this feature doesn't work, make sure the file c:\program files\WinRVM.exe.manifest exists and right-click the desktop, select "properties | Appearance | Windows and buttons" and select "Windows XP style".
Details: when this check box is not clicked, c:\program files\WinRVM.exe.manifest is renamed to WinRVM.exe.manifest.disabled. 

Automatically sync RVM clock with PC clock in Manual Mode     [added in pocket WinRVM ver 1.1.7]   ( only)

When enabled, whenever WinRVM communicates with an RVM in Manual Mode, the RVM's clock will be synced with the PC's clock. Default is disabled.

Perform backup after CF card update   [added in pocket WinRVM 1.5.4]  ( only)

If unchecked, the backup program will not automatically be launched after the user selects "File | Update RVM files from CF card". Default is enabled.

Show virtual keyboard for text entry   [added in pocket WinRVM 1.3.9]  ( only)

For pocket PCs with a built-in keyboard such as the iPAQ 6550 you may not want to pop up the virtual keyboard as this takes up precious screen space.
The default is checked.

Run WinRVM automatically after reboot     [added in pocket WinRVM 1.2.2]  ( only)

If enabled, this creates a shortcut file (WinRVMLauncher.lnk) in \Windows\Startup which runs ppcUpdater.exe which then launches WinRVM.
After rebooting, a window will display "Preparing to start WinRVM" and give you two seconds to abort (see screenshot to the right). This is the ppcUpdater program. The default is checked.
Note: this feature is designed to work with ppcUpdater 1.0.3 or later.
If you use an older version, ppcUpdater will delay 15 seconds while displaying "Waiting for pocket WinRVM to close", followed by "File not found: \Program Files\Pocket WinRVM\WinRVM_docs\PocketWinRVM", and no "Abort" button will be displayed, but WinRVM will start.

To upgrade to the latest ppcUpdater, remotely update Pocket WinRVM as described below in steps a or b or click "Host | Check for documentation update".

The first time WinRVM runs it will create a startup shortcut so that WinRVM runs automatically after rebooting.

Info msg    ( only)

This is a custom text message that will be displayed on WinRVM's main display under the Envipco logo, perhaps usuful as a reminder of the default Table directory setting.
The default is blank.

Max size of an RVM table    ( only)

When sending a table to the RVM, WinRVM will check that the table isn't too large to fit into the RVM's memory. For CF1500 RVMs this value should be set to 65500. For Fuji CF1700 RVMs, this value can be set to a larger value to support large barcode tables.
The default is 65500.

SD card drive letter ( only)

Defines the drive letter of the SD card (defaults to "D"), for use with the "File | Copy RVM downloads from SD card" menu item.

Removed from WinRVM 3.5.9 and later as this is now automatically detected.

USB Stick drive letter ( only)

Defines the drive letter of the USB stick (defaults to "E"), for use with the "File | Copy U48 RVM downloads from USB stick" menu item.

Removed from WinRVM 3.5.9 and later as this is now automatically detected.

Reset ALL settings to default values   [moved to Help | About and renamed to "Reset program settings" in pocket WinRVM ver 1.3.9] ( only)

Send "I'm alive" FTP notification every X minutes (0=disable)  ( only)

This sends a Reimagine status file containing the current date/time to a folder on an FTP server. See the General Options under "Send "I'm alive" FTP notification every X minutes", the "To server" field is used to select which server to send the status file to.

The name of the status file have been changed to "RS_siteid_nnn.txt", where:
RS = static text which stands for Reimagine Status
siteid = 6 digit code indicating the Reimagine location:
nnn
= 3-digit code indicating machine status (5xx = machine down, otherwise machine up).
The file itself will contain a single line indicating the current date/time such as: “9/28/2012 9:31:34 AM”.

Example filenames:
RS_500001 _123.txt  (Arlington machine is up)
RS_500021 _259.txt  (Garland machine is up)
RS_500031 _391.txt  (Plano machine is up)
RS_500021 _502.txt  (Garland machine is down)
RS_500041 _572.txt  (Irving machine is down)
RS_500051 _600.txt  (Little Elm machine is up)

A program running on our server (written by John Petit) will automatically email the Reimagine tech if this FTP file isn't received every 25 minutes or so.
Note: in WinRVM versions prior to 3.3.6, this setting was in the Reimagine Options.
Note: when sending the status file, WinRVM no longer looks to pick up a file for the site (siteid.zip). Use the "Contact host every x minutes to receive file" feature in the Host Options instead.
See WinRVM 3.4.1 for more info.

To server: ( only)

Specifies server to send "I'm alive" FTP notifications.
Added in WinRVM 3.4.1.

Ping internet connection every X minutes  ( only)

This was added for wireless modems to keep the internet connection alive. Set to 15 for wireless modems. If the ping (connection to the internet) fails, "ping failed" will be logged. Defaults to 0 (disabled).
Added in WinRVM 3.3.6.


RVM Communication Options

screenshot:

screenshot:

Tip: click the left side of WinRVM's status bar at the bottom of the screen to display this dialog box.

WinRVM operating Mode:

Note: the restricted version of WinRVM only supports Manual Mode.

Unattended Mode (like Site Controller)

In this mode, the program operates somewhat like Envipco's old DOS Site Controller program. The program will run without user intervention and perform the following tasks (see the Unattended Mode documentation):

Manual Mode (menu-driven like PCRVM)

In this mode, the program operates very similar to the menu-driven DOS program PCRVM. The user must manually select various actions to perform such as sending a barcode table to an RVM. Various menu items are available in Manual mode that aren't available in Unattended mode:
Send to RVM

Retrieve from RVM
Advanced

Console Mode (advanced: send specific commands to RVM)

This mode is for advanced users, allows specific RVM commands to be sent to an RVM, and the RVM's responses are displayed.

EPPSi Mode (manual accounting)     [added in ver 1.2.5]    ( only)

This mode is used only at one location in the Bronx.

Interactive Mode (plays videos)     [added in ver 1.6.2]    ( only)

This mode is similar to Unattended Mode except the screen will show videos instead of the main WinRVM window.


RVM Comm Port

Select the communications port that WinRVM will use to communicate with the RVM(s). 

The pocket PC typically uses COM1, but the Palm Treo 700w/700wx uses COM2.

You can also manually enter a COM port name such as "COM5". WinRVM ver 1.9.2 or later required to use COM10 and higher.
The COM port selected must be different than the remote display and modem COM ports.
Note: under Windows XP (after installing the manufacture's device drivers), a USB/ISA/PCI RS485 adapter will be shown simply as another COM port such as "COM4: local port". 
 Click the "Run Windows Device Manager" button (added in WinRVM ver 1.1.1, or click "start | control panel | system | hardware | device manager | ports")  to determine which COM port is the RS485 adapter. From the Device Manager, double-click "ports" to list all the COM ports. 
Typically, RS485 adapters will be COM4 or COM5. See the Installation section for detail.
[Added in WinRVM ver 1.3.1] Clicking the "two cabled PCs" icon also displays the Windows device manager.

Connection Type:

RS-485

Select this option if using a Quatech RS-485 card or an RS-232 to RS-485 converter box. In this mode, WinRVM can communicate with multiple RVMs.

current RVM address/port

Enter the address of the RVM you wish to communicate with in Manual Mode. The address of the first RVM is 0.

RS-232

Use one of the PC's built-in COM ports. In this mode, WinRVM can only communicate with a single RVM.

Hardware handshaking: [Added in WinRVM ver 1.9.5]

This setting determines if the hardware handshake lines DTR and RTS are enabled, which provides power to the RS232 to RS485 adapter (Envipco P/N 303679 which is based on the B&B Electronics model 422PP9TB):

Choices:
    On
    Off
    driver default

The default setting is "driver default" which is how WinRVM was configured before ver 1.9.3. Some USB to RS232 adapters require the setting changed to "on" in order to send error messages.

RVM Baud Rate

Note: the RVM(s) must be set to the same communications mode (RS-232 or RS-485) as WinRVM. Typically, stand-alone RVMs are set for RS-232 mode, RVMs that were used with a Site Controller are configured for RS-485. If the RVM's communications mode is set incorrectly, change it as follows:

To set the RVM to RS-232 mode:
Turn the RVM off. Hold the '#' key on the keypad. Turn the RVM on. When the LCD prompts for the comm type, release the '#' key. Press '2' to select RS-232. Set jumper W5 in the RVM controller to RS-232 mode.

To set the RVM to RS-485 mode:
Turn the RVM off. Hold the '#' key on the keypad. Turn the RVM on. When the LCD prompts for the comm type, release the '#' key. Press '4' to select RS-485. Enter the 2-digit port address, then '#' to confirm. Set jumper W5 in the RVM controller to RS-485 mode.

Misc:

Comm Delay

This is the amount of time (in ms) to delay prior to sending each communication packet. If this number is too low communications errors may occur. The default value is 50.

RS485 refresh timeout   ( only)

This speeds up communications with an RS-485 connected RVM by not sending the RVM address character as frequently. If this amount of time (in ms) passes after sending a communications packet to the RVM, subsequent communications with this RVM will require the RVM's address character to be sent first, which slows the communications slightly. The default value is 2000.

Out timeout    ( only)

After WinRVM sends a message to the RVM it expects a response within this number of ms or an error will be logged. The default value is 5000.

Reboot Delay    ( only)

This is the amount of time (in ms) to delay after sending a reboot command to their RVM prior to sending an address character. This should be set at 1000 for CF1500 RVMs, but higher for Fuji RVMs. The default value is 1000.

Address char Delay   ( only)    [added in ver 1.8.4] 

Defines the delay prior to sending an address character to select the appropriate RVM to communicate with in RS-485 mode.  Previous versions of WinRVM hard-coded this value to 5, the new default value is 20. If this value is too low, "REQ" (RVM communication retry) messages may be shown.

Max times to reboot RVM  ( only)    [added in ver 1.9.0] 

Previously, WinRVM would attempt to reboot the RVM a maximum of 10 times if the RVM wasn't communicating.
If set to 0, WinRVM will not attempt to reboot the RVM if it's not communicating.


Host Options

Note: not supported in the restricted version of WinRVM.

screenshot:

screenshot:



All fields must be filled in to enable WinRVM's Host menu.

To use a Dial-up networking internet connection: check DUN's "save password" and "connect automatically" and set
"disconnect a call if idle more than" 1 min so that it will hang up.

FTP options:

Connect via    [added in ver 1.1.2]

Selects the internet connection method. The default value is "LAN". Click the drop-down arrow to choose a dial-up connection. If no dial-up connections are listed, you must configure them manually, see the installation instructions.
If you add a new dial-up entry while WinRVM is running, you must restart WinRVM for it to see new dial-up entries.

Dial non-LAN connections  [Added in pocket WinRVM ver 1.1.3] ( only)

This gives additional flexibility for pocket PCs such as the Siemens SX66 that uses wireless internet "dial-up" settings such as "Cingular GPRS" and "CDS cellular". Previous versions of WinRVM always dialed non-LAN connections but you can now disable dialing for wireless internet connections, which may work better. Default value is checked.

Dial alternates  [Added in pocket WinRVM ver 1.2.9] ( only)

When checked and dialing the ISP fails, if another dial-up connection is defined (in "start | settings | connections | connections") it will be dialed the next time a call is made.
WinRVM will log "Switching dial-up connection to [name]".
WinRVM will cycle thru every dial-up connection defined, then start over from the first connection (note: redials are not immediate).
The default value is checked.

Note: when adding a new dial-up connection, you must give it a different name such as "GC2", "GC3", etc.
After adding or changing a dial-up connection you must re-run WinRVM before it will detect the changes.

Host server

Selects the name of the host server from the drop-down list (click arrow). RVM accounting data is sent to the host server.
[Added in WinRVM ver 1.3.1] Default value is "Envipco", previous versions defaulted to "disabled".

Error server

Selects the name of the error server from the drop-down list (click arrow). RVM errors are reported to the error server.
[Added in WinRVM ver 1.3.1] Default value is "Envipco", previous versions defaulted to "disabled".

Send SMS on RVM error to [Added in pocket WinRVM ver 1.4.2] ( only)

Sends an SMS text message to the specified cell phone number if this field isn't blank and the corresponding error in ERRLIST is configured to make a Call.
Note: in the UK they'll need to change the bin full errors in ERRLIST from "L" to "C".
Added support for the following new values for column 8 of ERRLIST:
"T" = Send text message to cell phone and log for this error
"B" = Send text message to cell phone, call host and log for this error

Dial-up Access numbers   [Added in pocket WinRVM ver 1.1.0] ( only)

Select the appropriate file from the list (all files in "\My Documents\GC Access Codes" will be listed) and tap "Go" to display the file. WinRVM will display a reminder "Close Pocket Word to return to WinRVM". This feature is simply a handy reference for use when setting up the dial-up access on-site.

cheatsheet.txt   [Added in pocket WinRVM ver 1.2.9] ( only)

Displays the contents of the file \My Documents\cheatsheet.txt in pocket Word. You can use this to copy/paste the ISP dialup info (except the password).

Edit FTP server configurations  [added in ver 1.0.8]     (this feature is available from the Host menu.)

    Click this button to display the following window: 

screenshot:

screenshot:

Server name

This is the name of the current server whose configuration is being modified.

Address

Specifies the address of the FTP server such as ftp.envipcotech.com or ftp.contrec.com.  

Port     ( only)

Specifies the FTP port. The default is 21.

User name

Specifies the user name to log into this FTP server.

Password

Specifies the password to log into this FTP server. "*" characters will be displayed in place of the actual password.

Send dir

Specifies the directory on this FTP server to place files such as /winrvm/fromsite.

Receive dir

Specifies the directory on this FTP server to receive files from such as /winrvm/tosite.

Reset to defaults   [added in ver 1.1.1]

Reset the server configurations to the factory default settings.

Save 

Click this button to save changes to the current host configuration. If you've changed the server name, WinRVM will prompt "Add new host 'host name'?".
Tapping the "ok" button is the same as tapping "Save".

Cancel

Exit without saving any changes.
Clicking the red X in this windows is the same as clicking Cancel.

Clear

Clears all fields. Useful for adding a new server configuration.

Delete

Deletes the current server configuration.


Report status of all RVMs when contacting host

If checked, this logs the status of all RVMs prior to making a sick or scheduled call (but not for 'contact host every x minutes). Example:

<703020> 11/22/16 12:26:20 -- RVM status for RVM 703020, RVM type=PS:
<703020> 11/22/16 12:26:20 -- Site id: 590537
<703020> 11/22/16 12:26:20 -- Site name: Envipco Naugatuck
<703020> 11/22/16 12:26:20 -- Service: OUT ---> E005: No response from Printer
<703020> 11/22/16 12:26:20 -- Online: YES
<703020> 11/22/16 12:26:21 -- Service mode: OUT
<703020> 11/22/16 12:26:21 -- Sleeping: NO
<703020> 11/22/16 12:26:21 -- State: out of service
<703020> 11/22/16 12:26:21 -- Meter: 6
<703020> 11/22/16 12:26:21 -- Software ver: RVM 1500 Aug30'16 13:59 (P,S,703020,EAN), MON 1500 Mar02'07 15:39
<703020> 11/22/16 12:26:21 -- Supported features: printer, printer image storing, binary barcodes (only), EAN barcodes, coupons, charity, error list/log
<703020> 11/22/16 12:26:21 -- Bin configuration:
<703020> 11/22/16 12:26:21 -- retrieve from RVM: bin configuration
<703020> 11/22/16 12:26:22 -- Bin 01 (Mixed PET), using bin full sensor
<999998> 11/22/16 12:26:22 -- PC uptime: 0 days, 0 hours, 14 minutes

Create Greek status report file     [added in WinRVM ver 1.8.0, pocket WinRVM ver 1.4.8]

If enabled, WinRVM will write various RVM status info to the file RVMStatus.txt. RVMStatus.txt is included in the regular zip file whenever WinRVM sends data to the host . RVMStatus.txt is deleted once sent. See WinRVM ver 1.8.0 and ver 1.9.6 for more info.

delimiter        [added in WinRVM ver 1.8.0, pocket WinRVM ver 1.4.8]

Related to Create Greek status report file. Defines the character(s) that separates the fields in RVMStatus.txt. The default value is "#". Cannot be blank.

Report when RVM returns to service     [added in ver 1.4.9, pocket WinRVM ver 1.2.0]

If checked, WinRVM will log "RVM returned to service" when the RVM goes into service after previously being out of service. The default value is unchecked. If in Unattended Mode, WinRVM will contact the host if the error it recovered from is configured to generate an error call ("C" entries in the ERRLIST file).
Note: if this feature is enabled, the "RVM status update interval" in the Unattended Mode Options should be changed from the default value of 5 minutes to 1 minute. This will allow WinRVM to detect within one minute when an RVM goes back into service.

Delay after done

Specifies the amount of time (in ms) to delay after WinRVM is done communicating with the FTP server to keep the results window on the display. The default is 2000.
This setting was removed in WinRVM 3.6.7 and later. However, the functionality is still present but you must edit registry setting FTPFinishDelay while WinRVM is shut down.

Max retries to contact host

Maximum number of attempts to contact the host if the initial attempt fails. Default value is 50 (versions prior to 1.1.2 defaulted to 5 and should be changed to 50).

Minutes between retries

Delay this many minutes between attempts to contact the host after the initial attempt fails. Default value is 3.

Xfer timeout     [added in ver 1.9.3]

This should prevent WinRVM from locking up displaying the FTP transfer window when sending data to the host under certain conditions. This is the maximum number of minutes allowed to upload or download a single file to the host while not in Manual Mode. The default value is 90; set to 0 to disable this feature.
WinRVM will log "FTP transfer stalled after x minutes, rebooting!" if this occurs, then reboot.

Errlist col 8 override character for all errors    [added in ver 3.3.1]

If set to a non-blank value, this value will be used instead of the column 8 value defined in errlist for all errors. Examples:
"C" = call host for EVERY error
"T" = send text message/email for EVERY error
"B" = send an email and contact the host for EVERY error
"L" = only log the error, don't contact host or send email for EVERY error
empty (not a space!) = column 8 in errlist defines what to do for each error (how previous versions of WinRVM behaved)

This was created for NexCycle, as they want all errors to be called in. With this setting we don't need to maintain a custom errlist file just for NexCycle.

Passive Connection [added in ver 3.3.5]

Enable this setting on PCs equipped with 4G aircards such as used by NexCycle to prevent FTP transfers from locking up WinRVM at 0 bytes transferred. The default is disabled which is how previous versions of WinRVM behaved.

Contact host every x minutes to receive file    [added in ver 1.0.2, pocket WinRVM ver 1.0.6]

WinRVM will contact the host and see if the host has a file for that site. No data is sent to the host. Enabled in Unattended Mode only.

Support ePortal, optionally send status to host every [ N ] min, default is 0=only for scheduled and error calls   [added in ver 4.0.6, pocket WinRVM ver 2.0.1]

If enabled, RVM status and errors are sent to the FTP/SFTP server, which are then relayed to ePortal via the ePortalBridge program.
ePortal support is enabled by default, but the " [ N ] min" setting defaults to 0.
For sites that are connected to an always-on internet connection, you can report the RVM status to ePortal more frequently, such as every 120 minutes. When set to the default value of 0, the ePortal status files are only sent to host during the daily data collection or when reporting an RVM error.
If ePortal is enabled the setting "Report status of all RVMs when contacting host" is forced on.
See WinRVM 4.0.6 for details.

Days of month    [added in ver 1.4.7, pocket WinRVM ver 1.1.9]

Specify days of the month to also make a scheduled call. Format: day,day,day,etc, such as: 1,8,15,22,29. Leave blank to disable this feature (default is blank).

Service call minutes   (previously named Service call minutes in versions prior to 1.2.5)    [added in ver 1.0.2]

Reports a service call to the host this many minutes after service mode is exited from an RVM's keypad (default is 10, 0=disable) if in unattended mode.
Note: RVM's SC_ATTACHED parameter must be set to 1 for this feature to work.

Max monthly FTP thruput in KB    [added in WinRVM ver 1.9.1, pocket WinRVM ver 1.5.4]

The default=0=unlimited. If this value is set to non-zero, once WinRVM has sent/received this much data to/from the FTP server, WinRVM will no longer send data to the FTP server. This feature is meant for Unattended Mode installations that use a cell modem to connect to the internet. If the monthly cellular data plan only allows 5MB of thruput, set "Max monthly FTP thruput in KB" to 5000 to avoid a huge phone bill in case WinRVM calls in many times during the month for some reason.

If "Max monthly FTP thruput in KB" is non-zero, when making a call now log the current thruput such as "Total FTP Thruput = 2,000 KB out of 5,000 KB = 40%".
If it's time for a scheduled call or sick call but the monthly FTP thruput has been exceeded, WinRVM will log either:
    Exceeded maximum FTP thruput of n KB, aborting scheduled data collection!
    Exceeded maximum FTP thruput of n KB, aborting sick call!
This setting was removed in WinRVM 3.6.7 and later. However, the functionality is still present but you must edit registry setting MaxFTPThruput while WinRVM is shut down.

Day of month to reset FTP thruput counter    [added in WinRVM ver 1.9.1, pocket WinRVM ver 1.5.4]

Default=1. Set this to the day your cellular data plan billing starts.
WinRVM will log "Resetting monthly FTP thruput counter" when the counter is reset on the specified date.
Added a "clear" button, which displays the current thruput counter and optionally allows you to clear it.
You can also clear the counter via the command file command "SetReg TotalFTPThruput=0".
The "Max monthly FTP thruput in KB" is ignored when manually performing a function from the "Host" menu such as:
"Gather data from all RVMs, send to host"
"Send previously collected data"
"Store visit test"
"Receive file from host"
"Check for WinRVM program/documentation update"
or remotely by forcing a call to host via RVMStatus.
This setting was removed in WinRVM 3.6.7 and later. However, the functionality is still present but you must edit registry setting DayToResetFTPThruput while WinRVM is shut down.

Compression options:

zip program

Specifies the file name of the compression program to use when compressing data prior to sending to the host. The default value is 7zip.exe (WinRVM versions prior to 3.5.6 used Info-ZIP by default). You must use 7-zip is using a 64-bit versions of Windows.

unzip program

Specifies the file name of the decompression program to use when decompressing data received from the host. The default value is unzip32.exe.
Note: for Windows XP or Windows 2000 you can't use pkunzip.exe as pkunzip doesn't support long file names under these operating systems. 
Click the "Use Info-zip" button instead. [added in ver 1.2.5]

zip cmd line

Specifies the command line options for the compression program. Default is "-j" for Info-ZIP.

unzip cmd line

Specifies the command line options for the decompression program. Default is " -o -C" (overwrite existing files, ignore filename case).

both in folder

Specifies the folder where the compression and decompression programs reside. Click the folder icon to browse for a folder. The default value is the WinRVM program file folder.
Note: if using WinZip (not recommended-use InfoZip instead), you must reference the directory where the Winzip command line programs are installed, typically "c:\program files\winzip". 

Chat Server options[added in ver 1.8.8, pocket WinRVM ver 1.5.3]

The RVMStatus program can remotely connect to a WinRVM site that is connected to the internet via an always-on connection such as LAN, DSL, wireless, etc., instead of a dial-up modem. The following only applies for this case, when "connect via" in the Host Options is set to "LAN":

Details:
This requires the "WinRVMChat server" program to run at a static IP address such as 12.189.195.69  on Naugatuck's FTP server.
Recommended: use chat.envipco.com for the address.
WinRVM sites that have an always-on internet connection will periodically connect to this chat server (such as when going into Unattended or Interactive Mode) , sending their site ID and IP address.
The chat server keeps track of all the WinRVM sites and corresponding IP addresses.
The WinRVMChat server relays information between a WinRVM site and the RVMStatus program via "chat" messages.

IP address

Enter the IP address of the chat server, leave blank to disable the chat feature.
Double-click "default is..." to change the IP address to 12.189.195.69, which is the Envipco chat server located in CT.
Note: for testing purposes inside Envipco Naugatuck you must use the internal IP address 192.168.22.2 instead (or chat.envipco.com).

port

Enter the port to communicate over (default is 7050).
If the chat server address or port is changed in the Options, WinRVM automatically reconnects to the chat server.

Min between retries

If WinRVM gets disconnected from the chat server, WinRVM will try to reconnect after this many minutes (default is 30).
Note: the pocket PC versions reconnect after this many minutes no matter what.
If 0, the chat feature will be disabled.

Send data to host: (Unattended mode only)

Click the days of the week that WinRVM should automatically collect accounting data from all RVMs and then send this data to the host. This is known as a "scheduled data collection".

at time of day    [WinRVM versions 1.4.1 and later support up to 4 times]

Specifies the time(s) of day (in 24hr hh:mm format) to perform the scheduled data collection. Set to blank to disable this feature. Default time is 23:30.

also every x minutes

scheduled data collection will also be performed every x minutes if this field is non-zero. Default value is 0 (disabled).
This setting is independent of the "at time of day" setting. Enabled in Unattended Mode only.

WinRVM calls in when the number of minutes past midnight is evenly divisible by x. For example:
if x = 30, WinRVM calls in at exactly 00:30, 01:00, 01:30, 02:00 etc.
if x = 60, WinRVM calls in at exactly 01:00, 02:00, 03:00, 04:00 etc.
if x = 120, WinRVM calls in at exactly 02:00, 04:00, 06:00, 08:00 etc.
The maximum value of x is 1440 minutes (1 day).

Versions prior to 1.8.3 behaved this way:
Note: when WinRVM starts this sets an internal timer that will begin the data collection after x minutes and every x minutes after that.

from start time (hh:mm)  [Added in WinRVM ver 1.8.3, pocket WinRVM ver 1.5.0]

Defines the times of the day to start calling every x minutes. This setting only applies to the "call every x minutes" setting.
Example: if you only want WinRVM to call every x minutes from 8 am to 6pm, set start time = 08:00, end time = 18:00.
Default start time = 00:00 (midnight).

to end time (hh:mm)     [Added in WinRVM ver 1.8.3, pocket WinRVM ver 1.5.0]

Defines the times of the day to stop calling every x minutes. This setting only applies to the "call every x minutes" setting.
Default end time = 23:59.

Report RVM status only (no Q file)    [Added in WinRVM ver 1.8.3, pocket WinRVM ver 1.5.0]

This allows just the Greek status file (rvmstatus.txt) to be called in every x minutes, no other data is collected from the RVMs, which would take the RVMs out of service briefly. WinRVM logs "skipping RVM data collection".
Note: prior to WinRVM versions 3.1.3, this feature was only active when the "every x minutes" feature was enabled.

Sync clock via internet  [Added in WinRVM ver 1.8.8, pocket WinRVM ver 1.4.2]

Determines if the PC's clock is synchronized to an internet time server every time the pocket PC connects to the FTP server. Default is enabled.
To sync the clock in Manual Mode, tap "Host | Receive file from host only".

Reboot after FTP retries exhausted  [Added in WinRVM ver 3.1.3]

Defaults to enabled. This indicates the internet connection is no longer working, so perhaps rebooting may fix the issue.

Retry if no collection in X hours  [added in pocket WinRVM ver 1.5.6]

On startup and every hour WinRVM checks if it has been too many hours since a data collection occurred, and will initiate a data collection if needed.
On startup, in Unattended Mode, WinRVM logs "Last scheduled call attempt was X hour(s) ago".
Defaults value is 25, set to 0 to disable this feature.

report RVM errors to host

If checked, WinRVM will report any detected RVM errors to the host. WinRVM's event log will also be sent if enabled.

Report RVM status when contacting host  [added in pocket WinRVM ver 1.0.6]

This logs the status of all RVMs prior to contacting the host to report an RVM error or for a scheduled data collection. Default value is false.

Number of zip file backups to keep    [added in ver 1.2.9]

WinRVM will keep a certain number of zip file backups containing collected RVM data. The files are kept in the Q file folder. Default is 100.

Show pending received file 'todo' list for all RVMs

Displays a list of files that have yet to be sent to each RVM. This list will contain file names if an RVM is turned off or is not communicating after WinRVM receives files from the FTP server.

Clear pending received file 'todo' list for all RVMs

Clears the pending list of files that have yet to be sent to each RVM. 


Unattended Mode Options

Note: not supported in the restricted version of WinRVM.

screenshot:

screenshot:

Site info:

Site ID

Enter a 6-digit number that identifies this site. This number is printed on the RVM receipts. This number is also used when contacting the host computer. Note that the WinRVM will allow you to enter any 6 characters into this field, the characters are typically numbers but are not required to be numbers.

Site Name ( only)

Used when sending an email to report an error, the site name is now included in the subject and body of the email such as:

From: Reimagine 999998 [mailto:reimagine@envipco.com]
Sent: Tuesday, July 27, 2010 2:13 PM
To: Randy Dellinger
Subject: [Arlington] E555: Jam in front of PET1 compactor

[Arlington] E555: Jam in front of PET1 compactor


Note: if the site name field is blank then the site ID is used instead.

Number of RVMs at this site ( only, uses "Advanced | RVM configuration list" to define the number of RVMs)

Pocket PC versions 1.6.5 and later support up to 40, otherwise up to 25 RVMs are supported.

Site Name

Enter a name that identifies this site, typically the name of the grocery store. This name is usually printed on the RVM receipts.

POS: see the pocket WinRVM Barcode/POS options for descriptions.

(Reimagine only) "Street Address for receipts" section with 3 text fields. This info will be shown on receipts when the receipt uses the voucher template commands (% code) : %@Vn = street address (line n, where n=1 to 3 defined in Unattended Mode Options).

Sleep Mode

Time to put RVMs to sleep

This option only applies to Unattended Mode only.
Enter the time(s) that all RVMs are to be put to sleep (taken out of service). User 24 hr. military time such as 23:00 for 11 pm). To disable sleep mode, delete all characters from this field.
WinRVM ver 1.8.4/pocket WinRVM 1.5.1 added a second sleep/wake time.

Time to wake RVMs

This option only applies to Unattended Mode only.
Enter the time(s) that all RVMs are to be woken up from sleep (put back into service). User 24 hr. military time such as 06:00 for 6 am). To disable sleep mode, delete all characters from this field.
WinRVM ver 1.8.4/pocket WinRVM 1.5.1 added a second sleep/wake time.

Sleep all day on these days:  ( only) [Added in WinRVM 3.2.7]

Defines days of the week for the RVM to sleep the entire day.
For NexCycle in CA, this allows the following configuration: Sleep all day Sunday and Monday; operational Tuesday through Saturday from 10:00 a.m. to 4:00 p.m.
To do this, check "Sun" and "Mon" checkboxes, set the "sleep time" to 16:00 and the "wake time" to 10:00.

Put RVMs to sleep now    ( only)

Click this button to instantly put all RVMs to sleep. 

Wake up RVMs now   ( only)

Click this button to instantly wake all RVMs. 

Remote Display Port    ( only)

If a remote display is installed, select the appropriate COM port (check "Disable" if not installed). You can also manually enter a COM port name such as "COM5". The COM port selected must be different than the RVM and modem COM ports.

RVM errors not created in service mode are posted on the remote display as follows:
    RVM:123456 ERR:103
    Crusher stalled
Note: only the first 20 characters of the error message text (from ERRLIST) are displayed.
The remote display will begin beeping, press the button on the remote display to stop the beeping.
When the button is pressed a second time the remote display will be cleared (unless another RVM error
message is buffered). Up to 15 RVM error messages will be buffered.

The area to the left of "send test message" will indicate the remote display's status such as "button pushed", "button released", "not communicating". [added in ver 1.0.8]

Send Test Message   ( only)

Sends error message 699 "Test Message" to the remote display. The display should also beep. Press the remote displays button to stop the beeping, press the button again to clear the display.

This button is disabled if the "remote display port" is set to disabled. [added in ver 1.0.8]

Note: if you change the port you must click 'OK' and return to Unattended Mode Options before sending a test message

[Added in WinRVM ver 1.3.1] Clicking the modem icon displays the Windows "modem options/properties" window.  ( only)

screenshot:
Note: the pocket PC's "Modem Options" is available from the File menu.

Modem Com Port    [added in ver 1.0.7]

If WinRVM's modem detects a single modem ring, WinRVM contacts the host if in Unattended Mode. 
Note: due to a bug this feature should only be enabled in WinRVM version 1.3.9 or later and pocket WinRVM versions 1.1.1 or later.
You can also manually enter a COM port name such as "COM5".
For compact flash modems select COM4 for the iPAQ 2110, COM6 for iPAQ 2190/2490 (COM4 if using ROM ver 1.00.00 H), COM7 for the iPAQ 2215.

[added in ver 1.2.8]
If two rings are detected (if WinRVM is not busy and only in Unattended Mode), WinRVM will answer the call and accept remote commands from a PC running MUSTATUS software. While processing the remote call, user input is disabled except for the "Abort remote communications" button which is only displayed while a remote caller is connected.
Note: 
The Modem COM port setting must be enabled for WinRVM to answer phone calls. Set to "Disable" to disable this feature (default setting).
The COM port selected must be different than the RVM and remote display COM ports.
If using an external modem the modem cable must support the following hardware handshake lines: RTS, CTS, RI.
If your PC is configured to use a modem to connect to the internet, this option does NOT have to be set.
For more info see the "Receive remote calls and perform various actions" section of the Unattended Mode documentation.

Hangup string     [added in ver 1.2.8]

Defines the command sent to the modem to hang up (default is "ATH").

Escape string      [added in ver 1.2.8]

Defines the command sent to the modem to force the mode to return to command mode to allow a hang up (default is "+++").

'No carrier' string      [added in ver 1.2.8]

Defines the message sent by the modem when if fails to connect to the calling modem  (default is "NO CARRIER").

Setup string    [added in ver 1.2.9]

The setup string is a string of commands sent to the modem to initialize various settings in the modem. Default is "AT&F" (factory configuration).

Contact host X sec after 1st ring     [added in ver 3.3.3]

The default is 12 seconds (was hardcoded to 8). This fixes problem of being unable to call into some sites if the ring detection was slower than normal. Set disable this feature, set to 0.

baud rate      [added in ver 1.2.8]

Defines the baud rate/speed used to communicate with the modem. Can be set to: 19200, 38400, 57600 (default).

RVM polling interval

This is the amount of time (in ms) between polling of RVMs in Unattended Mode. WinRVM starts polling RVM 0, which means it sends the address character 0 to all RVMs. If RVM 0 has a message to send it will send the message after being polled. WinRVM will delay by the value of this field then poll then next RVM (1). After the last RVM is polled, polling will restart at RVM 0. The default is 1000.

Write RVM status file every minute    ( only)   [added in ver 3.3.4]

The default is disabled, if enabled (for esDAS), every minute the file "c:\cf1500\RVM Status.txt" is written which contains the communications status of each RVM (one line per RVM) using this format:
port #, communications status (YES/NO), RVM serial # (6 digits)

Example file:
0,NO,111111
1,YES,033333
2,YES,606800


It's possible the serial number field may be blank if the RVM isn't communicating such as RVM 1 below:
0,YES,111111
1,NO,
2,YES,606800


Click "Show RVM status file" button to display the status file.

RVM status update interval     ( only)

In Unattended Mode WinRVM will ask for the status from each RVM and update WinRVM's status display. If an RVM doesn't respond, WinRVM will change the "communicating" field to "NO" for that RVM. The default is every 5 minutes. Set to 0 to disable periodic status updates.

Reboot PC every X days at Y (time)    [added in WinRVM ver 1.5.2, pocket WinRVM ver 1.2.2]

To disable this feature, set the number of days to 0 or blank the time. Use 24-hour time format such as 14:30. This feature is disabled by default.
If enabled, choose a time that a customer is unlikely to be using the RVMs such as 03:00, this is important for when the POS feature is enabled.
If WinRVM is in the middle of performing an action such as an RVM data collection when the reboot interval occurs, WinRVM will complete the action before rebooting.

Reboot PC interval    [added in WinRVM ver 1.2.2, pocket WinRVM ver 1.1.7]

The PC can be rebooted every X hours. Set to 0 to disable this feature (default value).
If WinRVM is in the middle of performing an action such as an RVM data collection when the reboot interval occurs, WinRVM will complete the action before rebooting.

Reboot PC if ISP dialup doesn't respond within X minutes   [added in WinRVM ver 1.3.5] ( only)

The default value is 10. Set to 0 to disable.

Number of times to reboot PC if no RVMs are responding [added in WinRVM ver 1.9.0]  ( only)

If WinRVM is unsuccessful in communicating with any RVM after rebooting all RVMs 10 times, the PC will be rebooted as a last resort.
After rebooting, if all RVMs are still not communicating after being rebooted 10 more times, the PC will be rebooted again if the max attempts haven't been exceeded.
If any RVM communicates, the reboot counter is reset to 0 and the PC will reboot if no RVMs are communicating again.
This feature is only active in Unattended Mode or Interactive Mode and requires "Max times to reboot RVM if no com" in the RVM Comm Options to be set to a non-zero value.
Set to 0 to disable this feature (default value).

Automatically return to Unattended/Interactive/Reimagine Mode after this many minutes in Manual Mode

This feature is useful in case a technician changes a WinRVM site that normally runs in Unattended/Interactive/Reimagine Mode to Manual Mode, then leaves the site.
If set to 0 this feature is disabled. This only applies when RVM data is filled into the "RVM configuration list". The timer is reset whenever data is sent to or received from the RVM in Manual Mode. The default value was 0 in WinRVM versions prior to 1.4.6, pocket WinRVM ver 1.1.7, the default value is now 60.
"This pocket pc is normally used in Unattended Mode" must be enabled for this feature to work.

Auto-enter this mode on startup [added in WinRVM ver 2.0.2] ( only)

If WinRVM starts up in Manual Mode and this option is enabled, WinRVM will immediately return to Unattended Mode or Interactive Mode, as configured.. This feature is active even if the number of minutes in the above setting is set to 0 (disabled).
Note: clicking "Enter Manual Mode" on the WinRVM splash screen will override this setting and force WinRVM to start in Manual Mode.

This pocket pc is normally used in Unattended Mode.

If checked:
- Event logging is enabled to WinRVMlog.txt and WinRVMlog Month nn.txt.
- Allows the "Return to Unattended Mode after this many minutes in manual mode" to work.
- 90 zip file backups of Q files are kept instead of 10 because it's assumed a scheduled data collection will be made every day.

Look for command file every x seconds    [added in ver 1.2.5]

This allows WinRVM to be used in an El Diablo configuration so that El Diablo can pass commands to WinRVM such as "collect data from all RVMs". Previously, WinRVM looked for a command file (winrvm_commands.txt) to show up in c:\cf1500\fromhost only after receiving a zip file from the host and after WinRVM is first started. Default value is 0 (disabled).

[added in ver 1.3.8] WinRVM looks for RVM files that are placed into c:\cf1500\fromhost by other programs and automatically sends them to the RVMs. 
This allows an El Diablo program to send barcodes to the RVM by simply copying the barcode files to the fromhost folder.  See WinRVM El Diablo Configuration for more info.

Removed from pocket PC versions starting from ver 1.4.2. This value can still be changed from the default of 0 via registry setting HKLM\software\Pocket WinRVM\settings\CommandFileSec.

even in Manual Mode    [added in ver 1.5.8]     ( only)

When checked, WinRVM will process command files (and other files) placed into c:\cf1500\fromhost even when WinRVM is in Manual Mode. This is used when WinRVM is configured for use with El Diablo/PC-DAS.

Watchdog program check interval    [added in ver 1.6.6]

The watchdog program (c:\cf1500\WinRVM Watchdog.exe) watches for WinRVM to write the file watchdog.txt to the RVM table directory every so often as defined by this setting. The default value is 10 minutes on versions prior to 1.7.5, 45 minutes on versions 1.7.5 and later; set to 0 to disable this feature.  If the watchdog program determines that WinRVM has stopped writing the flag file it will reboot the PC. See the WinRVM watchdog 1.0.0 release note for more info.


Manual Mode Options   /  Prompt Options

screenshot:

screenshot:

Note: the "User Interface" and "Don't send these tables to RVM" options are not supported in the restricted version of WinRVM.

Allow RVM counts to be changed

If unchecked, WinRVM will not enable the "Advanced | Clear" and the "Advanced | Restore RVM's memory from Q file" menus. The "Advanced | Edit RVM's internal counters" feature will allow the RVM's internal counters to be displayed but not changed.

Allow install RVM program menu

If unchecked, WinRVM will not allow the user to select the "install RVM program" item under the "Advanced" menu.

Range check Serial No entries

If checked, WinRVM will display a warning if the serial number entered in the "set/change RVM info" feature doesn't match the following pre-defined serial number ranges:

030000 - 039999 can machines
040000 - 049999 glass machines
050000 - 059999 PET machines
600000 - 699999 2-way machines (can+PET)
700000 - 799999 3-way machines (can+glass+PET)

Prompt user for Table location on startup

If checked, on startup WinRVM will prompt the user for the default "tables" folder where the RVM files are located. 
This allows you to have separate folders containing different RVM configurations for Greece, Japan, etc.

Use printer-specific voucher filenames [added in WinRVM ver 1.8.7, pocket WinRVM ver 1.5.2]

- If disabled: when sending a voucher file to the RVM, the filenames used are the same as in previous versions of WinRVM such as cash.vou, counters.vou, ind_wt.vou, etc., no matter what type of printer is installed in the RVM.

- If enabled (the default value):
When sending a voucher file to the RVM, the RVM's printer type is determined by retrieving the RVM's parameters, then a filename containing the printer name is used.
For example, when sending the cash voucher to the RVM, the following filenames are used depending on the printer:
- Cybertech text printer: "cash.vou"
- Cybertech graphics printer: "cash cybertech graphics.vou"
- Hecon C56 printer: "cash hecon.vou"
- Hecon X56 printer: "cash hecon x56.vou"
- Swecoin printer: "cash swecoin.vou" (this is the printer in the interactive RVM).

Since the Cybertech text printer is the most prevalent printer, the old default file names such as cash.vou, counters.vou, ind_wt.vou, etc. are used for the text printer.

List of voucher filenames, by printer type:

Printer cash voucher charity voucher counters ticket weight ticket distributor report ticket error log ticket
Cybertech text cash.vou charity.vou counters.vou ind_wt.vou ind_dist.vou ErrorLog.vou
Cybertech graphics cash cybertech graphics.vou charity cybertech graphics.vou counters cybertech graphics.vou ind_wt cybertech graphics.vou ind_dist cybertech graphics.vou ErrorLog cybertech graphics.vou
Hecon cash hecon.vou charity hecon.vou counters hecon.vou ind_wt hecon.vou ind_dist hecon.vou ErrorLog hecon.vou
Hecon X56 (cutter) cash hecon x56.vou charity hecon x56.vou counters hecon x56.vou ind_wt hecon x56.vou ind_dist hecon x56.vou ErrorLog hecon x56.vou
Swecoin cash swecoin.vou charity swecoin.vou counters swecoin.vou ind_wt swecoin.vou ind_dist swecoin.vou ErrorLog swecoin.vou

The above voucher files are now included in the RVM data files. They should be copied to the \cf1500 folder.

Note: WinRVM determines the RVM's printer type by retrieving the RVM's parameter table and looking at the PRINTER_TYPE parameter.
For markets outside the USA that only have the Cybertech graphics printer you may want to disable "Use printer-specific voucher filenames" and use the old voucher file naming convention, as your default voucher files are designed for the Cybertech graphics printer.
For markets such as Greece that use both Cybertech graphics printers and Hecon printers, you may want to leave this feature enabled, but keep in mind you'll need to copy your existing voucher files to "filename cybertech graphics.vou", for example:
- copy existing cash.vou to "cash cybertech graphics.vou"
- copy existing charity.vou to "charity cybertech graphics.vou"
- copy existing ErrorLog.vou to "ErrorLog cybertech graphics.vou"
etc.

If you remotely send a printer-specific voucher such as "cash hecon.vou" to a site in Unattended Mode, WinRVM will only send the voucher to RVMs with that specific printer (Hecon in this example).
Note: in Unattended Mode, the individual voucher file naming convention of ssssssfilename.vou still applies, so if you want to create an unique cash voucher file for RVM 123456 you would create 123456cash.vou no matter what type of printer, not "123456cash hecon.vou" or "123456cash swecoin.vou".

WinRVM font size   [added in WinRVM 3.4.4]

This controls the main log area and the "prompt for file names" checkbox.

WinRVM 3.7.2 added additional support:
"Retrieve from RVM | Parameters"
"Advanced | Edit RVM's internal counters"
"Advanced | Compare parameters to defaults"
The status bar.
I recommend setting the "WinRVM font size" to 11 for small displays. The default value is 8.

Use large toolbar with size  [added in WinRVM 3.7.2]

Enable to show a toolbar with large 64x64 icons instead of the original 24x24 icons. If the icons don't fit within the button, increase the size from 830. The default value is disabled.
Meant for use with tablet PCs with small displays.

Prompt for file name when sending these tables to RVM:

If any of the listed tables are checked, when WinRVM is about to send a table to an RVM, it will prompt the user for the file name instead of automatically sending the default file.

tip: hold the shift key prior to clicking the "Send to RVM" menu will also cause WinRVM to prompt the user for the file name.

The "Check all" button will check all the tables, the "clear all" button unchecks all tables.

Show barcode reminder [added in ver 1.3.6]

If checked, when prompting the user for the cash voucher file name, now pop up the reminder window: "Is a receipt barcode required at this store?"

Edit custom parameter prompts [added in ver 1.3.6]

When sending a parameter table to an RVM, WinRVM prompts the user to select various parameter values as defined in prompt.ini.  Click to edit prompt.ini. For more detail see Send to RVM | Parameters.

Enable custom parameter prompts [added in ver 1.4.4, pocket WinRVM 1.1.7]

When disabled, skips all parameter prompts defined in prompt.ini when sending a parameter table to an RVM (see ver 1.3.6 for more info on prompt.ini).

WinRVM ver 1.8.7 and pocket WinRVM 1.5.2 and later now default to the RVM's current value for the MAXPAY and PRINTER_TYPE parameters instead of always defaulting to the first item in the list specified by the file prompt.ini.
For example, when sending a parameter table to the RVM, previously WinRVM would prompt for the MAXPAY value and always default to $2.55 since this was the first value listed in prompt.ini, as in this sample prompt.ini file:
Select maxpay amount,MAXPAY,$2.55,$5.00,$5.15,$6.00,$7.50,$9.95,$10.00,$12.00,$99.00


Now, if the RVM's MAXPAY parameter is set to $6.00 and you send a parameter table to the RVM, WinRVM will default to $6.00 instead of $2.55. The tech can simply click "OK" to accept the current value instead of manually selecting $6.00 from the list.


To save any changes made, click the "OK" button at the bottom of the options window. WinRVM will check various settings and display a warning if it finds a problem.
To discard any changes made,  click the "Cancel" button at the bottom of the options window.
 


EPPSi Mode Options

Note: not supported in the restricted version of WinRVM.

This screen is used to determine which single RVM type (can, glass, or plastic) is attached to the PC when the program is run in EPPSi Mode.
This mode is used only at one location in the Bronx.

Show Pickup Log

Displays the file PickupLog.txt.


Interactive Mode Options  [added in WinRVM version 1.6.2]

Edit settings / video playlist

Click this button to edit the file c:\cf1500\Video\VideoPlaylist.ini, which contains many video-related settings such as the idle video and which barcodes force certain videos to play.
If you change VideoPlaylist.ini, make sure you click the OK button at the bottom of the Options window so that WinRVM will load your changes. If you don't do this, the changes will not take effect until the next time WinRVM is started.

Show 'Live help' button to contact Skype user

When the checkbox is enabled (the default is disabled), this reduces the size of the video portion of the interactive screen and adds a "Touch here for live help" button such as:

If the customer presses the "Touch here for live help" on-screen button, videos will stop playing and the Skype window will pop up and initiate a call to the "Skype user" (default is "EnvipcoCallCenter"):

If the call center answers, their face will be displayed in the Skype window and the customer and call center person can have a conversation:



When the call center user terminates the call, WinRVM will resume playing videos.
The customer may also terminate the call by touching the on-screen "Quit" button on the bottom left; WinRVM will resume playing videos.
See WinRVM ver 1.9.0 for more info.

Max seconds to wait for call center to respond

For a webcam call initiated by a customer, if the call center Skype user does not respond within this many seconds (default is 20), WinRVM will close the Skype window and resume playing videos.

Seconds to delay before entering interactive mode when holding shift key   [added in WinRVM ver 2.0.3, removed in WinRVM 3.0.7]

 Note: if WinRVM ver 3.0.7 and later, holding the shift key and clicking the movie reel or Reimagine mode icon restarts WinRVM.

If you hold the shift key on the main window and click the movie reel icon to enter interactive mode, WinRVM will log:
Entering interactive mode in 5 seconds...
and delay the appropriate number of seconds before entering interactive mode. The mouse cursor will change to busy during this time.
This feature is useful when logging into the site remotely via remote-control software such as LogMeIn. LogMeIn can be configured to blank the screen; if you start interactive mode and then end the LogMeIn session, the monitor auto-adjusts itself but may not adjust correctly if a video is being shown. The screen may be shifted upwards and to the left for example, then the touch screen is no longer calibrated either. To avoid this problem, immediately prior to terminating the LogMeIn session, hold the shift key and press the movie reel icon". The monitor will auto-adjust while the normal WinRVM text window is displayed, then it will enter interactive mode.
Another workaround for this problem is to reboot the PC before terminating the LogMeIn session, but this option gives the customer to potentially tamper with Windows as it reboots.
I think this problem only occurs when using an LCD monitor connected via a VGA cable (does not happen with DVI connected monitors as there is no auto-adjustment required).
The default value is 5.

Play specific video/show still image

Prompts you for a file to play. After the video/photo is done playing (or "PhotoDuration" is completed), the main WinRVM screen will be displayed.
Press Esc to abort.

Maintain video aspect ratio

If unchecked, the video will be stretched as necessary to fill the screen. If unchecked, the original video height to width proportions (aspect ratio) is maintained, which is useful for wide-screen videos like movie trailers. The default value is enabled.
If unchecked and the video screen percentage is less than 100, the video will fill the entire visible area above the simulated RVM display (the video screen percentage setting will be ignored).
Note: this does not work for MPG files, MPGs always play with the original aspect ratio.
Videos should have a 4:3 aspect ratio so they fill the screen entirely. 16:9 videos will have black bars at the top and bottom of the screen.

Maintain image aspect ratio

If unchecked, the image will be stretched as necessary to fill the screen. If unchecked, the original image height to width proportions (aspect ratio) is maintained. The default value is enabled.

Video screen percentage

Set to 100 for full screen video, use ~85 to show the simulated RVM LCD.
Note: the RVM's MESSAGE_PORT parameter must be set to 1 to show the simulated RVM LCD.

default image background color

Click to change the background color of the screen when images are displayed. The default value is white (16777215).
The number of the color chosen is also shown in case you want to use this number in the [Adjustments] section to alter a specific image's background color.
To choose a color, click the "change" button which displays:

For more colors, click "Define Custom Colors" which displays:

If you already know the RGB values of the desired color (such as when using Paint Shop Pro's dropper tool), you can also type in the values.
When done, click "Add to Custom Colors" which places your new color in the "Custom colors" section. Click this new color in the "Custom colors" section then click "OK". The new color value will be displayed, which you can use to copy/paste into VideoPlaylist.ini for other color fields.

When playing a video the background color is always black.

interactive RVM port number

Set this to match the RVM with the interactive RVM software. This is used to send the print command to the appropriate RVM when the user presses one of the on-screen payment buttons.  The default is 00.
This setting is very important - if set to the wrong port, when the user presses an on-screen payment button nothing will happen!

Printer Port

When a loyalty card is scanned a "welcome page" is now printed to a Cybertech 9850/TP96 printer if the port isn't blank (default). To enable, set to a value such as "COM2" for serial port 2 or "LPT1" for the parallel port (you may need to install the Cybertech Window's printer driver first and configure the printer driver's paper size to "note" in "general | printing preferences | advanced" otherwise a full 8.5x11 page will be printed even for a small coupon).
When a loyalty card is scanned a "welcome page" is now printed to a Cybertech 9850/TP96 printer if the port isn't blank (default). The welcome page consists of "IM daily specials 1.cpn", "IM daily specials 2.cpn", "IM daily specials 3.cpn". Each part of the welcome page is optional, so if you don't want 3 parts, simply delete "IM daily specials 3.cpn".

Loyalty Card scanner COM port

If enabled, if the loyalty card scanner connected to the PC reads the following code 128 barcodes, a special action is taken:
WINRVM:EXIT IM (exit Interactive Mode)
WINRVM:ENTER IM (enter Interactive Mode)
WINRVM:REBOOT (reboot the PC if in Interactive Mode)
any other barcode scanned will play the "StartVideo" if in Interactive Mode

Enter Interactive Mode Now

Clicking this is the same as clicking "OK" then switching to Interactive Mode.

Online database connection for updating loyalty card/point info

server

Select the appropriate server to send RVM loyalty card information to a database located on the internet.
Note: this feature works in Unattended Mode and Interactive Mode.
The default value is "disabled".

Retry failed database access every X minutes, also defines how often to update database when using dialup

If WinRVM is unable to connect to the database for some reason, it will return every so often as defined by this setting.
This setting is also used for dialup internet access to determine how often to dial into the internet to update the web loyalty card database.
When using a "LAN" connection, WinRVM will immediately update the web database after it receives notification from an RVM that a card reader user has finished using the RVM.
The default value is 30.

site location

A description of this location which will be inserted into the database for each loyalty card record. May contain any text desired such as the store name, number and geographic location.

For unrecognized cards

Defines what to do when a user swipes a loyalty card that is not found in the online database. There are 3 choices:
-  "don't allow" =  reject the user's card. This is the default value.
- "create regular user" = create an account in the online database based on the card swiped. A temporary password is created, which is written to the WinRVM and card reader logs and can be printed on the user's receipt via the voucher template command "%@8".
- "create test user" =  same as "create regular user" except the account created will be a "test" account. This feature should be used for testing purposes until we "go live" with a real loyalty card program.

Welcome message for card reader users    [added in WinRVM ver 1.8.1]

When a card reader user swipes his card, WinRVM will query the online database for the customer's name. The customer's name, along with the welcome message are sent to the RVM to be displayed on line 2 of the LCD. Note: the RVM converts the customer's name to uppercase.
If the customer's name is not found, no message is sent to the RVM.
The default value is "WELCOME, %f". Two special "% codes" are defined as follows:
%f = customer's first name
%n = customer's full name
Example:
If the customer's name is "John Smith" and the welcome message is "WELCOME, %f", the RVM will display "WELCOME, JOHN".
Set the field to blank to disable this feature.

Test Connection     [added in WinRVM ver 1.8.4]

Once all settings are filled in, click this button to verify a connection to the card reader name database is possible. If it doesn't work, verify all settings and see if the firewall on the database server must be changed to allow a connection from this computer/IP address.

Charity / Coupons        [coupon related items added in WinRVM ver 1.9.6]

Show charity selection screen     [added in WinRVM ver 1.8.7]

This adds an easy way to disable the charity selection window without deleting or renaming CharityInfo.ini.
Click "show now" to show the screen. No action is performed if a selection is made from the Options. This is handy for debugging and allows you to show the screen when logged in remotely via remote control software (note that LogMeIn may not always show graphics exactly right).  [added in WinRVM ver 2.0.0]

Show coupon selection screen     [added in WinRVM ver 1.9.6]

This adds an easy way to disable the coupon selection window without deleting or renaming CouponInfo.ini. The default value is disabled.
Click "show now" to show the screen. No action is performed if a selection is made from the Options. This is handy for debugging and allows you to show the screen when logged in remotely via remote control software (note that LogMeIn may not always show graphics exactly right).  [added in WinRVM ver 2.0.0]

Show coupon rotation info     [added in WinRVM ver 2.0.5]

Shows the "Last coupon list loaded to RVM" and the "Current coupon logo file" as defined by the CouponRotationAtTime settings in VideoPlaylist.ini.

Edit charity names     [added in WinRVM ver 1.8.4]

Click to edit c:\cf1500\CharityInfo.ini, which defines the list of charities to display to the user (requires touch-screen monitor and no Lexan panel in front of the screen!). Up to 10 charity names can be defined in the file c:\cf1500\CharityInfo.ini, such as:
CharityName=American Cancer Society
CharityName=American Red Cross
CharityName=Big Brothers/Big Sisters of America
...
DefaultCharityName=charity to automatically select if user doesn't select a charity in the allotted time (if this isn't specified the default charity will be the first charity)

Edit coupon names     [added in WinRVM ver 1.9.6]

Click to edit c:\cf1500\CouponInfo.ini, which defines the list of coupons to display to the user (requires touch-screen monitor and no Lexan panel in front of the screen!). Up to 10 coupon names can be defined in the file c:\cf1500\CouponInfo.ini, such as:
CouponName=Aquafina,CouponLogo-Aquafina.gif
CouponName=Aunt Jemima,CouponLogo-AuntJemima.jpg
CouponName=Campbell's Soup,CouponLogo-Campbell's.gif
...
DefaultCouponName=Crest

Min containers to show coupon selection screen     [added in WinRVM ver 3.0.5]

The coupon selection screen is only shown if the customer inserted this number of containers. Default value=0.

Selection timeout     [added in WinRVM ver 1.8.4]

Defines how long to wait for the user to select a charity or coupon. If a charity isn't selected within the allowed time, the default charity name (defined by the "DefaultCharityName" line in CharityInfo.ini) will automatically be selected and random ads will resume playing.
Default=60 sec, 0=wait forever

Stop Interactive Mode when door opened. When door closed resume previous mode.    [added in WinRVM ver 3.2.6]

This is handy as you don't need to enter keypad command #9,99 to exit interactive mode, simply open the cabinet door. This setting applies to Interactive Mode only (not Unattended Mode). Default=enabled.


Reimagine Mode Options  [added in WinRVM version 3.0.0

WinRVM now supports a major new operating mode called "Reimagine Mode". When not in this mode, WinRVM operates as before, communicating with CF1500 RVM(s)/interactive RVM. When in Reimagine Mode, it communicates only with the new Reimagine recycling center. The Reimagine recycling center accepts aluminum cans and PET bottles.  See reimagine mode for more info.

Reimagine role of this PC

Select one of the 4 radio buttons to set the Reimagine mode:

Mobile unit role of this PC

Select one of the 4 radio buttons to set the mobile unit mode:

Ask customer for phone # for raffle

If enabled, when a mobile unit customer chooses a raffle ticket, they are now prompted to enter their phone number after they press the “Touch to receive your reward coupon(s)” button. The phone number entry screen has a "back" button to allow customer to change their mind and select a different reward.
The raffle winner selection screen (displayed when a Reimagine employee scans a special loyalty card), now also displays the winner's phone number.
Note: when "Ask customer for phone # for raffle" is disabled, "phone number:" is still displayed on the raffle winner selection screen, but no phone number digits are displayed.
The customer's raffle ticket number(s) are now written TransactionLog.csv which WinRVM searches for the winning customer's raffle ticket number and corresponding phone number.

When configured as a Reimagine video PC:
Reimagine Mode is very similar to Interactive Mode, except it doesn't communicate with a CF1500, it simply plays videos as defined by \cf1500\video\VideoPlaylist.ini.
Click the movie reel icon on the toolbar to show videos, press Esc to quit, just like Interactive Mode.
WinRVM will not play video/photos files in \cf1500\video that begin with "bigfoot".
If sleep mode is enabled, the photo \video\BigfootSleepingPhoto.jpg will be shown while sleeping. A text message can also be shown while sleeping as defined by the "SleepingText" setting in bigfoot.ini.

When configured as the user interface PC:

See WinRVM 3.1.2 and 3.1.4 for Mobile Unit differences.
The Reimagine logo icon appears on the toolbar. Click it to start the Reimagine user interface.
All CF1500-related menu items are hidden such as "Send to RVM", "Retrieve from RVM", "Advanced", most toolbar icons, as well as CF1500-related items in the Options such as the RVM comm, eppsi, manual mode tabs, the barcode options in general tab.

For testing purposes, the bigfoot simulator program "BigFoot_Dummy.exe" can be used instead of a real bigfoot PLC.

During operations if a bigfoot error is detected, "The machine is going out of service, please complete your transaction" is displayed so the user can save their points/donate/get a reward, etc, then the Out of service screen will show (the current error message is indicated in small text). If bigfoot recovers, the welcome screen is shown.
Multiple warnings/errors will be displayed if one warning/error is already active.

When Esc is pressed to exit the Reimagine user interface mode, the main WinRVM screen shows the status ( Ready, Running, Key switch, reject chute sensor) of the Reimagine unit.
The left side of the status bar shows the status of the bigfoot connection such as "Bigfoot: connected" or "Bigfoot: NOT connected".

The WinRVM title bar shows the bigfoot PC role such as [User Interface] or [Video PC 1] or [Video PC 2] after the WinRVM version instead of "[RVM tables folder=c:\cf1500]".

The configuration file \cf1500\bigfoot.ini defines many of the Reimagine settings.
Rewards.ini defines the point value of each reward and the coupon file to be printed.
Sweepstakes.ini defines various sweepstakes settings
The file "File from FIC to Recycler.dat" (provided by Coke and updated daily) defines the school names for the donation feature

Misc

Click the "edit" buttons to edit the various files.

Printers

WinRVM supports up to two Hecon X56 printers. You must specify the COM port of each printer under "port 1" and "port 2".

The Reimagine options shows the current printer as 1 or 2.
Click the "show printer n status & use this printer" button to show the status of the selected printer and force WinRVM to use this as the default printer for printing.

Click a "Print test" button to print the test voucher file BigfootTestReceipt.vou.

If a printer fails, the other printer will be automatically switched to and WinRVM will log a printer error such as:
<999998> 04/12/10 09:43:27 -- E007: Head Lifted on Printer
<999998> 04/12/10 09:43:27 -- (on COM port 1)

 If both printers fail the follow error is logged:
E509: Both printers failed

Printing a receipt increments \video\ReceiptCounts.txt. The "Reset max receipt vends" button in the Reimagine options deletes \video\ReceiptCounts.txt which resets all the receipt counts to 0.
To remotely reset the printer counts, send the command file: DeleteFile c:\cf1500\video\ReceiptCounts.txt
ReceiptCounts.txt is sent to the host during a scheduled call.

When user wants a receipt, one of the following receipts are printed (all files in \cf1500):
BigfootBankReceipt.vou
BigfootCharityReceipt.vou
BigfootSweepstakesReceipt.vou

Loyalty card scanner

If you scan a barcode it should be displayed on screen.
There is no COM port setting as the Symbol MS-3207 scanner is a USB device that simply "types" the scanned characters into a program.
Care must be taken not to scan a barcode when on a different text entry field in WinRVM options (or running a text editor, etc) as this act as if the barcode was typed in using the keyboard.

The the scanner is not plugged in WinRVM will log error 511 "No loyalty card scanner detected".

Note: The scanner must be programmed to send CR suffix after barcode by scanning the following barcodes in the Symbol Manual (Symbol MS-3207 integration guide 6713504a.pdf):
"Scan Options" (p 10-80)
"<DATA><SUFFIX>" (p 10-81)
"Enter" (p 10-81)
 

Note: these settings were moved to bigfoot.ini in WinRVM 3.5.9:

To prevent loyalty card scanning problems,  set the "If no barcode scanned in X minutes" to a non-zero value such as 60 (minimum value is 2).
The "between the hours hh:mm and hh:mm" field defines the hours of the day this feature is active. To make it active all the time set the left time to 00:00, the right time to 23:59.
If no loyalty card is scanned within the specified time you can designate up to 4 actions to occur:

- Reset scanner (this is the default action, takes around 6 seconds)
- Send email  (the email will indicate "No barcode scanned in X minutes" and be sent to the "error email" address in the Misc Options)
- Restart WinRVM (takes around 55 seconds to return to the welcome screen)
- Reboot PC (takes around 2 minutes to return to the welcome screen)

Resetting the scanner requires the new file devcon.exe to be in same folder as WinRVM.exe (separate 32/64 bit windows versions).
If devcon.exe is not found it will be automatically downloaded from the host. Devcon.exe is now included in the WinRVM setup file.

Note: when not in Reimagine mode the "no barcode scanned" timer is suspended. When WinRVM is restarted the timer restarts also.

Cell phone numbers to send text messages to when an error is detected

Enter up to 7 phone numbers to receive text messages.

Card Dispenser

Configure the COM port that the card dispenser is attached to. You can click a button to show the dispenser status, vend a card, and reset the dispenser.

Communications to networked PCs

Set the "User interface PC IP address" to the IP address of the user interface PC, which should be listed below after "My IP address".

Port must be set to 3664

Ignore printer/card reader/reimagine errors (demo purposes only!) - only enable this when giving a demo, it should always be unchecked in normal operations

UI command: start / stop / reset counts. These buttons allow you to manually send a start/stop/reset counts command to the bigfoot.
The can/PET/reject count sent by the bigfoot will be displayed.

"Reimagine status:" indicates if the bigfoot is communicating and if so, "Packet received:" will show the last data packet received.


Misc Options  [added in WinRVM version 3.4.3

Email addresses to send error notifications  [added in WinRVM 3.0.3]

To send the email to multiple address separate the email addresses by commas (no spaces).
To send an SMS, use the phone's email address which is usually in a format such as: phonenum@carrier.com such as 2037204059@vtext.com. See here for a list of carrier names.

Four fields define the email server credentials: Server, User, From, Password.

Three fields define the subject and body: subject (part 1), subject (part 2), body
"subject (part 1)" is included in every email, not just RVM errors, while "subject (part 2)" is appended to "subject (part 1)" for error emails only. Default values:
subject (part 1) = "[%n]"  
%n is the site name (or Site ID if site name is blank).
subject (part 2) = "%:00"
body = "%:00"

For Australia, they want the email subject to be "RVM Alert" and the body to indicate the site ID, site name, error code and description.
To do this set subject (part 1) = blank, subject (part 2) = "RVM Alert", body = "%i %n %:00".

See voucher template command for a description of the various % codes (note: not all codes are supported by WinRVM for emails, some codes are RVM-specific).

Enable the "SSL" check box if your email system requires SSL [added in WinRVM 3.3.5]. If using SSL you must specify the mail server port (see below).

You can optionally specify the mail server port in the server field by adding ":portnumber" to the server such as "smtp.gmail.com:587" [added in WinRVM 3.3.5].
If using the Envipco email server, you can only send email to other envipco email addresses (@envipco.com). We can configure our email system to relay incoming email to non-envipco addresses, but the easiest way to send email to a non-envipco email address is to use a different email server such as gmail.
Note: if inside the Naugatuck office you must change the server to daedalus.ct.envipco.com because of firewall issues.
As of WinRVM 3.3.5, sending an email requires the external program c:\program files\WinRVM\sendemail.exe. If WinRVM attempts to send an email but sendemail.exe is missing, the file will be downloaded from the host FTP server (anyone not using the Envipco FTP servers such as Australia & Greece need to copy this file to the "tosite" folder on their FTP server). If installing WinRVM from the setup program, sendemail.exe is automatically installed (if installing WinRVM 3.3.5 or later, see here for latest version).

The default email address is reimagineerrors@envipco.com, which is a distribution list, which can be configured to forward the email to any email address or cell phone.
Click the "Defaults" button to change back to these default settings.

Note: the file c:\cf1500\Errlist controls which errors are emailed by using a "T" or "B" in column 8, see the Errlist file for more info. For example, errors that can be fixed by store personnel such as bin full/out of paper do not cause an email to be sent.
Also see the "Errlist col 8 override character for all errors" setting in the Host Options. If you want all errors to cause an email to be sent then change this setting to "B".

The email will be sent by "Envipco Site [siteid]" (for RVMs) or "Reimagine [siteid]" (for Reimagine sites) and the subject and email body will contain the error code and description such as:

From: Reimagine 999998 [mailto:reimagine@envipco.com]
Sent: Tuesday, July 27, 2010 2:13 PM
To: Randy Dellinger
Subject: E555: Jam in front of PET1 compactor

E555: Jam in front of PET1 compactor

Developer email addresses to send SQL/system errors (used by Reimagine sites only):
Database error emails are sent to this email address which defaults to reimaginesqlerrors@envipco.com. The email subject will be "database error!".
When a database command fails, the failed commands are written to the file "c:\cf1500\SQL Commands NOT To Retry.txt" to make it easier for the IT dept to manually submit these failed transactions to the database.

Minutes between retries

If an email fails to resend, retry this many minutes later.
Note: this value must not be 0, otherwise no emails will be sent (versions WinRVM ver 3.6.2 and later)!

NexCycle daily report:

Specify the email addresses to send reports (separated by commas).

The barcode tables must contain:

- The site's RC number as the second line of the file, just after the “#T” line. Make the line a comment with “;RC#” preceding the actual RC number such as:
#TAF
;RC#123


- The weight (in lbs) of each container at the end of each barcode line in a comment. Format: “;w=weight;”. Use a leading zero if the weight is under 1 lb. Example can barcode table table:
#TAF
;RC#123
123456FFFF,0,0,0,0;w=0.0289;
496340FFFF,0,0,0,2;w=1.02;
8012349012,0,0,0,0;w=0.123456789;

Note: when the daily report is created, the following will be logged for every barcode whose weight field is missing unless "Log if missing barcode table weight info" is disabled:
Weight missing for barcode nnnnnnnnnn

After downloading a Q file (such as during a scheduled data collection), a daily report is created in c:\bb such as "Daily Report 123 2012-10-17.csv" (where 123 is the Recycling Center number). There are no changes to the format of the Q file created.
This report is then attached to an email which is sent to the email address(es) defined by the "Email addresses to send reports (separated by commas)" field.
After the daily report is successfully sent the report is moved to \bb\backup.
The daily report data is cumulative (odometer-style counts).

Sample daily report (can be loaded in Excel):
RC#,Serial#,Date,Alum Small Count,Alum Small Value,Alum Large Count,Alum Large Value,Alum weight (lbs),Glass Small Count,Glass Small Value,Glass Large Count,Glass Large Value,Glass weight (lbs),PET Small Count,PET Small Value,PET Large Count,PET Large Value,PET weight (lbs),Total Count,Total Refund
2606,703340,10/23/2012 2:58:45 PM,11214,$560.70,1666,$166.60,1543.8856,8373,$418.65,675,$67.50,17232.6820999999,13001,$650.05,2104,$210.40,2220.7154,37033,$2073.90

Power saving

- Turn off monitor between these hours

Example: set the first field to "23:00" and the second field to "07:00" will cause the monitor to go into power-saving mode at 11pm and resume at 7am. Clear either of the two fields to disable this feature. The feature doesn't activate when WinRVM is in manual mode, it only activates in Unattended/Interactive/Reimagine mode.
Returning to manual mode turns on the monitor, so opening the cabinet door while the monitor is off will turn the monitor on. This feature requires the program Nircrcmd.exe which is now included in the WinRVM setup file. The file will automatically download from the Envipco FTP server if not found.


WinRVM uses Info-ZIP software for compression, the following notice is required as part of the Info-ZIP license:

This is version 2003-May-08 of the Info-ZIP copyright and license. The definitive version of this document should be available at ftp://ftp.info-zip.org/pub/infozip/license.html indefinitely.

Copyright (c) 1990-2003 Info-ZIP. All rights reserved.

For the purposes of this copyright and license, "Info-ZIP" is defined as the following set of individuals:

Mark Adler, John Bush, Karl Davis, Harald Denker, Jean-Michel Dubois, Jean-loup Gailly, Hunter Goatley, Ian Gorman, Chris Herborth, Dirk Haase, Greg Hartwig, Robert Heath, Jonathan Hudson, Paul Kienitz, David Kirschbaum, Johnny Lee, Onno van der Linden, Igor Mandrichenko, Steve P. Miller, Sergio Monesi, Keith Owens, George Petrov, Greg Roelofs, Kai Uwe Rommel, Steve Salisbury, Dave Smith, Christian Spieler, Antoine Verheijen, Paul von Behren, Rich Wales, Mike White

This software is provided "as is," without warranty of any kind, express or implied. In no event shall Info-ZIP or its contributors be held liable for any direct, indirect, incidental, special or consequential damages arising out of the use of or inability to use this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

  1. Redistributions of source code must retain the above copyright notice, definition, disclaimer, and this list of conditions.
  2. Redistributions in binary form (compiled executables) must reproduce the above copyright notice, definition, disclaimer, and this list of conditions in documentation and/or other materials provided with the distribution. The sole exception to this condition is redistribution of a standard UnZipSFX binary (including SFXWiz) as part of a self-extracting archive; that is permitted without inclusion of this license, as long as the normal SFX banner has not been removed from the binary or disabled.
  3. Altered versions--including, but not limited to, ports to new operating systems, existing ports with new graphical interfaces, and dynamic, shared, or static library versions--must be plainly marked as such and must not be misrepresented as being the original source. Such altered versions also must not be misrepresented as being Info-ZIP releases--including, but not limited to, labeling of the altered versions with the names "Info-ZIP" (or any variation thereof, including, but not limited to, different capitalizations), "Pocket UnZip," "WiZ" or "MacZip" without the explicit permission of Info-ZIP. Such altered versions are further prohibited from misrepresentative use of the Zip-Bugs or Info-ZIP e-mail addresses or of the Info-ZIP URL(s).
  4. Info-ZIP retains the right to use the names "Info-ZIP," "Zip," "UnZip," "UnZipSFX," "WiZ," "Pocket UnZip," "Pocket Zip," and "MacZip" for its own source and binary releases.