









Omni-MallT 2.0
for
Worldgroup by Galacticomm, Inc.

Copyright c 1995 - All Rights Reserved
Omni-MallT is a trademark of DataSafe Publications, Inc.
WorldgroupT and GalacticommT are trademarks of Galacticomm, Inc.






DataSafe Publications, Inc.
3301 Juan Tabo NE, Suite 113
Albuquerque, NM 87111


505-294-4980 Voice
505-294-1575 BBS
505-294-8225 FAX

TABLE OF CONTENTS
LEGAL & TECH SUPPORT	1
COPYRIGHT	1
LICENSE	1
LIMITED WARRANTY	1
LIMITATION OF REMEDIES	1
INDEMNIFICATION	1
TECHNICAL SUPPORT	2
REQUIREMENTS	2
OPTIONAL POS DIAL SUPPORT	2
OPTIONAL FAX SUPPORT	2
QUICK START INSTRUCTIONS	3
INSTALLATION	3
ADDING STORES	3
ADDING DEPARTMENTS	3
ADDING PRODUCTS	3
INSTALLATION	4
DISTRIBUTION FILES	5
MSG CONFIGURATION OPTIONS	5
LEVEL 3 - SECURITY AND ACCOUNTING	5
LEVEL 4 - CONFIGURATION OPTIONS	6
SYSOP'S FUNCTIONS	8
SYSOP MENU (TERMINAL MODE)	8
ADDING/EDITING A STORE (TERMINAL MODE)	9
SYSOP MENU (C/S MODE)	10
BAD CREDIT CARDS	12
MANAGER'S FUNCTIONS	13
MANAGER'S MENU (TERMINAL MODE)	13
STORE EDITOR (TERMINAL MODE)	14
STORE EDITOR (C/S MODE)	16
Store Information	16
Tax Options	17
Tax Table	18
Invoice Questions	20
Shipping Table	20
Store Browser Bitmap	22
DEPARTMENT EDITOR (C/S MODE)	22
DEPARTMENT EDITOR (TERMINAL MODE)	24
PRODUCT EDITOR (TERMINAL MODE)	25
PRODUCT EDITOR (C/S MODE)	28
Product Editor (Description)	29
Product Editor (Pricing)	30
Product Editor (Product Formats)	32
Product Editor (Product Files)	32
PRODUCT FORMATS	34
Product Format Editor (Terminal Mode)	34
Product Format Editor (C/S Mode)	35
IMPORTING/EXPORTING	36
Importing Products	36
Exporting Products	37
Import File Specification	37
APPENDIX A - POS DIAL CONFIGURATION	41
FDP  FIRST DATA ETC TYPE 7	42
FDR FIRST DATA RESOURCES ETC TYPE 2	42
ICV IC VERIFY	43
MODULAR DATA INCORPORATED	43
PPI VISA INTERNATIONAL POS-PORT	44
TST POS TEST NETWORK IDENTIFIER	44
APPENDIX B - FAX/ONLINE CONFIGURATION	45
APPENDIX C - CONVERSION FROM OMNI-MALL V1.X	46


LEGAL & TECH SUPPORT
Copyright
Omni-Mall and accompanying documentation is copyright c1995 by DataSafe Publications, Inc., 
hereafter referred to as DataSafe. All rights to Omni-Mall are reserved by DataSafe. You must 
keep the program in strict confidence and treat it like any other copyrighted material. You may not 
copy the written materials accompanying the software program.
License
You may use Omni-Mall on a single bulletin board system. You may copy the program into any 
machine-readable form of backup in support of your use of the program on the single bulletin 
board system.

You may NOT transfer the license and program to any other party.
Limited Warranty
DataSafe warrants that the computer media on which Omni-Mall is furnished shall be free from 
defects in materials and workmanship for a period of thirty (30) days from the date of purchase by 
any end-user. DataSafe shall replace Omni-Mall if the original package including all documentation 
and magnetic media is returned to DataSafe within thirty (30) days of the discovery of such 
defect. The sole remedy for any breach of the foregoing warranty shall be a replacement of the 
defective portion of the program.

DATASAFE DOES NOT WARRANT, REPRESENT, OR GUARANTEE THAT ALL PROBLEMS WILL BE 
CORRECTED OR THAT ANY UPDATES WILL BE COMPATIBLE WITH PREVIOUS VERSIONS OF 
OMNI-MALL. EXCEPT AS EXPRESSED ABOVE, DATASAFE DISCLAIMS ALL WARRANTIES, 
EXPRESSED AND IMPLIED, TO THE PRODUCT, INCLUDING ALL IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND DATASAFE DISCLAIMS 
ALL OBLIGATIONS AND LIABILITY ON DATASAFE'S PART FOR DAMAGES, INCLUDING BUT 
NOT LIMITED TO SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES IN CONNECTION WITH 
USE OF THE PRODUCT, WHETHER OR NOT DATASAFE HAS BEEN ADVISED OF THE 
POSSIBILITY THEREOF.
Limitation of Remedies
The entire and exclusive liability and remedy for breach of this Limited Warranty shall be limited to 
replacement of defective diskette(s) or documentation and shall not include or extend to any claim 
for or right to recover any other damages, including but not limited to, loss of profit, data, or use 
of the software, or special, incidental, or consequential damages or other similar claims, even if 
DataSafe has been specifically advised of the possibility of such damages. In no event shall 
DataSafe's liability for any damages to you or any other person ever exceed the lower of 
suggested list price or actual price paid for the license to use the software, regardless of any form 
of the claim.
Indemnification
THE PURCHASER AGREES THAT THEY ARE FAMILIAR WITH, UNDERSTAND, AND COMPLY 
WITH ALL LAWS AND REGULATIONS RELATING TO THE USE AND ACCEPTANCE OF CREDIT 
CARDS. THE PURCHASER FURTHER AGREES TO INDEMNIFY AND HOLD HARMLESS DATASAFE 
FOR ANY DAMAGES OR LIABILITIES THAT MAY ARISE FROM THE USE OR MISUSE OF THE 
SOFTWARE PROGRAM INCLUDING ANY DAMAGES AND ATTORNEY'S FEES.
Technical Support
DataSafe will provide technical support for Omni-Mall via telephone, fax, or electronic mail. It is 
strongly suggested that you create an account on our support BBS. Any updates to our modules 
are placed on our support BBS for download. When you create an account on the support BBS, 
please send an e-mail message to Sysop with your Worldgroup registration number and any 
DataSafe products you own. Technical support calls will not be accepted via our toll-free 800 
number. We can be reached at the following address and phone numbers:

DataSafe Publications, Inc.
3301 Juan Tabo NE, Suite 113
Albuquerque, NM 87111

800-870-0004 Orders
505-294-4980 Technical Support
505-294-8225 Fax
505-294-1575 BBS

Internet E-mail:	sysop@dsafe.com
Telnet:			dsafe.com (199.190.74.2)
WWW:		http://www.dsafe.com

REQUIREMENTS
Omni-Mall requires that you are running Worldgroup by Galacticomm. Omni-Mall is shipped as a 
run-time DLL that must operate in conjunction with Worldgroup. Omni-Mall has been tested and 
operated with Worldgroup v1.0 and v1.01.

Omni-Mall uses approximately 245Kb of memory above 1Mb (extended memory) and 
approximately 3Kb of memory below 1MB (low memory). Omni-Mall uses approximately 1Mb of 
disk space on your Worldgroup server without any store data.

It is assumed that you have a good understanding of DOS, Windows, and your computer. It is also 
assumed that you understand the basics of modem communications such as logging onto a BBS 
and uploading/downloading files. It is also assumed that you make regular backups of your system 
and understand how to restore files from those backups. In addition, the specific hardware 
requirements set forth by Galacticomm to operate Worldgroup also apply.
Optional POS Dial Support
Omni-Mall supports online credit card verification if the POS (Point of Sale) Dial Module is 
installed. See the POS Dial documentation for the specific requirements needed to support online 
verification. Appendix A has specific information on POS use with Omni-Mall.
Optional Fax Support
Omni-Mall supports online faxing of orders to store managers if the Fax/Online module from 
Galacitcomm is installed. Appendix B has specific information for configuring Fax/Online for use 
with Omni-Mall.

QUICK START INSTRUCTIONS
These quick start instructions are designed to get experienced Worldgroup sysops up and running 
quickly. If you are a novice sysop or don't have experience adding modules to your system then 
you will probably want to use the complete instructions. These instructions assume you are using 
Omni-Mall in ANSI terminal mode.

Installation
1. Insert the Omni-Mall distribution diskette in a floppy drive and run the INSTALL.EXE program.
2. Add Omni-Mall to the terminal mode and C/S mode menu tree as a module page.
3. Edit the level 3 and level 4 configuration options in DPIOMALL.MSG.
4. Add Store(s).
5. Add Department(s).
6. Add Products.

Adding Stores
1. Enter Omni-Mall as a Sysop level user.
2. Select the Sysop Menu.
3. Choose Add Store from the Sysop menu in Omni-Mall
4. Enter the Store Code, Title, Description, and toggle the Fax and POS options ON/OFF.
5. Save the new store.
6. Select the Manager's Menu and enter the store information.
7. Save the store information.
8. Add Department(s) to the store.

Adding Departments
1. Enter Omni-Mall as a Store Manager or Sysop level user.
2. Select the store.
3. Select the Manager's Menu.
4. Select Edit department options.
5. Select Add a department and enter the department information.
6. Enter the department information.
7. Save the new department.
8. Add/Edit product formats if needed.
9. Add product(s) to the department.

Adding Products
1. Enter Omni-Mall as a Store Manager or Sysop level user.
2. Select the store.
3. Select the department.
4. Select the Manager's Menu.
5. Select Product Editor.
6. Select Add a new product.
7. Enter the product information.
8. Save the new product.

INSTALLATION
Installation of Omni-Mall should be done when your Worldgroup server is down and the cursor is 
at the DOS prompt. Do not be confused by the options "Basic Utilities" or "Add-on Utilities" on 
the Worldgroup Introductory Menu as those options are not used during the installation or 
operation of Omni-Mall. 

1.	Backup the Omni-Mall distribution diskette using the DOS copy command. Use the backup 
diskette for installation.

1a.	If the distribution diskette is the wrong size simply copy the files from the distribution 
diskette to the correct sized diskette and proceed with the installation.

1b.	If you downloaded a ZIP file then unzip that file to a floppy drive or a temporary 
subdirectory.

2.	Put the Omni-Mall diskette in the appropriate floppy drive (assumed to be A: for these 
installation instructions) and type:

	A:\INSTALL

	Follow the on-screen directions to install the run-time files from the distribution diskette 
into your WGSERV subdirectory.

3.	Choose option 2 (Menu Tree) from the Introductory Menu and add Omni-Mall to both the 
terminal mode menu tree and the client/server menu tree. Omni-Mall should be installed as 
a Module Page in terminal mode and as a C/S Module Page in client/server mode. See the 
section on Menu Trees on page 224 of the Worldgroup Sysop's Guide for more information 
on adding modules to your system's menu tree.

4.	Choose option 3 (Security & Accounting) from the Introductory Menu. Hit the <F8> key 
and begin a search for DPIOMALL.MSG. Once the level 3 security options appear, modify 
them for operation with your system. See the section in this manual regarding MSG options 
for further details. After configuring the level 3 security options, save your changes and 
exit back to the Introductory Menu by hitting the <F10> key.

5.	Choose option 4 (Configuration Options) from the Introductory Menu. Hit the <F8> key 
and begin a search for DPIOMALL.MSG. Once the level 4 configuration options appear, 
modify them for operation with your system. See the section in this manual regarding MSG 
options for further details. After configuring the level 4 configuration options, save your 
changes and exit back to the Introductory Menu.

7.	Choose option 5 (Go!) from Worldgroup Introductory Menu and bring up your BBS.

8.	Log on locally <F7> as the Sysop user and select Omni-Mall from the menu that you 
added it to. You may also log on from a remote computer using the Worldgroup Manager.

9.	Set up at least one store and department within Omni-Mall. Use the Sysop commands to 
add store(s) and department(s).

10.	Add at least one product to the store(s) added in the previous step.

11.	If you  need to add online credit card verification with the POS Dial Module, see appendix A 
for installation instructions.

12.	If you need to add fax support using the Galacticomm Fax/Online module, see appendix B 
for installation instructions.

Distribution Files
Omni-Mall consists of the following files in the \WGSERV subdirectory:

DPIOMALL.DLL	Run-time Dynamic Link Library
DPIOMALL.MSG	Configuration File
DPIOMALL.H		Header File
DPIOMALL.MCV	Runtime Configuration File
DPIOMALL.MDF	Module Definition File
DPIOMALL.RLN	Release Notes (ASCII)
DPIOMALL.DOC	Sysop Docs in MS Word 6.0 Format
DPIOMALL.TXT	Sysop Docs in DOS Text Format
DPIOM*.VIR		VIRgin (empty) Data File
DPIOM*.DAT		Data File

The installation process will place the following client/server files in the \WGSERV\DPIOMALL 
subdirectory.

DPIOMxxx.EXE	Client/Server EXE File
DPIOMxxx.HLP	Client/Server HELP File
DPIOMVB.DLL	Client support DLL
MENUEV3.VBX	Client support VBX
TIPS1.VBX		Client support VBX
MCI.VBX		Client support VBX
LEADDIB.DRV	Client support graphics driver
LEAD.VBX		Client support VBX
GRID.VBX		Client support VBX
VSVBX.VBX		Client support VBX
LEAD50.DLL		Client support DLL

MSG CONFIGURATION OPTIONS
Worldgroup has three levels of setup available from the Worldgroup Introductory Menu (the menu 
that displays when you type WG from the DOS prompt). Omni-Mall does not have any Level 1 
(Hardware Setup) setup options, only Level 3 (Security & Accounting) and Level 4 (Configuration 
Options) options.
LEVEL 3 - Security and Accounting
The Level 3 configuration options include the activation code to enable Omni-Mall to operate with 
your system along with the security keys required to access certain Omni-Mall functions. Your 
Omni-Mall activation code can be found on the distribution diskette label. To enter the level 3 
setup choose option 3 (Security & Accounting) from the Introductory Menu of Worldgroup. Once 
the CNF editor comes up, hit the <F8> key and search for DPIOMALL.MSG to get to the option.

CODE			Omni-Mall Activation Code
Omni-Mall activation code. This code is required for activation of the Omni-Mall online shopping 
mall. Your Omni-Mall activation code will probably consist of letters and numbers but it may be all 
numbers. The activation code is not case sensitive but we suggest entering it in ALL CAPS.

DPIOMAKY		Key required to access agent services of Omni-Mall
Users with this key will be able to access Omni-Mall in Client/Server mode. Normally this key is 
<blank> so all users can access Omni-Mall in Client/Server mode. This option has no effect on 
users in ASCII/ANSI mode.

DPIOMMKY		Key required to access Omni-Mall Manager functions
Any user that will be a store manager needs this key in order to access the manager functions in 
Client/Server mode. This option has no effect on store managers in ASCII/ANSI mode.

DPIOMSKY		Key required to access Omni-Mall Sysop functions
Users with this key will have access to the Sysop functions in Omni-Mall in Client/Server mode. 
This option has no effect on users in ASCII/ANSI mode.

UPBYREFK		Key required to upload files by reference
Store managers with this key will be able to use the "F" protocol choice when uploading files. The 
"F" protocol choice allows a user to upload a file that already exists on the BBS computer. For 
security reasons it is suggested that only sysop level users have this capability.

NOSAVURK		Key required to NOT save user registry
User's with this key will NOT be able to save their customer registry in Omni-Mall (name, address, 
etc.). This allows you to set up GUEST accounts that can order things in Omni-Mall without 
having sensitive information saved from one user to the next.
LEVEL 4 - Configuration Options
The Level 4 configuration options allow you to configure Omni-Mall for operation with your 
particular BBS. To enter the level 4 configuration choose option 4 (Configuration Options) from the 
Introductory Menu of Worldgroup. Once the CNF editor comes up, hit the <F8> key and search 
for DPIOMALL.MSG to get to these options.

SCANDIR		Directory for POS-dial/stub programs
This is the directory Omni-Mall will place transactions into. THIS SUBDIRECTORY MUST BE THE 
SAME as the POS-DIAL Module. This directory is used even if you do NOT have the POS Dial 
Module installed. Omni-Mall will create this directory if it doesn't already exist.

AMERXPRS		Accept AMERICAN EXPRESS credit cards
Set this option to YES if you can process credit card purchases made with this type of credit card. 
Contact your merchant account provider if you are unsure whether you can accept this particular 
card or not.

VISACRD		Accept VISA credit cards
Set this option to YES if you can process credit card purchases made with this type of credit card. 
Contact your merchant account provider if you are unsure whether you can accept this particular 
card or not.

MASTRCHG		Accept MASTERCARD credit cards
Set this option to YES if you can process credit card purchases made with this type of credit card. 
Contact your merchant account provider if you are unsure whether you can accept this particular 
card or not.

DISCVER		Accept DISCOVER credit cards
Set this option to YES if you can process credit card purchases made with this type of credit card. 
Contact your merchant account provider if you are unsure whether you can accept this particular 
card or not.

ISRACRD		Accept ISRA-CARD credit cards
Set this option to YES if you can process credit card purchases made with this type of credit card. 
Contact your merchant account provider if you are unsure whether you can accept this particular 
card or not. Most systems will NOT accept ISRA-CARD.

MAXYEARS		Number of years for expiration date from now
This option determines how many years from today constitute a valid expiration date on a credit 
card. Suggested value is 5 or less.

MINKLEN		Minimum keyword length
This is the minimum length of a valid keyword. For instance, if this option is set to 4, the 
keywords FOR, SIX, NO, MAY, IS, and A will not show up, but the words SHOULD, MIGHT, 
FOURTEEN, CANS, and GRANDMOTHER will.

NONKYWDS		Non-keywords
Hit <F2> to edit the list of words that will NOT register as keywords for the keyword search 
option. Put a space before and after every word you do not want to be searchable as a keyword. 
Any word that is less than the minimum keyword length (option MINKLEN) need not be added to 
this list. Please note that keywords are all upper case and any punctuation is removed before 
keywords are created. Be sure to apply that here, e.g. to filter out the word "isn't" use "ISNT", 
not "ISN" or "ISN'T".

MXWTKS		Max 15 sec intervals to wait for POS response
How many seconds * 15 will Omni-Mall wait for a response from the POS module before timing 
out and rejecting the transaction?

COMQUOT		Comma/quote delimit all ASCII log files
If set to YES then the LOG files will be comma/quote delimited. Comma/quote delimited files may 
be easily imported into database programs like Access, Dbase, Paradox, etc. If set to NO then the 
log files will be in a more readable format.

HIDECRED		Should Cred-Card number be hidden
This option will allow for hiding the credit card number in the E-mail message that is generated 
when a user completes a purchase. If you want the E-mail message to not display the users credit 
card number then set this to YES.

EMAILSYS		E-mail a user for all purchases
Set to YES if you want ALL purchases e-mailed to a specific user. Set to NO if you only want the 
store manager(s) to get the purchases e-mailed to them.

EMSYSUID		User to E-mail all purchases
Enter the user-id to receive ALL purchases in e-mail. This option is only active when EMAILSYS is 
set to YES.

PRODLIBF		Product text filename
Omni-Mall will produce a text file that contains the store code, department code, product code, 
and product title. This file will be created with the name defined. If you want the file to be created 
elsewhere, place any path information in front of the filename.

SENDCOVR		Do you want to send a cover page on faxes
 If you want a cover page to be sent on faxes, set this to YES. If you want faxes to contain the 
purchase invoices only then set it to NO. This option only applies if you have the fax/online 
module installed.


SYSOP'S FUNCTIONS
Sysop level users are the only users able to add stores. While store managers handle the majority 
of the configuration of individual stores, it is the sysop's responsibility to initially set up the store. 
Stores can be added from either terminal mode or C/S mode.

Sysop Menu (Terminal Mode)
The Sysop Menu of Omni-Mall is reached by choosing option S from the main Omni-Mall menu. 
The following menu will be displayed:

Omni-Mall Sysop menu:

   A ... Add a new store
   C ... View or edit the bad credit card list
   D ... Delete an existing store
   E ... Edit an existing store
   P ... POS Dial configuration editor
   T ... Transaction review

   ? ... Help
   X ... Exit to previous menu

Select an option:

A	Add a new store
This option allows you to add a new store to Omni-Mall. See the section in this manual on 
Adding/Editing a Store for more detailed information on adding a store.

C	View or edit the bad credit card list
Use this option to add, delete, or view credit card numbers on the bad credit card list. Any credit 
card number on the bad credit card list will not be accepted by Omni-Mall. We suggest adding 
credit card numbers to this list that are known to be stolen, or that have charged back purchases 
in the past.

D	Delete a store
Use this option to delete an existing store. This option will not work UNTIL you've deleted all of 
the products in this store. All files and subdirectories associated with this store will also be 
removed (except for referenced files).

E	Edit a store
This option allows you to edit a store in Omni-Mall. See the section in this manual on 
Adding/Editing a Store for more detailed information on editing a store.

P	POS Dial configuration editor
This option is used to configure online credit card authorization by store. See Appendix A for more 
information on configuring POS Dial.

T	Credit Card Transaction Review
This option allows you to look up credit card transactions by date range, user-id, and credit card 
number.

Adding/Editing a Store (Terminal Mode)
When adding or editing a store in terminal mode the following data entry screen will display:

Omni-Mall Store Editor
------------------------------------------------------------------------------
Store Code:                                       

Store Title

Description




  Store Manager:                                           +----------------+
Store Entry Key:                                             TAB - Select  
   Store PO Key:                                                 - Select  
   Store BITMAP:                                                 - Select  
                                                             ^F  - Insert  
      Allow Fax: NO  (Press space to toggle)                 ^G  - Save    
                                                             ^O  - Quit    
      Allow POS: NO                                        +----------------+


               Exit:       (select (S)ave or (Q)uit and hit enter)

Store Code
The store code is an 8 character field that can contain any valid DOS file name. Omni-Mall will 
also create a subdirectory on the server's hard drive named after this code. This code is required 
so Omni-Mall can create a subdirectory for storing any image, product, or abstract files.

Store Title
The store title is a one line (80 character) field describing this store.

Description
The description is a four line (65 characters/line) describing this store in greater detail.

Store Manager
Enter the User-ID of the store manager. The store manager can add/edit/delete departments and 
products from this store. This User-ID must also have the key listed in the level 3 option 
DPIOMMKY to access the manager's functions in C/S mode.

Store Entry Key
Enter the key that user's must have to enter this store. Users without this key will not be able to 
enter this store. If the key is left blank then ALL users will have access to this store.

Store PO Key
Enter the key that user's must have to order products with a purchase order. User's without this 
key will not be able to use purchase orders to pay for orders. In most circumstances you will NOT 
want to allow orders via PO!

Store BITMAP
Enter the BMP file name that will be used in C/S mode to represent this store. After you save the 
store settings you will be prompted to upload the BMP file.

Allow Fax
Set to YES to allow faxing of invoices to the store manager. This feature also requires the 
Fax/Online module be installed and a valid fax number be entered by the store manager. This field 
simply allows the Sysop to turn this feature on/off within each store (you may not want to allow 
faxing of invoices if the store manager's fax machine is a long distance call).

Allow POS
Set to YES to allow online credit card processing. If set to yes then the POS Dial configuration 
editor options have to be filled out for this store. See Appendix A for POS Dial configuration.

Exit
Choose S to Save or Q to Quit when done adding/editing this store. You can also type ^G to save 
the settings, or ^O to quit.

Sysop Menu (C/S Mode)
To access the Store Editor choose Store Add/Edit/Create from the Sysop pull-down menu, (Figure 
1). When adding or editing a store in C/S mode the following screen will display:

 
Figure 1. Sysop's Store Editor
Store Code
Choose the store you wish to edit or delete from the pull-down menu. If you are adding a new 
store simply type in the new store's code in this field. The store code is an 8 character field that 
can contain any valid DOS file name. Omni-Mall will also create a subdirectory on the server's 
hard drive named after this code. This subdirectory is for storing any image, product, or abstract 
files.

Store Title
The store title is a one line (80 character) field describing this store.

Description
The description is a four line (65 characters/line) describing this store in greater detail.

Store Manager
Enter the User-ID of the store manager. The store manager can add/edit/delete departments and 
products from this store. This User-ID must also have the key listed in the level 3 option 
DPIOMMKY to access the manager's functions in C/S mode. You can type the User-ID directly in 
this field, or use the Find button to search for the User-ID.

Store Entry Key
Enter the key that user's must have to enter this store. Users without this key will not be able to 
enter this store. If the key is left blank then ALL users will have access to this store.

Store PO Key
Enter the key that user's must have to order products with a purchase order. User's without this 
key will not be able to use purchase orders to pay for orders. In most circumstances you will NOT 
want to allow orders via PO!

Store BITMAP
Enter the BMP file name that will be used in C/S mode to represent this store. After you save the 
store settings you will be prompted to upload the BMP file.

Allow Fax
Set the checkbox ON to allow faxing of invoices to the store manager. This feature also requires 
the Fax/Online module be installed and a valid fax number be entered by the store manager. This 
field simply allows the Sysop to turn this feature on/off within each store (you may not want to 
allow faxing of invoices if the store manager's fax machine is a long distance call).

Allow POS
Set the checkbox YES to allow online credit card processing. If set to yes then the POS Dial 
configuration editor options have to be filled out for this store. To access the POS options for this 
store click on the Edit POS button. This button is not enabled unless you have the POS Dial 
module installed. See Appendix A for POS Dial configuration.

Insert Button
Click on this button to save a new store once all of the information is correct. This button is only 
available when adding a new store, otherwise use the Update button to save updated information 
about the store.

Delete Button
Click on this button to delete the currently selected store. This option will not work UNTIL you've 
deleted all of the products in this store.

Print Button
Click on this button to print the information displayed on this screen.

Close Button
Click on this button to close this screen.

Edit POS Button
Click on this button to configure the POS Dial module to process credit card transactions for the 
currently selected store.

Bad Credit Cards
This section is more important if you are NOT using the POS Dial Module to authorize credit card 
purchases instantly. While it is certainly possible that a freshly stolen credit card can be used with 
the POS Dial Module it is less likely to be approved.

You WILL eventually have a user try to pass a stolen credit card on your system. These users will 
usually stand out by placing large orders. We suggest you contact your credit card clearing agent 
to make sure you don't run a stolen credit card. Your credit card processing company can tell you 
the procedure when dealing with suspicious transactions.

The Sysop Menu has an option to allow you to enter bad card numbers that you don't wish to 
accept under any circumstances. This includes stolen credit cards, as well as trouble users that 
continually run over the limit cards. We don't suggest you put every card in when declined. Credit 
cards are declined for many reasons, and the bank may decline one mistakenly.

MANAGER'S FUNCTIONS
Manager's Menu (Terminal Mode)
Store Managers handle the majority of the setting up and running of individual stores. Store 
Managers can access the manager functions from both terminal mode and C/S mode. There are 
three main functions for store managers: editing the store information, adding/editing/deleting 
departments, and adding/editing/deleting products. Store Managers can enter the Manager's Menu 
by choosing option M from the Browse Menu when the current store is one that they manage. 
Sysop level users always have access to the Manager's Menu. The following menu will be 
displayed:

Omni-Mall Manager menu:

   S ... Edit store options
   D ... Edit department options
   I ... Invoice questionnaire
   H ... Shipping functions
   T ... Tax table
   O ... Order review
   M ... Manual transaction
   P ... Product editor
   F ... Product format editor

   ? ... Help
   X ... Exit to previous menu

Select an option:

S	Edit store options
This option allows you to access the store editor to edit options such as company name, address, 
fax number, payment options, and tax rates. See the section on Editing Store Settings for more 
information about this option.

D	Edit department options
This option allows you to access the department editor to add, edit, and delete departments 
within this store.

I	Invoice questionnaire
This option allows you to access the invoice questionnaire editor to add, edit, and delete 
questions. These questions will be asked when an order is placed and included on the invoice sent 
to the department manager. The invoice questions can be used to gain additional information from 
the purchaser that may be needed to complete the order.

H	Shipping functions
This option allows you to edit the shipping table for this store.

T	Tax table
This option allows you to edit the tax table for this store.

O	Order review
This option allows you to view previous orders placed in this store. Orders can be searched by 
invoice number and date range.

M	Manual transaction
This option allows you to enter a manual credit card transaction.

P	Product editor
This option allows you to access the product editor to add, edit, and delete products. See the 
section on product editing for more information about this option.

F	Product format editor
This option allows you to access the product format editor to add, edit, and delete products. See 
the section on product editing for more information about this option.

Store Editor (Terminal Mode)
Omni-Mall Store Information Editor
   Store Code: TEST

   Company name:
        Address:
    City/St/Zip:
        Country:
    Voice Phone: 
      Fax Phone:

     Payment Options     Allow Downloads     Primary Tax Method
           Visa: NO            Visa: NO    First Tax Rate: NONE
     MasterCard: NO      MasterCard: NO   Second Tax Rate: NONE
       Discover: NO        Discover: NO
           Amex: NO            Amex: NO    Apply First tax
    Other Cards: NO     Other Cards: NO          Subtotal: NO
       Pre-Paid: NO        Pre-Paid: NO
 Purchase Order: NO  Purchase Order: NO         Misc Options
       COD Cash: NO        COD Cash: NO    Purchase Limit: 0.00
      COD Check: NO       COD Check: NO    Weight Measure:
        Credits: NO         Credits: NO

               Exit:       (select (S)ave or (Q)uit and hit enter)

Store Code
The store code assigned to this store by the Sysop when the department was created. The store 
code may NOT be changed.

Company name
Enter the company name for this store.

Address
Enter the address for this store.

City/St/Zip
Enter the City, State or Province, and Postal Code for this store.

Country
Enter the country for this store.

Voice Phone
Enter the voice telephone number for this store including area code.

Fax Phone
Enter the fax telephone number for this store including area code. If the Fax/Online support is 
enabled this is the telephone number of the fax machine receiving fax invoices.

Payment Options
Toggle each payment option available for this store to YES or NO.

Allow Downloads
This toggle is a little more complex. Omni-Mall allows you to sell files as products and this option 
allows you to specify which payment methods will allow the file to be attached to the purchaser 
in E-mail. This option does NOT have any affect on image files or abstract files attached to a 
product. For example, if you wanted to sell a file called CLIPART.PCX you would specify which 
payment options allow the purchaser to receive the file in E-mail. If Visa is toggled to YES then 
purchases made with a Visa credit card would have the file attached to them in E-mail. This option 
protects you from delivering the product (CLIPART.PCX) until actual payment is received.

If you have the POS Dial module installed then the file will be attached to the user AFTER the 
credit card transaction is approved. If you don't have the POS Dial module installed then the file 
will be attached without waiting for approval.

Primary Tax Method
Omni-Mall allows you to charge sales tax on purchases. Omni-Mall needs to know whether to 
charge no sales tax (NONE) or to charge sales tax based on CITY, STATE, ZIP code, and 
COUNTRY. There are two tax rates for jurisdictions (such as Canada) that have a local tax as well 
as a national tax. Omni-Mall adds tax to sales based on the address information entered by the 
caller. The actual tax rates charged are configured in the tax table editor. Tax charges are NOT 
applied to shipping or handling charges. Consult your tax advisor for information on charging and 
collecting sales tax.

Apply First Tax Subtotal
Set to YES to apply the second tax rate to the subtotal of the total purchases plus the first tax 
rate. Set to NO to apply the second tax rate to the amount of the purchases only. This option 
would normally be set to YES in some provinces in Canada and some European countries that 
charge a local tax and add a national tax on top of that. Consult your tax advisor for information 
on charging and collecting sales tax.

Misc Options
Set the purchase limit for this store (on a daily basis) as well as the name of the units of measure 
for weight (pounds, grams, kilos, etc.).

Exit
Choose S to Save or Q to Quit when done adding/editing this store. You can also type ^G to save 
the settings, or ^O to quit.

Store Editor (C/S Mode)
The Store Manager can access the Store Editor from the Manager's Pull-Down menu. The store 
editor allows the Store Manager to edit the store settings. Each tab contains different options for 
the store. Be sure and edit each tab to complete the store configuration.

Store Information
The Store Information tab allows you to edit the purchase and contact information of this store. 
See Figure 2.

 
Figure 2. Manager's Store Editor (Store Information)

Choose a store from the list
Select the store code assigned to this store by the Sysop when the department was created. You 
may select a different store from the pull-down menu if you are managing more than one store or 
if you have sysop level access.

Purchase Limit
Set the purchase limit for this store. Enter 0.00 to allow unlimited purchases. This limit is applied 
to purchases made within this store between system cleanups. For example, if this option was set 
to 200.00 then any purchases made over $200.00 on one day would be declined. This option 
provides a mild form of protection against fraudulent purchases.

Product Weight Measure
Enter the unit of measurement for weight (pounds, grams, kilos, etc.).

Payment Options
Toggle each payment option available for this store to YES or NO. Some payment options may 
NOT be available if the Sysop has not configured them to be accepted.

Allow Downloads
This toggle is a little more complex. Omni-Mall allows you to sell files as products and this option 
allows you to specify which payment methods will allow the file to be attached to the purchaser 
in E-mail. This option does NOT have any affect on image files or abstract files attached to a 
product. For example, if you wanted to sell a file called CLIPART.PCX you would specify which 
payment options allow the purchaser to receive the file in E-mail. If Visa is toggled to YES then 
purchases made with a Visa credit card would have the file attached to them in E-mail. This option 
protects you from delivering the product (CLIPART.PCX) until actual payment is received.

If you have the POS Dial module installed then the file will be attached to the user AFTER the 
credit card transaction is approved. If you don't have the POS Dial module installed then the file 
will be attached without waiting for approval.

Company name
Enter the company name for this store.

Address
Enter the address for this store.

City/St/Zip
Enter the City, State or Province, and Postal Code for this store.

Country
Enter the country for this store.

Voice Phone
Enter the voice telephone number for this store including area code.

Fax Phone
Enter the fax telephone number for this store including area code. If the Fax/Online support is 
enabled this is the telephone number of the fax machine receiving fax invoices.

Save Button
Click on the Save button to save the information contained on each tab.

Close Button
Click on the Close button to exit the store editing functions. Be sure to click the Save button 
before clicking on Close if you've made any changes to the store.

Tax Options
The Tax Options tab allows you to configure how to apply sales tax charges to purchases made in 
this store. See Figure 3.

 
Figure 3. Store Editor (Tax Options)
First Tax Rate
Omni-Mall allows you to charge sales tax on purchases. Omni-Mall needs to know whether to 
charge no sales tax (NONE) or to charge sales tax based on CITY, STATE, ZIP code, and 
COUNTRY.

Second Tax Rate
There are two tax rates for jurisdictions (such as Canada) that have a local tax as well as a 
national tax. Omni-Mall needs to know whether to charge no sales tax (NONE) or to charge sales 
tax based on CITY, STATE, ZIP code, and COUNTRY.

Omni-Mall adds tax to sales based on the address information entered by the caller. The actual tax 
rates charged are configured on the tax table tab. Consult your tax advisor for information on 
charging and collecting sales tax. Sales tax is NOT applied to shipping and handling charges.

Tax Table
The tax table tab allows you to configure the sales tax charges on purchases made in this store. 
See Figure 4.

 
Figure 4. Store Editor (Tax Table)

This screen has two text boxes. The top text box shows you the current tax table. No tax table 
will display until the Get Table button is clicked. The bottom text boxes are used to input new 
taxes. Omni-Mall allows you to set up different tax rates based on the geographical information 
provided by the purchaser.

Location
Enter the State, Province, County, ZIP Code, Postal Code, or Country that this tax rate will apply 
to. Omni-Mall can charge sales tax based on any one of these fields. In addition, the user will be 
charged all taxes that apply so if you have a state tax and a country tax the user will be charged 
both if they apply.

Tax Rate
Enter the tax rate that applies to this location. Enter the tax rate WITHOUT dividing by 100. If the 
sales tax is 5.5% then enter 5.5 in this field. Do not include the "%" character.

Add Button
Click the add button to add the new tax to the tax table. You must first enter the new tax in the 
lower text box to enable the add button.

Update Button
Click the update button to change an existing tax rate. You must first enter the changed 
information in the lower text box to enable the update button.

Delete Button
Click the delete button to delete the currently selected tax rate.

Get Table
Click the get table button to load the tax table for this store. This is normally the FIRST step when 
editing the tax table.

Save Table
Click the save table button to save the currently loaded tax table. If you close the Store Editor 
before saving the table then any changes or additions to the shipping table will be lost.

Invoice Questions
The Invoice Questions tab allows you to configure invoice questions. These questions will be 
asked when an order is placed and the answers will be included on the invoice sent to the 
department manager. The invoice questions can be used to gain additional information from the 
purchaser that may be needed to complete the order. See Figure 5.

 
Figure 5. Store Editor (Invoice Questions)

Question 1-4
Enter the questions you want purchasers to answer when buying items in this store.

Shipping Table
The Shipping Table tab allows you to enter the shipping methods and charges available for items 
purchased in this store. You must enter at least one shipping method! See Figure 6.

 
Figure 6. Store Editor (Shipping Table)

This screen has two text boxes. The top text box shows you the currently available shipping 
methods. No shipping methods will be available until the Get Table button is clicked. The bottom 
text box is used to input new shipping methods.

Shipping Method
The name of the shipping method. For example: UPS Red (Next Day).

Price 1st Pound
Enter the price for the first pound when this shipping method is used.

Each Add't Pounds
Enter the price for each additional pound over 1 for this shipping method.

Handling Y/N
Set to YES to add handling charges when this shipping method is selected. Set to NO to not add 
handling charges to the price of shipping. Each product may or may not have a handling charge 
that you may or may not want to add to the price when this shipping method is selected.

Add Button
Click the add button to add new shipping methods to the shipping table. You must first enter the 
new shipping method in the lower text box to enable the add button.

Update Button
Click the update button to change an existing shipping method. You must first enter the changed 
information in the lower text box to enable the update button.


Delete Button
Click the delete button to delete the currently selected shipping method.

Get Table
Click the get table button to load the shipping table for this store. This is normally the FIRST step 
when editing the shipping table.

Save Table
Click the save table button to save the currently loaded shipping table. If you close the Store 
Editor before saving the table then any changes or additions to the shipping table will be lost.

Store Browser Bitmap
The store browser bitmap tab allows you to add a small graphic representing your store to the 
Omni-Mall store selection menu. The graphic image must be in BMP mode and should be 64 pixels 
wide by 32 pixels high. Click on the upload button to upload a new BMP file for this store. See 
Figure 7.

 
Figure 7. Store Editor (Store Browser Bitmap)

Department Editor (C/S Mode)
The Store Manager can access the department editor by selecting Department Editor from the 
Manager's pull-down menu.

 
Figure 8. Department Editor

Current Store
Select the store from the drop down menu. This option only applies if you manage more than one 
store or if you have sysop level access.

Department Code
Enter a new department code if you are adding a new department to this store, or choose the 
department you wish to edit from the drop down menu. The department code is an 8 character 
field that can contain any valid DOS file name. Omni-Mall will also create a subdirectory on the 
server's hard drive named after this code. This code is required so Omni-Mall can create this 
subdirectory for storing any image, product, or abstract files. This subdirectory will be created 
below the Store Code subdirectory.

Department Title
The department title is a one line (80 character) field describing this department.

Department Description
The description is four lines (65 characters/line) describing this department in greater detail.

Browse Only
If the browse only checkbox is set to ON then this department will operate in browse mode. 
Browse mode is used for departments where information is displayed but orders aren't accepted. 
This mode is used to advertise a product that can't be easily ordered online. For example, a car 
dealer may want to place descriptions of the models available in Omni-Mall but wouldn't want to 
accept orders online.

Leave the checkbox blank to operate this department in the traditional shopping mall sense, 
offering merchandise for sale and accepting orders.

Product Formats
Select up to two default product formats for this department.

Department Images & Bitmaps
The department Images & Bitmaps tab allows you to add/edit/delete images displayed on the 
Omni-Mall department selection menu. These images are only displayed in C/S mode.

Department Editor (Terminal Mode)

Department editing menu:

   A ... Add a new department
   D ... Delete a department
   E ... Edit a department

   ? ... Help
   X ... Exit to previous menu

Select an option:

A	Add a new department
Select this option to add a new department to this store. The Omni-Mall department editor will 
display.

D	Delete a department
Select this option to delete an existing department. This option will not work until all products 
have been deleted from the department.

E	Edit a department
Select this option to edit an existing department in this store. The Omni-Mall department editor 
will display.



Omni-Mall Department Editor

                               Store Code: TEST

                          Department Code:

                              Department Title


                           Department Description




               Browse Only: NO

               Product Formats
        Default 1st Format:
        Default 2nd Format:

               Exit:       (select (S)ave or (Q)uit and hit enter)

Store Code
The store code assigned to this store by the Sysop when the department was created. The store 
code may NOT be changed.

Department Code
The department code is an 8 character field that can contain any valid DOS file name. Omni-Mall 
will also create a subdirectory on the server's hard drive named after this code. This code is 
required so Omni-Mall can create this subdirectory for storing any image, product, or abstract 
files. This subdirectory will be created below the Store Code subdirectory.

Department Title
The department title is a one line (80 character) field describing this department.

Department Description
The description is four lines (65 characters/line) describing this department in greater detail.

Browse Only
If set to YES this department will operate in browse mode. Browse mode is used for departments 
where information is displayed but orders aren't accepted. This mode is used to advertise a 
product that can't be easily ordered online. For example, a car dealer may want to place 
descriptions of the models available but wouldn't want to accept orders online.

Set to NO to operate this department in the traditional shopping mall sense, offering merchandise 
for sale and accepting orders.

Product Formats
Enter up to two default product formats for this department.

Exit
Choose S to Save or Q to Quit when done adding/editing this store. You can also type ^G to save 
the settings, or ^O to quit.


Product Editor (Terminal Mode)
The store manager can access the product menu by choosing option P from the Manager's menu. 
The following menu will display:

Product editing menu:

   A ... Add a new product
   D ... Delete a product
   E ... Edit a product

   ? ... Help
   X ... Exit to previous menu

Select an option:

A	Add a new product
This option displays the product editor to add a new product to this department.

D	Delete a product
This option allows you to delete an existing product from this department.

E	Edit a product
This option displays the product editor to edit an existing product.

Omni-Mall Product Editor
                       Product Code:
                               Product Title

                            Product Description





         Wholesale Key:                    Wholesale Price: 0.00
        Tax Exempt Key:                       Retail Price: 0.00
       Product Taxable: NO                    Handling 1st: 0.00
        Product Weight: 0.0000                 Handling 2+: 0.00

      Volume Discounts
   [Min]     [Max]     [%]
 0         0         0.00        Primary Format:              # of Images: 0
 0         0         0.00      Secondary Format:            Abstract File: NO
 0         0         0.00     Inventory Product: NO            Sound File: NO
 0         0         0.00      Show 0 Inventory: NO          Product file: NO
 0         0         0.00       Inventory Quant: 0         Waive Shipping: NO

               Exit:       (select (S)ave or (Q)uit and hit enter)

Product Code
The product code Is a 15 character field. The product code can be a short identifier for the 
product, or it may be a product number.

Product Title
The product title is a one line (80 character) field describing this product.

Product Description
The description is four lines (65 characters/line) describing this product in greater detail.

Wholesale Key
Enter the key required for user's to view or purchase items at the wholesale price. This allows you 
to have two levels of pricing for the same product, designated by key.

Wholesale Price
Enter the wholesale price (if any) for this product.

Tax Exempt Key
Users with this key will NOT be charged tax when purchasing this product.

Retail Price
Enter the retail price for this product.

Product Taxable
Set to YES to apply tax charges to this product. Set to NO to not charge tax on sales of this 
product. Of course, if the tax rate is 0% then no sales tax will be charged anyway.

Handling 1st
Enter the handling charge for the quantity 1 purchase of this product. This handling charge will be 
added to the product price if the shipping method chosen for the purchase has the handling Y/N 
option set to Y.

Handling 2+
Enter the handling charge added to each additional quantity of this product purchased. This 
handling charge will be added to the price if the shipping method chosen for the purchase has the 
handling Y/N option set to Y.

Product Weight
Enter the product's weight for shipping purposes. This value is used to determine the appropriate 
shipping price.

Volume Discounts
	Min	Enter the minimum quantity required to obtain this discount
	Max	Enter the maximum quantity that this discount will apply to.
	%	Enter the discount percentage for quantities within the Min and Max range.

Primary Format
Select the primary product format (if any) that applies to this product. The selection can be 
toggled with the <space> bar.

Secondary Format
Select the secondary product format (if any) that applies to this product. The selection can be 
toggled with the <space> bar.

# of Images
Enter the number of image files that will be attached to this product. Omni-Mall allows you to 
attach for 0 to 3 images per product. When you save the product you will be prompted to upload 
the images (if any).

Abstract File
Set to yes if you want to attach a longer ASCII description to this product. When you save the 
product you will be prompted to upload the abstract file (if any). The abstract file MUST be an 
ASCII text file. Note: Abstract files are not keyword searchable.

Inventory Product
Set to YES to allow inventory tracking of this product. Set to NO to allow unlimited purchases of 
this product.

Show 0 Inventory
Set to NO if you don't want Omni-Mall to allow purchases of this product when the inventory 
reaches 0. Set to YES if you still want to allow purchases of this product regardless of the 
quantity available in inventory.

Inventory Quantity
Set the quantity of this product available in your inventory.

Sound File
Set to YES if you want to attach a sound file to this product. When you save the product you will 
be prompted to upload the sound file (if any). The sound file MUST be a WAV file.

Product File
Omni-Mall allows you to sell files as products, so set this option to YES if this product is actually a 
computer file. When you save the product you will be prompted to upload the product file (if any). 
The product file can be any format of computer file. When a user purchases a product that is 
actually a file they will be able to download it from E-mail (assuming the payment option used 
allows downloading of the product). Set this option to NO if this product is not a computer file.

Waive Shipping
Set this option to YES if you don't want to add shipping charges to this product. Set to NO to 
allows shipping charges on this product.

Exit
Choose S to Save or Q to Quit when done adding/editing this store. You can also type ^G to save 
the settings, or ^O to quit.

Product Editor (C/S Mode)
The store manager can access the product manager by choosing Product Options from the 
Manager's pull down menu, then selecting Product Manager. See Figure 9.

 
Figure 9. Product Manager

Store Code
Select a new store from the drop down menu to edit products in other stores that you manage.

Department Code
Select a new department from the drop down menu to edit products in other departments.

Add Button
Click on the add button to access the product editor window to add new products to this 
department.

Edit Button
Click on the edit button to access the product editor windows to edit the currently selected 
product.

Delete Button
Click on the delete button to delete the currently selected product.

Close Button
Click on the close button to close the product manager window.

Product Editor (Description)

 
Figure 10. Product Editor (Description)
Product Code
The product code Is a 15 character field. The product code can be a short identifier for the 
product, or it may be a product number.

Product Title
The product title is a one line (80 character) field describing this product.

Product Description
The description is four lines (65 characters/line) describing this product in greater detail.

Handling Charge 1st Item
Enter the handling charge for the quantity 1 purchase of this product. This handling charge will be 
added to the product price if the shipping method chosen for the purchase has the handling Y/N 
option set to Y.

Handling Charge 2+ Items
Enter the handling charge added to each additional quantity of this product purchased. This 
handling charge will be added to the price if the shipping method chosen for the purchase has the 
handling Y/N option set to Y.

Product Weight
Enter the product's weight for shipping purposes. This value is used to determine the appropriate 
shipping price.

Waive Shipping
Set this checkbox ON if you don't want to add shipping charges to this product. Set to OFF to 
allow shipping charges on this product.

Inventory Product
Set this checkbox to ON to allow inventory tracking of this product. Set to OFF to allow unlimited 
purchases of this product.

Quantity in Inventory
Set the quantity of this product available in your inventory.

Display products if none in Inventory
Set this checkbox to OFF if you don't want Omni-Mall to allow purchases of this product when 
the inventory reaches 0. Set to ON if you still want to allow purchases of this product regardless 
of the quantity available in inventory.

Product Editor (Pricing)

 
Figure 11. Product Editor (Pricing)

Retail Price
Enter the retail price for this product.

Allow Wholesale
Set this checkbox to ON to allow a wholesale and retail price. When checked ON two additional 
fields for wholesale key and wholesale price will be enabled.

Wholesale Key
Enter the key required for user's to purchase items at the wholesale price. This allows you to have 
two levels of pricing for the same product, designated by key.

Wholesale Price
Enter the wholesale price (if any) for this product.

Product Taxable
Set this checkbox to ON to apply tax charges to this product. Set to NO to not charge tax on 
sales of this product. Of course, if the tax rate is 0% then no sales tax will be charged anyway.

Tax Exempt Purchases
Set this checkbox to ON if you do NOT want taxes applied to purchases of this product.

Tax Exempt Key
Users with this key will NOT be charged tax when purchasing this product.

Volume Discounts
	Min	Enter the minimum quantity required to obtain this discount
	Max	Enter the maximum quantity that this discount will apply to.
	%	Enter the discount percentage for quantities within the Min and Max range.

Product Editor (Product Formats)
 
Figure 12. Product Editor (Product Formats)

Product Format 1
Select the primary product format (if any) that applies to this product. The selection can be made 
from the drop down menu.

Product Format 2
Select the secondary product format (if any) that applies to this product. The selection can be 
made from the drop down menu.

In addition, select the styles associated with this product that you wish to enable.

Product Editor (Product Files)

 
Figure 13. Product Editor (Product Files)


# of Images
Select the number of image files that will be attached to this product. Omni-Mall allows you to 
attach from 0 to 3 images per product.

Product File
Omni-Mall allows you to sell files as products, so enter the name of the file (or click the upload 
button to upload it) if this product is actually a computer file. The product file can be any format 
of computer file. When a user purchases a product that is actually a file they will be able to 
download it from E-mail (assuming the payment option used allows downloading of the product). 
Leave this option <blank> if this product is not a computer file.

Sound File
Enter the name of the WAV file (or click the upload button to upload it) you wish to attach to this 
product. This sound file MUST be a WAV file.

Abstract File
Enter the name of the ASCII text file (or click the upload button to upload it) to use as the abstract 
file for this product. The abstract file is a text file containing additional information about the 
product. This abstract file MUST be an ASCII text file.

Image File #
Enter the name of the image file (or click the upload button to upload it) to attach to this product. 
Omni-Mall allows you to attach up to three image files per product.

Upload Buttons
Click on the appropriate upload button to upload the file from your computer to the Worldgroup 
server. Omni-Mall allows you to reference a file already residing on the server's hard drive (if you 
have the required security), or you can upload the file by clicking on the appropriate upload button. 
After clicking on the upload button you will be prompted for the file to transfer from your 
computer to the Worldgroup server.

Product Formats
Omni-Mall allows you to define product formats for the products you sell. Each product format can 
be further refined by styles. This feature allows the customer to more accurately specify the 
product they want to order. Product formats are optional, many products don't have formats (like 
one of a kind items).

For example, lets assume you wish to sell T-shirts through Omni-Mall. Let's also assume that each 
T-shirt design you sell comes in 4 sizes and 4 colors, but the price is the same regardless of the 
size or color. The product format feature in Omni-Mall allows you to enter one product and the 
customer can specify the size and color when they place their order. In this example we'll have 2 
formats with 4 styles each.

Format 1: Size
	Style 1:	Small
	Style 2:	Medium
	Style 3:	Large
	Style 4:	X-Large

Format 2: Color
	Style 1:	White
	Style 2:	Blue
	Style 3:	Red
	Style 4:	Black

	

Product Format Editor (Terminal Mode)
Omni-Mall Product Format Editor

                   Store code
                    TEST
                 Product format

     Style 1:             Style 2:
     Style 3:             Style 4:
     Style 5:             Style 6:

               Exit:       (select (S)ave or (Q)uit and hit enter)

Store Code
The store code assigned to this store by the Sysop when the department was created.

Product Format
Enter the name of this product format (10 characters).

Styles 1-6
Enter the name of this style (10 characters).

Exit
Choose S to Save or Q to Quit when done adding/editing this store. You can also type ^G to save 
the settings, or ^O to quit.

Product Format Editor (C/S Mode)

 
Figure 14. Product Format Editor

Store Code
The store code assigned to this store by the Sysop when the department was created. Select a 
new store from the pull down menu.

Available Formats
Select a product format to edit from the pull down menu. If you are adding a new product format 
then enter the name of the new product format (10 characters) in this field.

Styles 1-6
Enter the name of each style (10 characters).

Save Button
Click on the save button to save the current product format.

Delete Button
Click on the delete button to delete the current product format.

Close Button
Click on the close button to close the Product Format Editor window.

Importing/Exporting
Omni-Mall allows you to import products via ASCII comma/quote delimited files or Microsoft 
DataBase v1.1 (.MDB) files. Omni-Mall can also export products in both formats. Note: The 
Microsoft DataBase format is v1.1, NOT v2.0. You can use Microsoft Access to access Microsoft 
DataBase formatted files. Importing/Exporting of product databases is ONLY support in C/S mode. 
There is NO terminal mode support for importing/exporting.

There is a sample ASCII import file in your BBS's subdirectory called DPISAMP.TXT.
Importing Products
 
Figure 15. Import data display

Log results to file
Set this checkbox to ON if you want the results of the import to be logged to a file on the client 
machine. Set to OFF if you don't want the results logged.

Log Filename
Enter the filename to log the results to. This option is only available if the Log results checkbox is 
set to ON.

Import Data Button
Click on the Imort Data Button to upload a MDB file to the Worldgroup server for importing.

Import Text Button
Click on the Import Text Button to uplad an ASCII comma/quote delimited file to the Worldgroup 
server for importing.

Abort Import Button
Click on the Abort Import button to stop an import once it's started. This option is only available 
when a product file is being imported.

Close Button
Click the Close button to close the Import Data window.

Exporting Products
 
Figure 16. Export data display
Store List
Choose the store to export data from the pull down menu.

Department List
Choose the department to export data from the pull down menu.

Export Dbase Button
Click the Export Dbase button to download a MDB file containing the product information from the 
selected store/department.

Export Text Button
Click the Export Text button to download an ASCII delemited file containing the product 
information from the selected store/department.

Abort Export Button
Click on the Abort Export button to stop exporting once it's started. This option is only available 
when a product file is being exported.

Create Dbase Button
Click the Create Dbase button to create an empty MDB file for the selected store/department. This 
option is helpful to create an empty data file that you can use to add products to for later 
importing.

Close Button
Click the Close button to close the Export Data window.

Import File Specification

Field Name
Field Type
Field length
Field Description
store
String
8123
Store code
dept
String
8123
Department code
prdcode
String
1512
Product code
prdtitle
String
791
Product title
prddesc
String
2391
Product long description
prdflags
Integer
2
Product flags - See description of product flags 
retprice
Single
4
Retail price
wholeprice
Single
4
Wholesale price
wholekey
String
1512
Wholesale price key
taxexmptkey
String
1512
Tax Exempt Key
handle1
Single
4
Handling charge for first item
handle2
Single
4
Handling charge for more than 1 item
numimg
Integer
2
Number of images - min = 0, max = 3
prdfn
String
80124
Product filename
image1
String
80124
First image filename
image2
String
80124
Second image filename
image3
String
80124
Third image filename
absfn
String
80124
Abstract filename - usually a text file with more detail
soundfn
String
80124
Sound filename - only .WAV files
invquant
Long
4
Inventory quantity
pformat
String
1012
Primary product format
volrange00
Long
4
Minimum quantity for voldisc0
volrange01
Long
4
Maximum quantity for voldisc0
volrange10
Long
4
Minimum quantity for voldisc1
volrange11
Long
4
Maximum quantity for voldisc1
volrange20
Long
4
Minimum quantity for voldisc2
volrange21
Long
4
Maximum quantity for voldisc3
volrange30
Long
4
Minimum quantity for voldisc3
volrange31
Long
4
Maximum quantity for voldisc3
volrange40
Long
4
Minimum quantity for voldisc4
volrange41
Long
4
Maximum quantity for voldisc4
voldisc0
Single
4
First volume range discount percentage ex; 1.25
voldisc1
Single
4
Second volume range discount percentage
voldisc2
Single
4
Third volume range discount percentage
voldisc3
Single
4
Fourth volume range discount percentage
voldisc4
Single
4
Fifth volume range discount percentage
pformat2
String
1012
Secondary product format
weight
Single
4
Product weight in store units of measure
ref_flags
Integer
2
Product reference flags - See description of product 
reference flags
pfmtflags
Integer
2
Product format flags - See description of product format 
flags
dbflags
Integer
2
Action flag - 0 = Do nothing, 1 = Add/Update, 2 = Delete

Notes:
String fields should not be padded with leading or trailing spaces.
Indicates that this field must be all upper case.
Must use valid directory characters ex; A-Z, 0-9, _, ^, $, ~, !, #, %, &, -, {}, ().
Must use valid filename characters ex; A-Z, 0-9, _, ^, $, ~, !, #, %, &, -, {}, (), @, `, `.

Product Flags
Instead of using many Boolean database fields to specify special attributes associated with a product, 
this value contains the sum of all the "flags" relevant to this product. Listed below are the flags, their 
value, and their meaning.
	
Attribute
Value
Description
TAXABLE
1
This product is taxable based upon store tax definition and tax tables
TAXEXEMPT
2
This product has the ability to be tax exempt if user has the tax exempt key
WHOLESALE
4
This product has wholesale price ability if user has the wholesale key
INVENTORY
8
This product has a finite inventory quantity
DISPNOINV
16
If inventory is depleted continue to display this product
NOFORMAT
32
This product has no product formats associated with it
SHIPPING
64
This product does not have any shipping charges associated with it

In order to establish a value for this option simply choose the attributes you desire this product to have 
and add them up. For example if you wanted the product to be TAXABLE, maintain INVENTORY, and 
allow for back-orders DISPNOINV you would have the following value;

VALUE = TAXABLE (1) + INVENTORY (8) + DISPNOINV (16) = 25

Thus, you would use the value of 25 for the value of product flags for this product.

Product Reference Flags
Product reference flags work in the same manner as the product flags. The purpose for the product 
reference flags is to indicate that a file does not exist in a place Omni-Mall will expect it. The reason for 
this is to allow for a filename to be "referenced" somewhere else on the computers hard drive (or 
network). Listed below are the product reference flags, their values, and their meaning.

Attribute
Value
Description
PRDFN_REF
1
Indicates that the product filename is referenced elsewhere
IMAGE1_REF
2
Indicates that the first image filename is referenced elsewhere
IMAGE2_REF
4
Indicates that the second image filename is referenced elsewhere
IMAGE3_REF
8
Indicates that the third image filename is referenced elsewhere
ABSFN_REF
16
Indicates that the abstract filename is referenced elsewhere
SOUND_REF
32
Indicates that the sound filename is referenced elsewhere

In order to establish a value for the product reference flags simply choose the attributes you desire this 
product to have and add them up. For example if you wanted the product's sound filename to be 
referenced elsewhere (SOUND_REF) you would have the following value;

VALUE = SOUND_REF (32) = 32

Thus, you would use the value 32 for the product reference flags. This would provide you the ability to 
specify, for example, that the product's sound filename is located on C:\WINDOWS\PRODUCT.WAV.

Product Format Flags
Product format flags also work like the previously mentioned flags in the way that they are established. 
This flag only provides meaning if the option NOFORMAT in the product flags is NOT used. This flag 
contains options as to which product formats will be available to a specific product. Listed below are the 
product format flags, their values, and their meaning.

Attribute
Value
Description
UFORMAT1A
1
Use primary product format option A
UFORMAT1B
2
Use primary product format option B
UFORMAT1C
4
Use primary product format option C
UFORMAT1D
8
Use primary product format option D
UFORMAT1E
16
Use primary product format option E
UFORMAT1F
32
Use primary product format option F
UFORMAT2A
256
Use secondary product format option A
UFORMAT2B
512
Use secondary product format option B
UFORMAT2C
1024
Use secondary product format option C
UFORMAT2D
2048
Use secondary product format option D
UFORMAT2E
4096
Use secondary product format option E
UFORMAT2F
8192
Use secondary product format option F

Product formats can be a little difficult to understand. For this reason we provide an example that should 
help alleviate any problems. Consider a merchant selling a shirt. The merchant has the shirt in different 
sizes and colors. First the merchant would setup Omni-Mall with two product formats, sizes and colors. 
The sizes product format would contain these values; small, medium, large, x-large, xx-large, and xxx-
large. The second product format, colors, could contain; red, green, blue, orange, black, and white. Now, 
lets assume that the merchant has this shirt in only small and large and the colors red and white. Listed 
below is how the merchant would establish a value for the product format flags.

Format "size"
Attribute
Selected
Format "colors"
Attribute
Selected
small
UFORMAT1A

red
UFROMAT2A

medium
UFORMAT1B

green
UFROMAT2B

large
UFORMAT1C

blue
UFROMAT2C

x-large
UFORMAT1D

orange
UFROMAT2D

xx-large
UFORMAT1E

black
UFROMAT2E

xxx-large
UFORMAT1F

white
UFROMAT2F


From the table above we can now create a value for our product format flags.

Value = UFORMAT1A (1) + UFORMAT1C (4) + UFORMAT2A (256) + UFORMAT2F (8192)

Thus, you would use the value 1 + 4 + 256 + 8192 = 8453 for the product format flags.


Appendix A - POS Dial Configuration
Omni-Mall can process credit card transactions online when used with the POS Dial Module. In 
addition, each individual store within Omni-Mall can be set up to process credit card transactions 
using the same merchant account, different merchant accounts, or no merchant account at all.

The first step to enabling online credit card transactions is to install the POS Dial Module 
according to the POS Dial installation instructions. The second step is to configure each store 
within Omni-Mall to pass transactions to POS Dial. Due to the security issues involved with 
processing credit cards, only Sysop level users can set up or edit the POS Dial settings for each 
store.

You will need the following information for each store in order to process transactions with POS 
Dial: Processing Network, Merchant Account Number, Primary Phone Number, Secondary Phone 
Number, and Device ID Number.

Processing Network
The credit card processing network used for processing transactions for this particular store. POS 
Dial directly supports First Data Resources (FDR), Modular Data Inc. (MDI), and Transact Data 
Services (TDS). Each store within Omni-Mall can process credit card transactions using different 
credit card networks. This allows you to provide online store space to other merchants AND 
process credit card transactions through their merchant account (if they wish, most merchants will 
still want to handle their own credit card processing).

POS Dial can also communicate with an additional computer that runs IC Verify in order to process 
transactions through networks other than those directly supported. If your processing network is 
FDR then you will need to find out if your account is set up for ETC Type 2 or ETC Type 7 
Transactions.

Merchant Account Number
The merchant account number provided by the credit card processing company for this particular 
store. Do NOT include dashes or spaces when you enter this number into Omni-Mall.

Primary Phone Number
The first phone number used to dial the credit card processing network.

Secondary Phone Number
The second phone number used to dial the credit card processing network. If you don't have a 
secondary phone number simply put the primary phone number in again.

Device ID Number
This field is used when processing through FDR. The device ID signifies the credit card processing 
device in the organization. If you have other credit card processing devices in use on the same 
merchant account number then each device needs to have a unique device ID.


The following credit card processing networks are available:

1)  FDP	First Data ETC Plus
2)  FDR	First Data Resources
3)  ICV	IC Verify
4)  MDI	Modular Data Incorporated
5)  PPI		Visa International POS-PORT
6)  TDS 	Transact Data Services Inc.
4)  TST	POS Test network Identifier

Choose the network of your credit card processor.
FDP 	First Data ETC Type 7
This network is First Data Resources using ETC Type 7 transactions. ZIP/Address verification is 
available with this network type. The following configuration options are required for First Data 
Resources operation:

Terminal Identifier:		Terminal Identifier should be PZ95 by itself. Do not change this unless 
instructed to do so by DataSafe.

Merchant Number:		Your merchant number provided by your credit card processing 
company. Do NOT include any dashes or spaces.

Primary phone number:	Contact your credit card processor for the Primary phone number used 
to connect with the FDR network. If this is a SprintNet number then 
precede the number with the letter "S".

Secondary phone number:	Contact your credit card processor for the Secondary phone number 
used to connect with the FDR network. If this is a SprintNet number 
then precede the number with the letter "S".

SprintNet User Address:	If you're connecting through SprintNet then enter the host address of 
FDR. Typically, this address is 81636.

Device ID (4 character):	This is the 4 character device ID configured by you. For example, you 
might make VisaMan device ID 0001 and Omni-Mall device ID 0002. 
If you already have a credit card terminal machine then it is probably 
using device ID 0001. DO NOT FORGET THAT THIS FIELD MUST BE 
4 CHARACTERS, SO BE SURE AND INCLUDE ENOUGH "0's" IN 
FRONT OF THE NUMBER. Example: 0001

Transaction Identifier:	This is normally left blank. Do not put anything in this field unless 
instructed to do so by DataSafe.
FDR	First Data Resources ETC Type 2
The following configuration options are required for First Data Resources using ETC Type 2 
transactions. ZIP/Address verification is NOT available with this network type and should be 
turned OFF in the level 4 setup. The following configuration options are required for First Data 
Resources operation:

Terminal Identifier:		Terminal Identifier should be "RD.". Do not forget to include the "." 
character after RD.

Merchant Number:		Your merchant number provided by your credit card processing 
company. Do NOT include any dashes or spaces.

Primary phone number:	Contact your credit card processor for the Primary phone number used 
to connect with FDR. If this is a SprintNet number then precede the 
number with the letter "S".

Secondary phone number:	Contact your credit card processor for the Secondary phone number 
used to connect with FDR. If this is a SprintNet number then precede 
the number with the letter "S".

SprintNet User Address:	If you're connecting through SprintNet then enter the host address of 
FDR. Typically, this address is 81636.

Device ID (ex "#0002"):	This is the 5 character device ID configured by you. For example, you 
might make VisaMan device ID 0002 and Omni-Mall device ID 0003. 
If you already have a credit card terminal swipe machine then it is 
probably using device ID 0001. DO NOT FORGET THE "#" SYMBOL!

ICV	IC Verify
This network type is used if you're using the IC Verify software running on a separate machine to 
process your credit card transactions.

20 Character Identifier:	This field may contain anything you wish. The text from this field will 
be placed in the "Memo" field in the IC Verify database. You may 
want to put your BBS name or something like that in this field. The 
text in this field does not affect the operation of POS Dial or IC Verify 
at all.

Modular Data Incorporated
The following configuration options are required for Modular Data Inc. operation. This is the 
processing network used by TeleFlora and Wells Fargo Bank. 

Terminal ID Number:		Contact your credit card processing company for the correct Terminal 
ID. If you are using TeleFlora then it will be your TeleFlora account 
number with a "01" appended. 

Merchant Number:		Contact your credit card processing company for the correct Merchant 
Number. This is sometimes referred to as an INFACT number or an 
MDI ID number. When using TeleFlora it is a 4 digit number.

Primary Number:		The primary phone number to connect with the processing network 
WITHOUT dashes: 18003474105

Secondary Number:		The secondary phone number to connect with the processing network 
WITHOUT dashes: 18008313650

Authorization TID#:		Authorizations Terminal ID number. Typically left blank.

PPI	Visa International POS-Port
The POS-Port is an external hardware device used for processing credit card transactions. Please 
contact DataSafe for the specific configuration options used with this device.

TDS	Transact Data Services, Inc.
TDSi is a Canadian processing network used by many Canadian banks. The following configuration 
options are required:

Terminal ID (8 characters):	Contact your credit card processing company for the correct Terminal 
ID.

Operator ID (3 characters):	Contact your credit card processing company for the correct Operator 
ID.

Primary phone number:	The primary phone number to connect with the processing network 
WITHOUT dashes: 18003474105

Secondary phone number:	The secondary phone number to connect with the processing network 
WITHOUT dashes: 18003474105

TST	POS Test network identifier
The Test network option allows you to test VisaMan to see that it is operating correctly. The Test 
network type will randomly approve and decline credit card transactions. It is a good way to make 
sure your purchase options are set up correctly. THE TEST NETWORK TYPE DOES NOT TEST THE 
POS SYSTEM AT ALL, IT IS USED TO MAKE SURE VisaMan IS SET UP CORRECTLY. THE POS 
SYSTEM SHOULD BE TESTED USING YOUR OWN CREDIT CARD NUMBER TO MAKE SURE IT IS 
FUNCTIONING CORRECTLY.


Appendix B - Fax/Online Configuration
Omni-Mall can optionally fax invoices from each store to a specified fax number when used in 
conjunction with the Galacticomm Fax/Online module.

1. Install the Fax/Online module according to the Fax/Online installation instructions.
 
2. Edit the Fax/Online prefix list using the GALFXP utility from the Add-on Utilities Menu (Option 
8). Editing the prefix list allows the Fax/Online module to determine which area codes and 
prefixes are local calls and which are not.
 
3. Test Fax/Online by sending faxes directly from the Fax/Online module.
 
4. Once the Fax/Online module is installed and operating correctly then Omni-Mall will be able to 
fax invoices to the fax number listed in each store. You can edit the fax number in each store 
from the Manager's Menu within Omni-Mall. In terminal mode, choose option E from the 
Manager's Menu to add/edit/delete the fax phone number. In C/S mode choose Store Functions 
from the Manager's menu. The fax number is listed on the Store Information tab screen.


 

INCLUDE THE AREA CODE IN THE FAX NUMBER, EVEN IF THE FAX NUMBER IS A LOCAL CALL!

Appendix C - Conversion from Omni-Mall v1.x
The conversion process from Omni-Mall version v1.x to version v2.0 is seamless. There are some 
issues in the conversion process that need to be discussed. When you install Omni-Mall 2.0 for 
the first time, a conversion utility will be run. You may choose at this time to abort the conversion 
process without any repercussions. If you should decide to allow the conversion process to take 
place, the entire process is automated. If at any time you need to abort the process, simply press 
any key and the conversion will stop. This process may take considerable time if there are a large 
number of records to convert.

After the conversion has taken place there are a few items that will need to be completed by the 
Sysop. Omni-Mall v2.0 contains much more information and options than v1.0. For this reason 
certain items will need to be updated manually. The following list contains items that should be 
confirmed:

Store Setup
1.	Confirm settings in Sysop store editor
1.1.  Check Store long description
1.2.  Check User-ID of store manager
1.3.  Check Store Key and PO Key
1.4.  Check POS Configuration
2.	Confirm and edit information in sore editor
2.1  Fill in Company Information
2.2  Fill in Store unit of measure
2.3  Complete Store tax options
2.4  Verify Store invoice questionnaires (if applicable)
2.5  Create Store shipping table
2.6  Create Store tax table
2.7  Upload Store browser bitmap (applicable to C/S mode only)

Department Setup
1.  Check and verify Department titles and default product formats
2.  Enter Department long descriptions
3.  Upload Department browser bitmap and image files (applicable to C/S mode only)

Product Management
Due to the fact that the products in Omni-Mall 2.0 are more complex in structure than previous 
versions, there may be many items in each product that need to be altered. Most common options 
include;

1.  Product weight
2.  Product tax options
3.  Product description and title (keywords are now derived from both of these)
4.  Product "wholesale-ability"
5.  Secondary Product format

It may be helpful, if large scale changes are required to export the product data after the 
conversion. The exported data can then be altered to reflect the appropriate changes and then re-
imported. The viability of this option is entirely based upon the volume of changes required.
 



 

 




46


