Software Test Release

    Date: 12-16-05
  Pages: 2

     Product: Pocket WinRVM 
            Rev: 1.1.7

  Author: Randy Dellinger
 

This is a beta version of software, it has not been fully tested yet.

Added "Automatically center store info on vouchers" to the General Options. The default value is enabled. When enabled, the store name and number are automatically centered on vouchers when sending any voucher file to a Cybertech text printer. WinRVM does this by retrieving the store name and number from the RVM, then modifying the voucher accordingly. If the voucher is altered by WinRVM,
    "Centered voucher [filename]"
is logged (it won't alter a voucher file if no site name/number fields are found or if the voucher is for a graphics printer and contains positioning commands). Leading and trailing spaces are removed from the RVM's site name and number in case spaces were previously used to manually center the voucher.
Do not use with Hecon voucher files as the voucher file will become corrupted!

Created "Send to RVM | Printer tickets | Center RVM's current cash voucher" which retrieves the RVM's current cash voucher, centers the store name and number (removes leading/trailing spaces) and resends the voucher to the RVM. This feature also centers the charity voucher if the RVM software supports charity. This menu item works with the "Send to all RVMs" feature.
Do not use with Hecon voucher files as the voucher file will become corrupted!

When using the "Advanced | Set/modify RVM info" screen to change the number of characters in the store name or number, the following warning will display:
"Since you've changed the store name or number, this info may no longer be centered when printing a voucher. To fix, resend all vouchers to the RVM.".


You can now remotely send coupons to RVMs in Unattended Mode. Simply include a "coupon list file" (.CLS file) when sending a siteid.zip file to WinRVM on the FTP server. WinRVM will send each coupon listed inside the .CLS file to all RVMs.
If you want to send specific coupons to specific RVMs, you must have a different coupon list file for each RVM (based on the RVM serial number). Name these RVM-specific .CLS files: ssssssfilename.CLS, where ssssss = 6-digit RVM serial number, "filename" can be any name.
You can now comment-out lines in .CLS files by putting a ";" as the first character of the line.

Added "Enable custom parameter prompts" check box to the General Options, which when disabled, skips all parameter prompts defined in prompt.ini when sending a parameter table to an RVM (see WinRVM ver 1.3.6 for more info on prompt.ini).

Added "Automatically sync RVM clock with PC clock in Manual Mode" to the General Options which defaults to disabled. When enabled, whenever WinRVM communicates with an RVM in Manual Mode, the RVM's clock will be synced with the PC's clock.

Added "Look for command file every x sec" to the Unattended Mode Options like the PC version of WinRVM.

Added "Reboot PPC interval (in hours)" to the Unattended Mode Options like the PC version. This feature is only active when the "This pocket pc is normally used in Unattended Mode" is checked in the Unattended Mode Options.

Increased the size of the "Search" button in the "Advanced | Search recmod tables for barcode" to stand out more. Clicking "Search" now hides the Help button.

Moved the buttons on the Options screen to the left a little so that double-tapping the Options toolbar button on the main screen won't show the RVM communications Options. Made all buttons the same size.

Added "Skip download" button in the toolbar area that is only visible when downloading documentation from the host such as when performing a software update via "host | check for WinRVM program update".

Changed the default value of the "Automatically return to Unattended Mode after this many minutes in Manual Mode" in the Unattended Mode Options from 0 to 60 for new WinRVM installations.

Changed the warning message for Unattended Mode sites with glass RVMs that only have serial number based barcode files (no default table):
        Default barcode file [siteidX.tbl] not found.
    If all RVMs of this type get unique barcode files based on the RVM serial numbers: serno, serno... ignore this warning.
    Check 'Individual barcode file naming convention' in General Options.


WinRVM now detects if the folder "\SD Card2" exists and displays the following warning:
"Invalid storage card name: 'SD Card2'. Run Total Commander and make sure 'SD Card2' doesn't contain any files (it may container blank folders tho), remove the card, then delete the folder '\SD Card'. Insert the card and tap the refresh button, it should then list '\SD Card' and not 'SD Card2."

WinRVM can now determine the name of the built-in flash memory such as "iPAQ File Store" or "storage". Hopefully this will work on the
Qtek 2020 in Greece.


You can now reboot the pocket PC via remote caller (MUSTATUS) or via the "reboot" command in a command file.

Discovered a way to make WinRVM run on startup for Unattended Mode sites: put a shortcut to WinRVM in \Windows\startup using the pocket PC's File Explorer to copy/paste the shortcut.

WinRVM now aborts after 3 FTP upload failures. It will display "Upload failed too many times, aborting".

For debugging purposes, the current WinRVM version is now logged when performing a scheduled data collection in Unattended Mode.


Bug Fixes:

When the following message occurs: "error: IndexOutOfRangeException in GetRvmTableToBuffer"
some type of error has occurred when retrieving the barcode table from the RVM. Unfortunately Pocket WinRVM ignores this error and writes a Q file that most likely contains corrupted data. Even more unfortunate is that WinRVM may then determine that the RVM's barcode table was unsorted and then ever-so-helpfully reload the RVM with barcodes from the corrupted Q file. This can explain corrupted Q files and why subsequent downloads of this RVM have far fewer barcodes in them. If this error occurs in the future WinRVM will at least not create a corrupted Q file nor reload the RVM with corrupted barcodes. I've also added more debugging info after the "error: IndexOutOfRangeException in GetRvmTableToBuffer" message to hopefully give me a clue why this is happening.

If downloading an RVM but the RVM contains no barcodes, the following would be displayed: "Error writing to \SD Card\bb\Q[sn]. ArgumentNullException" and no Q file would be written. WinRVM now displays "No barcodes in RVM, reload barcodes!" and writes the terminating line of "MU FFFFFFFFFFFFFFFFFFFFFF" to the Q file

Pocket WinRVM versions 1.0.9-1.1.6 have a bug that prevent the pocket PC from putting the RVMs to sleep and waking them up.
As a workaround for older versions: switch to manual mode and set "send | send to all RVMs" to checked, then switch back to Unattended Mode. This will allow sleep mode to function normally.

In Unattended Mode, if the error host in the Internet Connection Options was disabled, and WinRVM reports the service visit (X min after RVM taken out of service mode), WinRVM would log "Host disabled" and retry 25 times to send the file, logging "host disabled" each time. WinRVM no longer retrieves the status from all RVMs or creates a zip file for this scenario.

In Unattended Mode when the scheduled call time arrived, if WinRVM had previously failed for 25 FTP retries, it would not attempt to send data.

In Unattended Mode, if the modem was enabled but you removed the modem card after a call, a window would display "CreateFile Failed:55 trying to open modem COM port. Modem now disabled", requiring "OK" to be tapped when there may be no user present.

When tapping the "OK" button (not "ok" in the top right) in the General or Barcode Options, it would save to the registry twice, and could display the "Default barcode file [filename] not found." message twice.

Previously, if the SD card fails, the pocket pc will start saving data to the built-in flash. However, if the SD card later starts working, the next time a scheduled call occurs, the data in the built-in flash wouldn't be sent in - now it does.


Installation Notes:

To upgrade from an older version of Pocket WinRVM, you have two choices:

a) If the pocket PC has internet access run pocket WinRVM and select "Host | Check for WinRVM program update" and choose "yes" to install the new version. This will also download the latest WinRVM documentation. After the update is complete, click "Help | About" to verify the correct version of WinRVM was loaded. Note: if WinRVM says you must perform a full install, follow step b).

b) 
- Press and release the reset button on the back (or bottom) of the Pocket PC with the stylus.
- Turn on the Pocket PC and plug it into the PC's USB port using either the docking cradle or the USB/RS232 "Y" adapter cable.
- A "New Partnership" window should display on the PC within a few seconds. Ignore this window - just leave it open.
- Run PocketWinRVM117_setup.exe (1.2MB) on your PC which will install Pocket WinRVM on the pocket PC.
- When asked to "install Pocket WinRVM in the default directory", select YES.
- The pocket pc should display "Envipco Pocket WinRVM is already installed. Re-install? Tap "OK".
- If the pocket pc asks "would you like to replace the existing file ...", tap "Yes to all".
-[optional] To update the WinRVM documentation on the pocket pc:
If the pocket PC has internet access:
- Run pocket WinRVM and select "Host | Check for WinRVM documentation update".
otherwise:
- Run the desktop (PC) version of WinRVM and select "Host | Check for WinRVM documentation update" (requires internet access).
- Run "Update WinRVM docs.bat" from "c:\pocket pc setup files" (or wherever you previously unzipped BatchFiles.zip to) .


To setup a new pocket PC or to restore a pocket pc whose memory got erased due to the battery completely discharging:

Download the appropriate backup file below for your iPAQ model (click here to determine which model you have), then follow the instructions "How to restore a pocket pc from a backup" in the "Pocket PC install info document.

iPAQ 2215: Download a backup file from a previous  versions of pocket WinRVM, follow the instructions "How to restore a pocket pc from a backup" in the "Pocket PC install info document, then follow the upgrade instructions above. 
iPAQ 2110: Download a backup file from a previous  versions of pocket WinRVM, follow the instructions "How to restore a pocket pc from a backup" in the "Pocket PC install info document, then follow the upgrade instructions above. 

other versions of pocket WinRVM