VeriFone GemStall Ruby SuperSystem User manual

GemStall
Petroleum/C-Store Division




























300 South Park Place Blvd., Suite 100
Clearwater, FL 33759
[phone] Office
[phone] Fax


Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
iii
Ruby SuperSystem™
GemStall
Published: September 4, 2002
VeriFone, Inc.®
Petroleum/C-Store
300 South Park Place Blvd., Suite 100
Clearwater, FL 33759
Office: [phone]
Fax: [phone]
Printed in the United States of America.
© 2001 VeriFone, Inc. All rights reserved.
No part of this publication may be copied, distributed, stored in a retrieval
system, translated into any human or computer language, or transmitted in
any form or by any means, without the prior written consent of VeriFone, Inc.
The content of this document is subject to change without notice. The
information contained herein does not represent a commitment on the part of
VeriFone, Inc.
Publications may not be stocked at the address given above. Requests for
publications should be made to your VeriFone, Inc. Representative.
GemCom, Ruby SuperSystem, Pearl, HPV-20, Sapphire, VeriPass, and
Transaction SuperSystems are trademarks of VeriFone, Inc.
All other products mentioned in this manual are trademarks or registered
trademarks of their respective owners.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
iv
Field Services & Support
GemStall Manual - Revision History
Revision Revision Date Author(s) Description
1.3 May 8, 1996 Revision: Change in software
2.0 August 22, 1996 Revision: Software Updates
2.01 June 9, 1997 Revision: Software Updates
2.1 April 22, 1998 Revision: Software Updates
2.2 August 11, 1998 Revision: Production Release
for Software and Documentation
3.0 October 5, 2001 Cindy_B1 Addition: Technical Text
Updates, Screen Prints and
Step-by-Step Instructions
3.1 December 17, 2001 Cindy_B1 Revision: Accessing GemStall
Update, Header and Footer
Reformatted.
Technical Addition: Setting Up
A Workstation
3.2 January 22, 2001 Cindy_B1 Revision: System
Requirements
3.3 August 20, 2002 Cindy_B1 Addition: To Install An
Application
Date of Printing, September 4, 2002
All revisions since the last published date are lighted in light blue.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
v
Table of Contents
OBJECTIVES FOR THIS MODULE............................................................................... 1
OVERVIEW..................................................................................................................... 1
General Information.................................................................................................................................1
REQUIREMENTS........................................................................................................... 2
System Requirements .............................................................................................................................2
Hardware Requirements..........................................................................................................................2
Software Requirements...........................................................................................................................2
NETWORK APPLICATIONS.......................................................................................... 3
Application Name.....................................................................................................................................3
Version Number .......................................................................................................................................3
Registering a Site.....................................................................................................................................3
ACCESSING GEMSTALL.............................................................................................. 4
NAVIGATING IN GEMSTALL........................................................................................ 5
GEMSTALL FUNCTIONALITY ...................................................................................... 6
Basic Information.....................................................................................................................................6
How To Open an Application..................................................................................................................7
Editing An Application ..........................................................................................................................10
Installing An Application.......................................................................................................................11
Upgrade Option......................................................................................................................................13
Backup Option .......................................................................................................................................13
Restore Option.......................................................................................................................................14
GemStall Options...................................................................................................................................15
Exiting Gemstall.....................................................................................................................................17

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
vi
SETTING UP A WORKSTATION................................................................................. 18
LAN/Workstation Edit............................................................................................................................18
Other Workstation Edits........................................................................................................................18
Dip Switch Settings ...............................................................................................................................19
CPU 3 ..................................................................................................................... 19
CPU 4 & 5............................................................................................................... 19

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
1
Objectives For This Module
After completing this module, the student will be able to:
• Access the GemStall software application.
• Navigate within the GemStall application.
• Discuss and perform the functionality (file, edit, install, etc.) within
GemStall, which includes:
o Open an application within GemStall.
o Perform edits within GemStall as required based on the Site
Survey.
o Complete a successful software application install.
o Perform file upgrades within GemStall.
o Perform backups and restores within GemStall.
o Perform setup reprints, change comport settings and baud rates
within GemStall.
Overview
General Information
GemStall is an MS-Dos software utility program. GemStall allows you to do
the following:
• Download or install an application into a Ruby terminal.
• Edit and upgrade the parameters for site-specific requirements (i.e.
dispenser type, DCR keypad, etc.).
• Backup and restore specific data from a Ruby terminal.
• Reprint the installation and upgrade information from a Ruby terminal.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
2
Requirements
System Requirements
When using GemStall you will be connecting your PC (or laptop) to the Ruby
terminal. The following are the PC (or laptop) requirements needed in order
for the GemStall utility to work properly. These requirements are also needed
in order for you to obtain a connection from your PC (or laptop) to the Ruby
terminal.
Pentium I, 166 mHz processor or better
32 MB of RAM or more
1 gigabyte hard drive or larger
Diskette drive
CD-ROM drive
9-Pin male serial port connection
NOTE: Some computer manufacturers are building laptops without the standard
9-pin male serial port. As a VeriFone Authorized Service Contractor you must
have a 9-pin male serial port connection. This is necessary in order to download
software applications, perform backups and restores, and perform service work
on the Ruby SuperSystem.
Modem, 28.8 kbps or higher
Mouse (external-optional, but much easier to move around)
At least 500 MB of free hard disk space
Hardware Requirements
You will need the following equipment or hardware in order for you to obtain a
connection from your PC (or laptop) to the Ruby terminal.
• DB9, Null Modem Adapter (Female), VeriFone P/N 13638-01
• RS232 Cable, VeriFone P/N 13836-01
• Ruby SuperSystem Terminal
Software Requirements
You will need the following software in order to obtain a connection from your
PC (or laptop) to the Ruby terminal, in addition to downloading and installing
applications to the Ruby terminal.
• DOS v6.0 or higher
• GemStall software, v2.11
• VeriFone Ruby SuperSystem Network/Major Oil Application

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
3
Network Applications
Application Name
Each network (credit card processing center) or major oil has specific
software that is downloaded into the Ruby SuperSystem terminal. This
software is also called an application. Each application includes several files,
which have been developed by VeriFone’s engineering group. These files
are specific to each network or major oil and define how the Ruby will process
information, what features are available, as well as specific functionality.
Each application has a name. All application names end with “Pak”. For
example, if the major oil is Citgo, the name of the VeriFone application is
“CitPak”. If the major oil is Shell, the name of the VeriFone application is
“ShlPak”.
Version Number
Each application in development is labeled with a version number. Each
version number has three parts. A typical version number will look like this:
4.00.01.
All application versions in development are put through an extensive testing
process before publishing. The basic cycle of developing software includes:
Lab Testing – After the actual coding and development a team of Engineers
test the software application in their engineering lab.
Beta Testing – After the software application has been fully tested in the
VeriFone Engineering lab, changes are made until it is ready for “beta”. The
software at this time is installed at an approved beta site. The software is
then put through the test of actually being in the field. The software must run
error-free in the field for a specific period of time before it is released into
production.
Production – After the application has run error-free for a specific period of
time the software is then released into production. At this time the software is
available to all VeriFone Authorized Service Contractors (VASCs).
NOTE: It is crucial to always install the latest version of production software
into every Ruby terminal.
Registering a Site
All Ruby SuperSystem sites must be registered with our Technical Support
Team. When registering a site, the Technical Support Team-Member will ask
for the name and version number of application that was installed. If a
version is installed that is not the latest version in production, the site will not
be registered and you will have to reload the terminal with the most current
version.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
4
Accessing GemStall
Before accessing GemStall, be sure you have completed the following:
• Installed GemStall software on your laptop.
• Installed the application software on your laptop.
• Placed the Ruby terminal into SysMgr mode (see note below).
• Connected the 9-pin null modem to your laptop.
• Connected an RS232 cable from the null modem (on your laptop) to
comport 1 on the Ruby terminal.
NOTE: GemStall only works when the Ruby terminal is in SysMgr mode. To
access SysMgr, take a small-tipped pen or paperclip, press and hold the
button closest to you on the right-hand side of the terminal until you hear the
Ruby beep. At this time the Ruby will power down and come back up. You
know you are in SysMgr when, “Select a YES key NO double-wide keys” is
displayed on the terminal. You don’t need to press any keys on the Ruby at
this time.
To Access GemStall:
STEP ACTION
1 Open your MS-Dos Prompt. *
2 At the C prompt type the following:
cd\gemstall
then press the <ENTER> key.
3 You should now see the following:
c:\gemstall
If you receive a message indicating no directory found you have
not installed GemStall or have installed the program incorrectly.
4 At the c:\gemstall prompt, type the following:
Gemstall
Then press the <ENTER> key.
If you receive an error message indicating no file found you have
not installed GemStall or have installed the program incorrectly.
* If you are using Windows 2000 or ME, your MS-Dos prompt can be found
by clicking on Start, Programs, and then Accessories.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
5
Navigating In GemStall
Because GemStall is a Dos-based utility your mouse will not work. Instead of
using the mouse you will be using the Up, Down, Left, and Right Arrow Keys,
as well as the Space Bar and the Enter/Return Key.
NOTE: On some computers if you click the right or left side of the mouse in
GemStall the utility will lock up.
Here is a quick reference chart for navigating in GemStall.
Key Type Use To:
Up Arrow Move the cursor up on the screen.
Down Arrow Move the cursor down on the screen.
Right Arrow Move the cursor to the right.
Left Arrow Move the cursor to the left.
Space Bar Select an option.
Enter/Return Enter the information into the system and continue to the
next selection.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
6
GemStall Functionality
Basic Information
Below is the main GemStall screen with a short description of each Gemstall
option.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
7
How To Open an Application
The following gives you a step-by-step process for opening an application.
STEP ACTION
1 Highlight File and press the <ENTER> key.
2 Use your <DOWN ARROW> key and highlight Open and press
the <ENTER> key.
3 Use your <DOWN ARROW> key, highlight the application you
wish to download and press the <ENTER> key.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
8
4 Use your <DOWN ARROW> key, highlight the version number
you wish to download and press the <ENTER> key.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
9
5 Use your <DOWN ARROW> key, highlight Progrel and press the
<ENTER> key. Progrel defines the program release.
Progrel will be the only file you will see in this window.
6 Use your <DOWN ARROW> key, highlight “Shift” and press the
<ENTER> key. Shift defines the reporting functions in the
application.
Shift will be the only file you will see in this window.
7 You will see a file on the left-hand side of the window. The file name will be rel.vfg. Use your <DOWN ARROW> key, highlight
OK and press the <ENTER> key.
After opening an application, GemStall will display two additional windows.
In the upper left-hand corner will be the application’s default comport settings.
On the right-hand side of the screen will be the application’s default options.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
10
Editing An Application
When installing an application (or “GemStalling”), you will sometimes need to
change the default comport settings. You may make changes to these
defaults using the Edit feature in GemStall.
The edit options in GemStall are all the features of the software application
version you have opened. The edits are simply yes and no questions for
each of these features. No two software application versions are alike. Edits
change based on the software version, as well as the network or major oil
requirements.
To Edit An Application:
STEP ACTION
1 Ensure you have opened your software application.
2 Highlight Edit and press the <ENTER> key.
3 A small window will be displayed with the first option available.
To Change An Option:
STEP ACTION
1 To change an option use your <DOWN ARROW> key and
highlight the option you need and press the <SPACE> bar.
2 The option will be checked, then press the <ENTER> key.
To Select a Comport Setting and Baud Rate:
STE
P ACTION
1 For options that include a comport setting and baud rate, another
screen will be displayed.
2 If the comport setting is fine, highlight OK and press the <ENTER>
key.
NOTE: Only comport settings/assignments should be changed. Do not
change baud rate settings.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
11
To Change a Comport Setting:
STEP ACTION
1 To change a comport setting use your <DOWN or UP ARROW>
key and highlight the option you need and press the <SPACE>
bar.
2 Once the comport setting and/or baud rate have been changed,
highlight OK and press the <ENTER> key.
After all the edits have been selected, two windows will be displayed on the
GemStall screen.
In the upper left-hand corner will be the comport settings you selected using
the edit option.
On the right-hand side of the screen will be all the application options you
selected using the edit menu.
NOTE: Only comport settings/assignments should be changed. Do not
change baud rate settings.
Installing An Application
When selecting the install option in GemStall the entire software application
will be downloaded into the Ruby terminal.
NOTE: If the Ruby already has a software application downloaded please
keep in mind the Install feature will erase everything in the Ruby terminal and
rewrite all the files.
The average installation will take approximately 30 minutes.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
12
To Install An Application:
STEP ACTION
1 Ensure you have opened your software application.
2 Ensure you have selected the options needed (using the edit
menu) based on the Site Survey.
3 Highlight Install and press the <ENTER> key.
4 A window will appear. Use your <DOWN ARROW> key and
highlight New and press the <ENTER> key.
Before the software application can be downloaded GemStall will ask you the
following questions:
Installed By
Type in your name or the service contractor you work for and press the
<ENTER> key.
Ruby SuperSystem S/N (Serial Number)
Enter the number located on the left-hand side of the Ruby terminal and press
the <ENTER> key.
Ruby SuperSystem P/N (Part Number)
Enter the number located on the label on the bottom of the Ruby terminal.
This number will start with P/N 040. After entering the number press the
<ENTER> key.
Site Telephone Number
This is the telephone number VeriFone or a VASC would use when
contacting the site. Enter this number, including the area code, and press the
<ENTER> key.
Site Postal Code
This is the zipcode of the site. Enter this number and press the <ENTER>
key.
After you answer the questions above and press the <ENTER> key you will
see a message indicating all the information on both the SIMM and Secure
SIMM will be erased. You will be asked if you wish to continue. Select OK
and press the <ENTER> key.
GemStall will reboot your Ruby terminal.
When the Ruby terminal reboots it will make a two-tone sound and the Ruby
operator display will say, “Press any key”. At this time press a singlewide
key. The software application will download into the Ruby VeriFone. After
the installation is complete the Ruby will print out an installation report.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
13
Upgrade Option
This option is used to download a specific file or configuration to the Ruby
terminal. The Upgrade option can also be used to download a change to a
specific file or configuration to the Ruby terminal.
NOTE: This option is NOT used to upgrade the entire software application. If
you need to upgrade the software version please refer to the VASC
Installation and Service Manual, Software Upgrade chapter.
To upgrade a specific file or to change a specific file in the Ruby terminal, use
the following step-by-step process.
STEP ACTION
1 Open the software application.
NOTE: The software application you open MUST be the same
version software application that is currently in the Ruby
terminal.
2 Use your <RIGHT ARROW> key, highlight Upgrade and press
the <ENTER> key.
3 GemStall will display a window with several options, select the
file or configuration you need to download by using your
<DOWN ARROW> key, and press the <ENTER> key.
4 If necessary select the type of configuration, assign a comport,
and baud rate using your <SPACE> bar and the <ENTER>
key.
Backup Option
This option is used to download specific data files onto a diskette from the
Ruby terminal.
If you will be completing an upgrade to the current software application in the
Ruby, please refer to the VASC Installation and Service Manual, Software
Upgrade chapter.

Ruby SuperSystem™ GemStall
VeriFone Confidential 9/4/02
14
Critical information when using GemStall’s backup option:
• This option is not an entire backup – there will be data files that cannot
be backed up on the diskette. The data files that are backed up are
specific to the software application version.
• When using the backup option, whatever software application version
you opened in GemStall will be the software application version the
data files will be saved as. For this reason it is strongly recommended
to label the diskette with the software application version.
• The backup option works in conjunction with the restore option in
GemStall. If you are going to use the restore option you MUST have
opened the same software application version as the backup data files.
• Before going into GemStall on your computer format the diskette.
To Backup Data Files:
STEP ACTION
1 Format the diskette(s) you will be using for the backup(s).
2 Open the software application version.
3 Use the <RIGHT ARROW> key, highlight Backup, and press
the <ENTER> key. Then follow the GemStall prompts to
backup the data files.
4 Label the diskette(s) with the software application version.
Restore Option
The restore option in GemStall is used to download specific data files on the
Ruby terminal. The restore function is used in conjunction with the backup
function in GemStall.
If you will be completing an upgrade to the current software application in the
Ruby, please refer to the VASC Installation and Service Manual, Software
Upgrade chapter.