









MarketplaceT 1.0
for
Worldgroup by Galacticomm, Inc.

Copyright c 1995 - All Rights Reserved
MarketplaceT 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


LEGAL & TECH SUPPORT

Copyright
Marketplace and accompanying documentation is copyright c1995 by DataSafe
Publications, Inc., hereafter referred to as DataSafe. All rights to
Marketplace 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 Marketplace 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 Marketplace 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 Marketplace 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 MARKETPLACE. 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 Marketplace 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@dump.com
Telnet:			dsafe.com
WWW:                    http://www.dsafe.com


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

It is assumed that you have a good understanding of DOS, Pkunzip, and your
computer. It is also assumed that you understand the basics of modem
communications such as logging onto a BBS and upload/download 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 software also
apply.  Optional POS Dial Support Marketplace supports online credit card
verification if the POS Dial Module is installed. See the POS Dial
documentation for the specific requirements needed to support online
verification.

INSTALLATION
Installation of Marketplace 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, those options are not used during the installation or operation of
Marketplace.

1.      Backup the Marketplace 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.

2.      Put the Marketplace 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
Marketplace to both the terminal mode menu tree and the client/server menu
tree. Marketplace 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 DPIMARKT.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 DPIMARKT.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.

6.      <Optional> Install the POS Dial Module from DataSafe Publications,
Inc. if you want support for online credit card verification. You may
install this module later after installing Marketplace but you will not be
able to enable online credit card verification until this module is
installed.

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 Marketplace from
the menu that you added it to. You may also log on from a remote computer
using the Window's Worldgroup Client Manager.

9a.     The first step is to configure the categories already defined in
Marketplace. Use the Sysop commands to edit/modify/delete individual
categories of ads. Marketplace is shipped with approximately 15 categories.
You will most likely wish to delete, modify, or add to these categories. It
is most important to modify the payment method used in each category since
Marketplace is initially set up to allow ads to be posted at no charge to
the end user.

9b.     <Optional> If you have installed the POS Dial Module for online
credit card verification then Marketplace will need to be configured to
work with it. From the Marketplace Sysop Menu choose option E for the POS
Configuration Menu. Configure Marketplace to work with your credit card
network. See the POS Dial section of this manual for specific instructions.
If you're using the Worldgroup client then choose POS Configuration from
the pull-down sysop menu.

10.     After you have modified the categories you should post a test ad in
each category to make sure it is configured correctly. If you will charge
for ads then you should post the test ads as a non-sysop user. Sysop users
are not charged for posting ads.

Distribution Files
Marketplace consists of the following files in the \WGSERV subdirectory:

DPIMARKT.DLL	Run-time Dynamic Link Library
DPIMARKT.MSG	Configuration File
DPIMARKT.H      Header File
DPIMARKT.MCV	Runtime Configuration File
DPIMARKT.MDF	Module Definition File
DPIMARKT.RLN	Release Notes (ASCII)
DPIMARKT.DOC	Sysop Docs in MS Word 6.0 Format
DPIMARKT.TXT	Sysop Docs in DOS Text Format
DPIMKWDS.VIR	VIRgin (empty) Data File
DPIMSCAN.VIR	VIRgin (empty) Data File
DPIMTRNS.VIR	VIRgin (empty) Data File
DPIMUSRS.VIR	VIRgin (empty) Data File
DPIMADS1.VIR	VIRgin (empty) Data File
DPIMCATS.VIR	VIRgin (empty) Data File
DPIMKWDS.VIR	Data File
DPIMSCAN.VIR	Data File
DPIMTRNS.VIR	Data File
DPIMUSRS.VIR	Data File
DPIMADS1.VIR	Data File
DPIMCATS.VIR	Data File



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

DPIMKxxx.EXE	Client EXE
DPIMKxxx.HLP	Client Help File
INICON3.VBX     Client Support VBX
VBASCROL.VBX    Client Support VBX
SS3D3.VBX       Client Support VBX
LEAD.VBX        Client Support VBX
LEADDIB.VBX 	Client Support VBX
GRID.VBX        Client Support VBX
DPIMCTAD.DLL	Credit Card Encryption DLL
PCDLIB.DLL      Client Support DLL
SSDOCK20.VBX 	Client Support VBX
LEAD50.VBX      Client Support VBX

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). Marketplace 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
Marketplace to operate with your system along with the security keys
required to access certain Marketplace functions.  Your Marketplace
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 DPIMARKT.MSG to get to the option.

CODE		Marketplace Activation Code
Marketplace activation code. This code is required for activation of the
Marketplace credit card purchase module.

DPIMAGNK	Key required to access marketplace through C/S
This is the key required to use Marketplace via the C/S interface. This
does not affect ANSI users at all.

DPIMSYSK	Key required to use marketplace sysop functions
This is the key required to use Marketplace's Sysop functions, such as
adding, deleting, and editing categories, maintain POS configurations,
approving ads, etc.

DPIMCRDK	Key required to pay with credits
This is the key required to allow users to pay for their ads with credits.
Set this to the key a user gets when he is put on the credit system. Set
this option to SYSOP if you do not want to allow users to pay for ads with
credits.

DPIMDAYK	Key required to pay with days
This is the key required to allow users to pay for posting ads using days
from their account class.  Set this to any key a user gets when their
account class is setup with a limited number of days.  Set this option to
SYSOP if you do not want to allow users to pay for ads with days from their
account class.

LEVEL 4 - Configuration Options
The Level 4 configuration options allow you to configure Marketplace 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
DPIMARKT.MSG to get to these options.

SCANDIR	Directory for pos-dial/stub programs
This is the directory Marketplace will place transactions into.  THIS MUST
BE THE SAME as the POS-DIAL or POS-STUB scanning directory.

MKTMGR	Marketplace EMail manager
The user named here will receive a copy of every transaction in his or her
EMail.  It is suggested that you leave this to "Sysop" unless you have a
different User-ID for your sysop or have a separate User-ID to handle
credit card purchases.

DBRNAME	Default Real Name to signup real name?

COMQUOT	Comma/quote delimit all ASCII log files?

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

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

The following 5 statements provide the sysop the ability to allow user to
pay for ads with various forms of credit cards. The card types allowed are
American Express, Visa, MasterCard, ISRA, and Discover.

AMERXPRS	Accept AMERICAN EXPRESS credit cards

VISACRD	Accept VISA credit cards

MASTRCHG	Accept MASTERCARD credit cards

DISCVER	Accept DISCOVER credit cards

ISRACRD	Accept ISRA-CARD credit cards

MAXLST	Number of entries in lists
This option determines how many categories or ads a user views at a time
(ANSI side only).

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.

DPIMXSZ	Maximum size of uploaded images
You may put a limit on the size of an uploaded image, to prevent people
from uploading huge pointless files.  If you make this option equal zero,
there will be no limit.

SYSOP FUNCTIONS
Setup
There are two items that need to be setup before Marketplace is
operational. First, you need to add/modify/delete ad categories. Second,
you need to setup the POS Dial Module configuration if you have the POS
Dial Module installed. The following instructions apply to ANSI terminal
mode setup. The field explanations are the same if you use C/S mode, but
the exact steps will be different.

Adding/Editing a Category
Enter the Marketplace module online as a sysop level user. Choose S from
the Main Marketplace menu, then choose either A to Add a Category, or C to
edit a category. The following data entry screen will need to be filled
out.

                             Category Information
                      Title:
                Description:

+         Access Keys         ++       Payment Table    +  +--Control Menu--+
    Read Ads:                           C    D   $       TAB - Select  
    Post Ads:                Per WORD     0   0 0.0          - Select  
Attach Image:                Per Block    0   0 0.0      ^F  - Insert  
+-----------------------------++------------------------+    ^G  - Save    
+      Discount Table       +   +         Options       +    ^O  - Quit    
    Days   C     D     $           Allow Images: YES   +----------------+
1.     0  0.0 % 0.0 % 0.0 %          Real Names: YES 
2.     0  0.0 % 0.0 % 0.0 %          Phone Nums: YES         Legend
3.     0  0.0 % 0.0 % 0.0 %     Block Size (KB):  100      C - Credits
4.     0  0.0 % 0.0 % 0.0 %    Ads req approval: NO        D - Days
5.     0  0.0 % 0.0 % 0.0 %    Images req apprv: NO        $ - Money
+---------------------------+       Allow Credits: YES 
                                       Allow Days: YES 
                                Allow Credit Card: YES 
                                +-----------------------+
               Exit:       (select (S)ave or (Q)uit and hit enter)

Title		The title of the Category to be added/edited. This is the name assigned to the
category.

Description	Enter a longer description of the category.


+         Access Keys         +
    Read Ads:                
    Post Ads:                
Attach Image:                
+-----------------------------+

Read Ads	Users must have this key in order to read ads. Leave this field blank to allow all
users to read ads.

Post Ads	Users must have this key in order to post new ads. Leave this field blank to allow all
users to post ads.

Attach Image	Users must have this key in order to attach images to ads they post. Leave this field
blank to allow all users to attach images to ads.

+       Payment Table    +
             C   D   $  
Per WORD     0   0 0.0  
Per Block    0   0 0.0  
+------------------------+

Per Word	C - Number of credits to charge per word (one time charge). D - Number of days to
deduct from the user's account per word (one time charge). $ - Actual dollar amount
to charge per word (one time charge).

Per Block	The user may also be charged based on the size of the image they attach to an ad.
The size of each block (in bytes) is defined elsewhere on this screen. For example, if
the black size was set to 10,000 and the image was 100,000 bytes, the number of
blocks would be 10. C - Number of credits to charge for each image block. D -
Number of days to deduct from the user's account per image block. $ - Actual dollar
amount to charge for each image block.

+--Control Menu--+
  TAB - Select  
      - Select  
  ^F  - Insert  
  ^G  - Save    
  ^O  - Quit    
+----------------+

Tab		The TAB key will move the focus to the next field. SHIFT-TAB will move the focus
back one filed. The arrow keys will also move from one field to the next.

^F		The ^F (CTRL-F) key combination will insert one space in the current field.

^G		The ^G (CTRL-G) key combination will save the current data screen. This is a
shortcut that can be used rather than choosing SAVE at the bottom of the screen.

^O		The ^O (CTRL-O) key combination will abort the current data screen. This is a
shortcut that can be used rather than choosing QUIT at the bottom of the screen.



+        Discount Table       +	Example:	+	  Discount Table        +
    Days   C      D      $    			    Days    C      D      $   
1.     0  0.0 %  0.0 %  0.0 % 			1.     7   5.0 %  5.0 %  5.0 %
2.     0  0.0 %  0.0 %  0.0 % 			2.    14  10.0 % 10.0 % 10.0 %
3.     0  0.0 %  0.0 %  0.0 % 			3.    21  15.0 % 15.0 % 15.0 %
4.     0  0.0 %  0.0 %  0.0 % 			4.    30  20.0 % 20.0 % 20.0 %
5.     0  0.0 %  0.0 %  0.0 % 			5.     0   0.0 %  0.0 %  0.0 %
 +---------------------------+ 			 +---------------------------+

Days		The number of minimum days an ad must run to receive the discount. You can set
up to 5 different discount ranges. In the example there is a 5% discount for ads that
run from 7-13 days, a 10% discount for ads that run 14-20 days, a 15% discount
for ads that run from 21-29 days, and a 20% discount on ads that run for 30 days
or more. The discount % can be different for credits, days, and dollar amounts as
well.

C		The % discount applied to ads paid for with credits.

D		The % discount applied to ads paid for with days.

$		The % discount applied to ads paid for with dollars.



+         Options       +
     Allow Images: YES 
       Real Names: YES 
       Phone Nums: YES 
  Block Size (KB):  100
 Ads req approval: NO  
 Images req apprv: NO  
    Allow Credits: YES 
       Allow Days: YES 
Allow Credit Card: YES 
+-----------------------+

Allow Images	If set to YES then images may be attached to ads posted in this category. If set to
NO then images may not be attached to ads posted in this category.

Real Name	If set to YES then the Name field must contain data. If set to NO then the user may
optionally enter a real name.

Phone Nums	If set to YES then the Phone Number field must contain data. If set to NO then the
user may optionally enter a phone number.

Block Size	This sets the size in blocks of uploaded images. For example, if an image was
500,000 bytes and the block size is set to 100 then the number of blocks in the
image would be 5 (500Kb/100=5). The block size is used to determine any extra
charges associated with uploading images as per the Payment Table.

Ads Req	If set to YES then the Sysop must approve all ads posted in this category before any
other users may read them. If set to NO then new ads will be available to other
users as soon as they are posted.

Images Req	If set to YES then the Sysop must approve all images posted in this category before
any other users may view them. If set to NO then new images will be available to
other users as soon as they are uploaded.

Allow Creds	If set to YES then users may pay for ads with credits as long as they have the key
required to pay with credits as defined in the level 3 configuration. If set to NO then
users will not be able to pay for ads with credits. YOU MUST SET ONE PAYMENT
OPTION TO YES, EVEN IF YOU ARE NOT CHARGING FOR POSTING ADS!

Allow Days	If set to YES then users may pay for ads with days as long as they have the key
required to pay with days as defined in the level 3 configuration. If set to NO then
users will not be able to pay for ads with days. YOU MUST SET ONE PAYMENT
OPTION TO YES, EVEN IF YOU ARE NOT CHARGING FOR POSTING ADS!

Allow CC	If set to YES then users may pay for ads with a credit card. If set to NO then users
will not be able to pay for ads with a credit card. YOU MUST SET ONE PAYMENT
OPTION TO YES, EVEN IF YOU ARE NOT CHARGING FOR POSTING ADS!

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 purchasing the largest available amount of time just after signing up. 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.

Use Sysop option J from the Sysop Menu to enter bad card numbers that you don't wish to
accept. 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 a
many reasons, and the bank may decline one mistakenly.

FUTURE PLANS
Unfortunately, there never seems to be enough time to implement all the great ideas suggested for
a module. Here are some of the ideas we'll be working on in future versions of Marketplace.
Please let us know if you have any other ideas to improve Marketplace!

  Specifically allow FREE categories. It's possible now by not charging for ads, but it would be
more straightforward to simply have a free designation on a category.

  Allow the user to delete an ad before it expires (without a refund).

  Sort the categories alphabetically, or allow the sysop to sort them, or both!

  Allow the sysop to post ads as other users. Perhaps the user doesn't have a scanner and
needs the sysop to scan and post an item for sale.

  Change the field "Expiration Days" to "Expiration Date". Currently, one day is deducted from
each ad at cleanup. It makes more sense to delete ads on a specific date.

  Allow non-ANSI users to post ads. The FSD currently precludes non-ANSI users from entering
ads so we have to program it.

  Allow the user to view an ad that matches a keyword search. Currently, the user only gets a
listing of ads that match and has to hunt and peck their way to find the ad.

This listing is by no means complete! However, since we do get a lot of calls with suggestions we
figured it's easier to put this listing in the manual rather than have you waste your time calling us
with suggestions we already plan on implementing.

