home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / vend22gb.zip / VENDOR.DOC < prev    next >
Text File  |  1994-10-03  |  35KB  |  733 lines

  1.     PROGRAM TITLE:
  2.  
  3.     The Disk Vendor
  4.  
  5.  
  6.     DESCRIPTION:
  7.  
  8.     The Disk  Vendor is  a tool  for creating  "on-disk" product
  9.     catalogs.  For businesses  who would like an  alternative to
  10.     a printed catalog, The Disk Vendor will make the process  of
  11.     creating an on-disk catalog a simple one.
  12.  
  13.     The Disk Vendor run-time  module is completely menu  driven,
  14.     with a clean simple user interface, which makes it easy  for
  15.     your customers to navigate through and order from.
  16.  
  17.     The product catalogs that  you create can be  distributed on
  18.     a diskette, or printed to hardcopy format.
  19.  
  20.  
  21.     AUTHOR:
  22.  
  23.     Philip P. Kapusta
  24.     P.O. Box 5423
  25.     Falmouth, VA 22403-5423
  26.     BBS 703 372-9680 (SYSOP)
  27.  
  28.  
  29.     REQUIREMENTS:
  30.  
  31.     Hard disk drive, printer, and an editor/word processor.
  32.  
  33.  
  34.     TERMS AND DEFINITIONS:
  35.  
  36.     There are several  terms that will  be used throughout  this
  37.     documentation and that  need to be  fully understood by  the
  38.     user before  you create  your own  on-disk catalog.   Please
  39.     review these definitions carefully:
  40.  
  41.     ASCII FILE: This  is a term  used to describe  any file that
  42.     you create  and save  with an  editor such  as DOS'  EDIT or
  43.     Window's  Notepad.   The Disk Vendor  does NOT come  with an
  44.     editor because most users already have a favorite editor  or
  45.     word processor that they feel  comfortable with.  We saw  no
  46.     reason to  force the  user to  use another  editor and  have
  47.     consequently not included  one.  An ASCII file contains only
  48.     characters that can be found on a standard IBM keyboard.
  49.  
  50.     CATALOG  FILE:  A  catalog  file  is  an  ASCII  file   that
  51.     contains product  numbers, product  names and  descriptions.
  52.     These files are identified by the file extension ".CAT"  and
  53.     can  be  edited  or  created  with  a program like DOS' EDIT
  54.     editor,  or  Window's  Notepad,  or any programmer's editor.
  55.     You can even  use your favorite  word processor to  edit and
  56.  
  57.     generate catalog files, but  you must remember to  save them
  58.     as  ASCII  files.    You  use   The  Disk  Vendor   compiler
  59.     (COMPILE.EXE)  to  merge  and  compress  all your individual
  60.     .CAT catalog files into one single data file (CATALOG.DAT).
  61.  
  62.     COMPILER: The compiler  is the program  that gathers all  of
  63.     your   ASCII   catalog   files   (*.CAT)   and   all   other
  64.     miscellaneous ASCII text files (*.TXT), and then merges  and
  65.     compresses  this  information  into   a  single  data   file
  66.     (CATALOG.DAT).   The Disk  Vendor compiler  also prompts the
  67.     user for information such  as quantity discount rates,  your
  68.     mailing  address,  sales  tax,  and  currency  format before
  69.     actual compilation begins.
  70.  
  71.     DATA  FILE:  The  data  file  is  a  specially formatted and
  72.     compressed  file  that  contains  ALL  your  product  names,
  73.     prices,  mailing  address,   shipping  costs,  opening   and
  74.     closing screens, etc.   This data file  is created by  using
  75.     The Disk Vendor compiler (COMPILE.EXE) and once it has  been
  76.     created it can be identified by the filename  "CATALOG.DAT".
  77.     This data file is one  of the two necessary files  that must
  78.     be placed on your distribution disk for your customers.
  79.  
  80.     HELLO AND GOODBYE FILES:  These are silly sounding  terms, I
  81.     admit, but their  names imply what  you would think.   These
  82.     are two OPTIONAL files  that are displayed at  the beginning
  83.     and end of  your on-disk catalog.   The opening screen  file
  84.     is identified with the filename "HELLO.TXT" and the  closing
  85.     screen  as  "GOODBYE.TXT".   You  can  have  a  hello   file
  86.     without  a  goodbye  file,  or  vice  versa.   One  does not
  87.     require the other.  Or you may wish to eliminate both.   The
  88.     choice is up to you.  These files are extended ASCII  files,
  89.     which means  you can  use any  of the  high ASCII characters
  90.     (graphics) such as ║ ▒ █  ╚ ½ å.  (Note: Some  printers will
  91.     not display  these characters  properly if  you are printing
  92.     the VENDOR.DOC file).
  93.  
  94.     RUN-TIME  MODULE:  Refers  to  the file "CATALOG.EXE".  This
  95.     is  the  program  that  reads  the  information in your data
  96.     file and displays it to your customers.  Remember, in  order
  97.     to create a catalog on a disk for your customers, two  files
  98.     must exist on that disk:  1) CATALOG.EXE and 2) CATALOG.DAT.
  99.  
  100.     SHIPPING  FILE:  This  is  a  small ASCII file that contains
  101.     information  on  the  various  modes  of  shipping and costs
  102.     available  to  your  customer.   It  is  identified  by  the
  103.     filename "SHIPPING.TXT".
  104.  
  105.     TEXT  FILE:   Text  files  are  ASCII  files  that   contain
  106.     miscellaneous  messages  and  notes   that  you  want   your
  107.     customers to have access to.   Text files are identified  by
  108.     the  file  extension  ".TXT"  and  must NOT be confused with
  109.  
  110.     catalog  files.   Text  files  should  NOT  contain products
  111.     that you  want your  customers to  order, unless  you expect
  112.     them to  hand write  those items  at the  end of their order
  113.     form.  The contents of text files can only be viewed on  the
  114.     screen, and  no order  prompts, prices  or discount  windows
  115.     appear in conjunction with  "*.TXT" text files.   An example
  116.     of a useful  text file would  be a file  that gives a  brief
  117.     sketch about  your company  or about  how your  products are
  118.     better than your competitor's.
  119.  
  120.     WAIT FILE: This  is a special  ASCII file that  is displayed
  121.     to your  customers by  the run  time module  as it  reads in
  122.     information from the data file.   It can be considered as  a
  123.     commercial message if you wish.  It is called a "wait  file"
  124.     because its  contents are  displayed on  the screen  as your
  125.     customer waits  for the  program to  finish a  task.   It is
  126.     appropriately identified by the filename "WAIT.TXT".
  127.  
  128.     With these terms  now under your  belt you will  be ready to
  129.     begin creating your own on-disk shareware catalog.
  130.  
  131.  
  132.     LET'S GET STARTED:
  133.  
  134.     The  first  thing  that  we  recommend  a  brand new user to
  135.     do  is  to  run  the  compiler  (COMPILE.EXE) and generate a
  136.     personalized  data  file  (CATALOG.DAT).   Then  after  this
  137.     execute  the  run  time  module  (CATALOG.EXE)  so  that you
  138.     can see  how quick  and easy  it is  to generate  a catalog.
  139.     Do this right  now!  At  the DOS prompt,  just enter COMPILE
  140.     and fill in the blanks  as you are prompted by  the program.
  141.     Once you  have done  this, enter  CATALOG at  the DOS prompt
  142.     and look at your results.
  143.  
  144.     Before you  generate your  own catalog  files (*.CAT)  spend
  145.     some  time  getting  familiar  with  the  run-time    module
  146.     (CATALOG.EXE).   Explore its  features and  interface.   Try
  147.     placing a few orders as if  you were a customer.  Print  out
  148.     your order forms, print the catalog, search for words,  save
  149.     and retrieve  your orders,  etc.   By playing  with the run-
  150.     time module you will  get a feel for  the power and ease  of
  151.     use that The Disk Vendor provides you.
  152.  
  153.     Once  you  have  spent  some  time  with the run-time module
  154.     (CATALOG.EXE)  and  the  compiler  (COMPILE.EXE)  then   you
  155.     should begin creating your very own catalog files (*.CAT).
  156.  
  157.     To begin, use  your favorite text  editor or word  processor
  158.     and open a new file.  We will call the name of the new  file
  159.     "VIRUS.CAT"  and  we  will  generate  a  catalog  file  that
  160.     contains virus  checking software  programs.   Note: You can
  161.     give the file any name you wish as long as it  contains  the
  162.  
  163.     file  extension  ".CAT".   "SOFTWARE.CAT",   "DISNFECT.CAT",
  164.     "_VIRUS_.CAT" are  all valid  catalog file  names.  Whatever
  165.     is  easiest  for  you  to  remember,  give it an appropriate
  166.     filename.
  167.  
  168.     THE STRUCTURE OF A CATALOG FILE:
  169.  
  170.     Once you  begin a  new catalog  file, there  is a   specific
  171.     format that you must follow:
  172.  
  173.     1) The  very first  line of  the catalog  file (*.CAT)  must
  174.     contain  a  34  character  or  less  description.  The first
  175.     line  of  a  catalog  file  will  be  used  in the Main Menu
  176.     catalog index listing.
  177.  
  178.     2) A pound symbol "#" separates one product and  description
  179.     from  another.   The  "#"  can  be  followed by your catalog
  180.     number identifying  the product  that follows  it.   Catalog
  181.     order numbers must not be longer than 20 characters.
  182.  
  183.     3) The name of the product  follows on  the next line  after
  184.     the line that contains the "#" symbol.
  185.  
  186.     4) Any  lines after  the product  name are  used for  you to
  187.     describe that product.
  188.  
  189.     5)  Product  description  line  length  must  not  exceed 72
  190.     characters in width.  This is one rule that is often  easily
  191.     forgotten.   It  may  seem  minor,  but  for  the program to
  192.     generate  a  printed  catalog  for  your  customers  with  a
  193.     sufficient  left  margin  for  punching  holes  for a 3-ring
  194.     binder,  product  description  lines  can  not  exceed   nor
  195.     encroach upon the  margins.  Most  "good" text editors  will
  196.     have the option to define  a right margin width, and  with a
  197.     word-wrap feature,  this 72  character line  limit will  not
  198.     pose  a  problem.   Most  word  processors that export ASCII
  199.     text also will word wrap, along with being able to define  a
  200.     right margin.   The compiler will  catch any violations  and
  201.     will  stop,  bringing  to  your  attention  any  line length
  202.     violations.    I  have   a  favorite   text  editor   called
  203.     Multi-Edit,   published   by   American   Cybernetics.   For
  204.     approximately $80  it is  loaded with  everything you  could
  205.     want in a  text editor.   I highly recommend  it if you  can
  206.     afford it  and are  looking for  a text  editor besides  the
  207.     freebie Microsoft ships with DOS versions 5.0 and up.
  208.  
  209.     All right, got it?  Clear as  mud?  Probably.  So here   are
  210.     some examples  that will  help you.   Again, we  are in  our
  211.     editor and have the file "VIRUS.CAT" open.  With the  cursor
  212.     at  the  very  top  of  the  document  (line  1),  enter   a
  213.     description used  to identify  the contents  of the  catalog
  214.     file:
  215.  
  216.     ┌─────────────────────────────────────────────────────────┐
  217.     │Virus protection software                                │
  218.     │                                                         │
  219.     │                                                         │
  220.     │                                                         │
  221.  
  222.     It is  simple so  far, isn't  it?   Just keep  the number of
  223.     characters in this description line less than 34.
  224.  
  225.     Now, on to line 2!
  226.  
  227.     As we stated above, a "#" symbol separates one product  from
  228.     another.   Since we  are about  to enter  a new product name
  229.     and description, we need to place a "#" on line 2, column 1:
  230.  
  231.     ┌─────────────────────────────────────────────────────────┐
  232.     │Virus protection software                                │
  233.     │#                                                        │
  234.     │                                                         │
  235.     │                                                         │
  236.  
  237.     If  you  wish  to  identify  your  products  using a catalog
  238.     number, now  is the  time to  do so.   Immediately following
  239.     the "#" symbol, enter your catalog number.  The number  does
  240.     not need to  be a number,  but can be  characters if you  so
  241.     choose, or a combination of both.  For example:
  242.  
  243.     ┌─────────────────────────────────────────────────────────┐
  244.     │Virus protection software                                │
  245.     │#VI040                                                   │
  246.     │                                                         │
  247.     │                                                         │
  248.  
  249.     Again, you  are not  required to  enter a  catalog number if
  250.     you choose not  to.  What  is mandatory, however,  is that a
  251.     "#" symbol exists in column 1 and must precede the line that
  252.     contains the product name.
  253.  
  254.     When you are  ready to enter  a product name,  move down one
  255.     line below the "#" and enter it:
  256.  
  257.     ┌─────────────────────────────────────────────────────────┐
  258.     │Virus protection software                                │
  259.     │#VI040                                                   │
  260.     │Expel                                                    │
  261.     │                                                         │
  262.  
  263.     In the example above  the software program "Expel"  has been
  264.     placed immediately below the line containing the "#" symbol.
  265.  
  266.     To show you some of  the features unique to The  Disk Vendor
  267.     we will let you  know here that you  can add a comment  note
  268.     on the same line  as the product name.  A "comment note" may
  269.  
  270.     consist of anything you wish,  as long as it is  enclosed in
  271.     squiggly brackets  {}.   For example,  let's say  that Expel
  272.     is  obtained   wholesale  through   your  distributor   Acme
  273.     Software.  Your sales  representative with Acme Software  is
  274.     Jim Smith.  If you wanted  to make a note of that  fact, you
  275.     can add a comment note recording this.  For example:
  276.  
  277.     ┌─────────────────────────────────────────────────────────┐
  278.     │Virus protection software                                │
  279.     │#VI040                                                   │
  280.     │Expel {Acme: Jim Smith}                                  │
  281.     │                                                         │
  282.  
  283.     Above  we  see  that  the  software title Expel is purchased
  284.     through  Acme  Software,  whose  sales  rep.  is  Jim Smith.
  285.     This comment note is enclosed in {} brackets.  The  brackets
  286.     are very  important!   When this  catalog file  is compiled,
  287.     your  comment  notes  are  ignored.   Comment  notes  in  {}
  288.     brackets do not appear  to your customer because  they never
  289.     find their way  into the data  file (CATALOG.DAT).   Comment
  290.     notes are  for your  use and  are optional.   You can  enter
  291.     anything  you  wish  between  {}  brackets  -  the name of a
  292.     company, a stock bin number, an inventory count, the  weight
  293.     of  the  product,  whatever.   Again,  this  comment note is
  294.     optional.
  295.  
  296.     The next  bit of  information that  you need  to add  is the
  297.     selling  price  for  the  product.   At  the end of the line
  298.     that contains the product  name, enter its price.   Although
  299.     you can add a currency symbol before the price, this is  not
  300.     necessary, and in  fact it is  not recommended.   The reason
  301.     we do not recommend that  you enter a currency symbol  (e.g.
  302.     "$")  is  because  it  takes  up  file  space.  The run-time
  303.     module does not need  the currency symbol repeated  hundreds
  304.     of times in your *.CAT files.   One little "$" sign may  not
  305.     seem like much,  but if you  repeat this symbol  hundreds of
  306.     times  it  slowly  eats  up  disk  space.   But if you can't
  307.     break  the  habit,  that's  fine  too.   The  compiler   and
  308.     run-time module do not care.
  309.  
  310.     ┌─────────────────────────────────────────────────────────┐
  311.     │Virus protection software                                │
  312.     │#VI040                                                   │
  313.     │Expel {Acme: Jim Smith} 23.95                            │
  314.     │                                                         │
  315.  
  316.     Above we  see a  price of  $23.95 for  one unit  of "Expel".
  317.     This  $23.95  is  the  undiscounted  selling  price for this
  318.     product to  your customers.   If you  wish to  give multiple
  319.     quantity discounts, see  the compiler (COMPILE.EXE)  and set
  320.     up  the  discount  rates  at  compile  time.   Here  in your
  321.     catalog file (*.CAT) simply  enter the price of  the product
  322.     item as shown above.
  323.  
  324.     Now that we  have entered a  product number, a  product name
  325.     and  price,  all  that  we  have  left  is  to  give Expel a
  326.     description.    The   product   description   lines   follow
  327.     immediately  below  the  line  that  contains  the product's
  328.     name and price.  For example, let's describe Expel:
  329.  
  330.     ┌─────────────────────────────────────────────────────────┐
  331.     │Virus protection software                                │
  332.     │#VI040                                                   │
  333.     │Expel {Acme: Jim Smith} 23.95                            │
  334.     │Anti-virus program that helps preserve the integrity of  │
  335.     │your files.                                              │
  336.     │                                                         │
  337.  
  338.     You can definitely get more descriptive if you wish.  We  do
  339.     not  recommend  that  you  enter  more  than  13 lines for a
  340.     program description because it will be truncated when it  is
  341.     compiled.  13 lines should  be more than enough to  describe
  342.     most programs.  Also,  keep all description lines  less than
  343.     72  characters  wide.   You  can  insert  blank lines if you
  344.     wish, and they will be preserved when compiled.
  345.  
  346.     Believe it or  not, that is  all there is  to it!   Not very
  347.     hard is it?
  348.  
  349.     To add additional programs to our "VIRUS.CAT" catalog  file,
  350.     simply repeat  steps 2-4  above.   Here is  our catalog file
  351.     after adding two more virus checking programs:
  352.  
  353.     ┌─────────────────────────────────────────────────────────┐
  354.     │Virus protection software                                │
  355.     │#VI040                                                   │
  356.     │Expel {Acme: Jim Smith} 23.95                            │
  357.     │Anti-virus program that helps preserve the integrity of  │
  358.     │your files.                                              │
  359.         │#VI107                                                   │                                             │
  360.     │Flu Shot+ 17.95                                          │
  361.     │Protects you system against virus and Trojan horse       │
  362.     │programs. Read/write protection for programs. Checks for │
  363.     │contamination and prevents virus activities.             │
  364.     │#VI100                                                   │
  365.     │Virex {Version 2.1} 34.95                                │
  366.     │Virex checks an entire disk for over 800 different virus │
  367.     │strains.  If it detects a virus, Virex will remove the   │
  368.     │virus from the program or disk.  Quarterly update        │
  369.     │virus signature lists are available from the publisher   │
  370.     │to protect your computer against new virus strains.      │
  371.  
  372.     Notice  that  you   do  NOT  repeat   the  "Virus protection
  373.     software" category  description line.    This  occurs   only
  374.     ONCE, and must  be on the   first  line   of  your   catalog
  375.     file (VIRUS.CAT).
  376.  
  377.     We  strongly  recommend  that  you enter/insert new products
  378.     in alphabetical order.   This will make your  catalog easier
  379.     to navigate through  when viewed by  your customers.   There
  380.     exists  a  function  in  The  Disk  Vendor  run-time  module
  381.     (CATALOG.EXE)  that  lists  all  the  product  items  in the
  382.     currently selected  category.   This "quick  browse" listing
  383.     displays the products' names in the same order in which  you
  384.     entered them into the catalog file.  Therefore, if you  want
  385.     this list to appear in alphabetical order, you should  enter
  386.     the products in  alphabetical order.   The Disk Vendor  will
  387.     not sort  this list  because it  wants you  to practice good
  388.     catalog file creation and maintenance.   It is also to  your
  389.     benefit  to  enter  and  maintain  products  in alphabetical
  390.     order.  It  not only makes  it easier for  your customers to
  391.     locate products, but  it makes it  easier for YOU  to locate
  392.     products when it comes time to update or purge your  catalog
  393.     files.
  394.  
  395.     If these  3 titles  are all  you have  in the  way of  virus
  396.     checking  software programs, then  close  the    "VIRUS.CAT"
  397.     catalog file and save it to disk.
  398.  
  399.     One last  feature that  you may  be interested  in adding to
  400.     your catalog file is a  "customer note".  A "customer  note"
  401.     contains  text  information  that  helps better describe the
  402.     items that follow.  A  "customer note" does NOT have  prices
  403.     or part  numbers attached  to them.   You begin  a  customer
  404.     note with  a "#"  symbol, immediately  followed by  "NOTE#".
  405.     Move down one line and  enter a header line, then  move down
  406.     one line and enter the  ASCII text that makes up  your note.
  407.     Using the VIRUS.CAT file as an example:
  408.  
  409.     ┌─────────────────────────────────────────────────────────┐
  410.     │Virus protection software                                │
  411.     │#VI040                                                   │
  412.     │Expel {Acme: Jim Smith} 23.95                            │
  413.     │Anti-virus program that helps preserve the integrity of  │
  414.     │your files.                                              │
  415.     │#NOTE#                                                   │
  416.     │WHAT IS A COMPUTER VIRUS?                                │
  417.     │A computer virus is a program designed to replicate and  │
  418.     │spread on its own, preferable without you knowing it     │
  419.     │exists.  Like a human body, computers are vulnerable to  │
  420.  
  421.     It is best to experience a customer note in a compiled  data
  422.     file first hand in order  to appreciate its usefulness.   We
  423.     have included several customer  notes in the sample  catalog
  424.     files (*.CAT) that accompanied  this program.   Take a  good
  425.     look at these files to understand how they work.
  426.  
  427.     Customer notes  can occur  anywhere in  your catalog  files,
  428.     and they can  be unlimited in  length (1 to  1000 lines) but
  429.     are restricted to 72 columns in width.
  430.  
  431.     A few  other guidelines  that you  should be  aware of  when
  432.     working with catalog files (*.CAT):
  433.  
  434.         Use lower  case letters  as much  as possible. Upper
  435.         case  letters  do  not  compress well during compile
  436.         time.  On average you  will achieve a 40% file  size
  437.         reduction if the majority of your catalog files  are
  438.         in lower  case (before:  100,000K, after:  60,000K).
  439.         Don't  overdo  this,  of  course.   Just  type  your
  440.         catalog files as  if you were  typing a letter  to a
  441.         friend.  Keep the CAPS LOCK off, and avoid  entering
  442.         product names  in uppercase  and you will be  OK (or
  443.         is it "ok"?).
  444.  
  445.         Do not  use high  ASCII characters  in your  catalog
  446.         files (*.CAT).   Characters such as  ║  ▒  █ ╚ ½  å
  447.         will  not  be  compiled  properly.  Absolutely avoid
  448.         them!
  449.  
  450.  
  451.     OTHER NECESSARY FILES BEFORE COMPILING:
  452.  
  453.     Although your catalog files  (*.CAT) are the most  important
  454.     files  that  you  need  to  have prior to compilation, there
  455.     are additional files that you can and should create.
  456.  
  457.     The  first  mandatory  file  required  for  compilation is a
  458.     "wait file".  This file is an ASCII text file that  contains
  459.     a message for your customer while the run-time module  works
  460.     on a task.   This file can  be created with  an editor,  and
  461.     must be saved  with the filename  "WAIT.TXT".  If  this file
  462.     does not  exist when  you go  to compile  your catalog using
  463.     COMPILE.EXE the compilation process will abort.   "WAIT.TXT"
  464.     is  absolutely  mandatory.   With  The  Disk  Vendor package
  465.     that  you  have  received  a  sample  "WAIT.TXT" file can be
  466.     found  that  you  may  use  as  a guide.  The most important
  467.     things  that  you  must  remember  when  working  with   the
  468.     "WAIT.TXT" file is that it  can NOT be longer 72  characters
  469.     wide  by  17  rows  high.   Also,  this  wait  file must not
  470.     contain any high ASCII characters.
  471.  
  472.     The second (and last)  mandatory file that must  exist prior
  473.     to compilation  is a  shipping text  file.   Identified with
  474.     the filename "SHIPPING.TXT", this file contains  information
  475.     on  the  shipping/mailing  methods  that  you  provide  your
  476.     customers with,  and their  costs.   A sample "SHIPPING.TXT"
  477.     file has been included with The Disk Vendor system that  you
  478.     received and  can be  used as  a guide.   Its format  is  as
  479.     follows:
  480.  
  481.     [Type of shipping]=[Cost]
  482.  
  483.     Where  [Type of shipping]  is  replaced   with   the   words
  484.  
  485.     identifying the type  of shipping/mailing method  available,
  486.     and where  [Cost]  is replaced with  the actual cost.  These
  487.     two parameters are linked together with a "=" equals symbol.
  488.     Here is  a real  life example  of a  "SHIPPING.TXT" file, so
  489.     that you can see better the format you must follow:
  490.  
  491.     USPS (US)=2.95
  492.     USPS (Canada)=5.00
  493.     USPS (Elsewhere)=7.00
  494.     UPS Ground (US)=4.00
  495.     UPS Blue (48 Sts)=7.00
  496.     UPS Blue (AL HI PR)=8.00
  497.     UPS Red (US)=16.00
  498.     UPS Red (AL HI PR)=19.00
  499.     Federal Express overnight=20.00
  500.  
  501.     You can have  one line in  your shipping file,  or 10 lines.
  502.     You have the choice  to add or delete  any lines.  The  only
  503.     requirement  is  that  at  least  one  line  exists  in  the
  504.     "SHIPPING.TXT"  file,  and  that   you  follow  the   format
  505.     outlined above.
  506.  
  507.     Having your  catalog files  (*.CAT) and  the "WAIT.TXT"  and
  508.     "SHIPPING.TXT"  files,  you  can  now  begin the compilation
  509.     process  if  you  wish.   These  files  are mandatory before
  510.     running COMPILE.EXE.   You may wish  to add some  additional
  511.     files, but this is optional (see next section).
  512.  
  513.  
  514.     OPTIONAL TEXT FILES TO INCLUDE IN YOUR CATALOG:
  515.  
  516.     Many businesses and  companies who use  The Disk Vendor  may
  517.     wish to add additional ASCII text files for their  customers
  518.     to view.   This can  be done  with an  editor, and  the only
  519.     requirements that The Disk Vendor impose are:
  520.  
  521.     1) The text  file must NOT  contain  control  characters nor
  522.     high ASCII characters > 126 (decimal).
  523.  
  524.     2) The  text file  must be  saved with  a filename extension
  525.     ".TXT"  (short  for  "text").   "BONUS.TXT",   "README.TXT",
  526.     "COUPON.TXT", "SPECIALS.TXT" are all valid text filenames.
  527.  
  528.     3) The   text file   can be   any length  in number  of rows
  529.     (within reason), but  must not exceed  72 characters/columns
  530.     in width.
  531.  
  532.     4) The first line of your  .TXT file must be reserved for  a
  533.     description  line.   This  reserved  description  line works
  534.     exactly  as  the  description  line  in  your  catalog files
  535.     (*.CAT).   This  description  line  will  appear in the Main
  536.     Menu  catalog  index  box  and  must  contain  less  than 35
  537.  
  538.     characters.   Again, this  description line  MUST reside  on
  539.     line 1 of your text file!
  540.  
  541.     What would you use .TXT files for?  Some possibilities are:
  542.  
  543.         To describe your company and its products.
  544.  
  545.         To display a discount coupon that the customer can
  546.         print using the PRINT SCREEN key and then redeem.
  547.  
  548.         To explain your return policies.
  549.  
  550.  
  551.     HELLO AND GOODBYE:
  552.  
  553.     Should  you  wish  to  create  a special opening screen that
  554.     your customer  views before  the Main  Menu screen  appears,
  555.     then  create  a  "hello"  file.   This  file is also created
  556.     using  an  editor,  and  must  be  saved  with  the filename
  557.     "HELLO.TXT".    Unlike   other   ASCII   text   files,   the
  558.     "HELLO.TXT" file can contain high ASCII graphic  characters.
  559.     This  will  enable  you  to  create  some attractive opening
  560.     screens with boxes  and shadows and  text.  The  "HELLO.TXT"
  561.     file  can  contain  up  to  25  lines  of  characters  by 80
  562.     characters  in  width  (the  size  of  a  normal  text  mode
  563.     screen).  Here is an example of what you could do:
  564.  
  565.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  566.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  567.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  568.       ▓▓▓▓▓┌───────────────────────────────────────┐▓▓▓▓▓▓▓▓▓
  569.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  570.       ▓▓▓▓▓│    XYZ COMPUTERS PROUDLY PRESENTS     │░░▓▓▓▓▓▓▓
  571.       ▓▓▓▓▓│        ITS WINTER 1995 SOFTWARE       │░░▓▓▓▓▓▓▓
  572.       ▓▓▓▓▓│          CATALOG ON A DISK            │░░▓▓▓▓▓▓▓
  573.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  574.       ▓▓▓▓▓│       Press any key to begin...       │░░▓▓▓▓▓▓▓
  575.       ▓▓▓▓▓│                                       │░░▓▓▓▓▓▓▓
  576.       ▓▓▓▓▓└───────────────────────────────────────┘░░▓▓▓▓▓▓▓
  577.       ▓▓▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓▓▓▓▓▓▓
  578.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  579.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  580.       ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  581.  
  582.  
  583.     Just remember  to include  an instruction  for your customer
  584.     to "PRESS ANY KEY TO CONTINUE..." or else you may find  your
  585.     customer  scratching  his  head  wondering  what to do next.
  586.     You may  never receive  an order  from him  because he could
  587.     not get past your opening screen!
  588.  
  589.     Likewise, if you  wish to have  a special message  appear at
  590.     the close of  the program, create  a "goodbye" file  with an
  591.  
  592.     editor.   Follow exactly  the same  guidelines as  described
  593.     above  for  the  "hello"  file,   but  save  this  file   as
  594.     "GOODBYE.TXT".   Again,  remind the customer with  a message
  595.     to press any key to exit the program!
  596.  
  597.     Both the "HELLO.TXT"  and "GOODBYE.TXT" files  are optional.
  598.     You may wish not to have opening or closing screens, or  you
  599.     may wish  to have  one but  not the  other.   This is  fine.
  600.     Just delete the files you  don't need, or don't create  them
  601.     in the first place.
  602.  
  603.     For  those  who  wish  to  use a high-resolution VGA graphic
  604.     image  in  the  place  of  the  text  based  HELLO.TXT   and
  605.     GOODBYE.TXT files, contact the author for details on how  to
  606.     incorporate .PCX  images at  the beginning  and/or close  of
  607.     your catalog.
  608.  
  609.  
  610.     THAT'S ALL FOLKS!:
  611.  
  612.     Speaking of "goodbyes", the  instructions above are all  you
  613.     need to get  you up and  running creating your  own personal
  614.     shareware catalog on disk.   We hope that you find  The Disk
  615.     Vendor a useful tool in marketing your products.
  616.  
  617.     Although we feel confident that  you will not find a  better
  618.     and  more flexible product  for marketing  your merchandise,
  619.     there is  one group  of distributors  that would do well NOT
  620.     to  use The Disk Vendor.  To  get specific, The  Disk Vendor
  621.     must  not  be used  by  vendors  who   distribute  so-called
  622.     "Adult"  (R/X-rated) products.  We  will not  be  a party in
  623.     helping vendors distribute such material.
  624.  
  625.  
  626.     SHAREWARE:
  627.  
  628.     The Disk Vendor is  shareware software and continued  use of
  629.     the program requires  you to support  the author.   Once you
  630.     have registered, you will receive the latest version of  The
  631.     Disk Vendor that will permit you to begin distributing  your
  632.     compiled  data  file  (CATALOG.DAT)  and the run-time module
  633.     (CATALOG.EXE) freely without royalties.
  634.  
  635.  
  636.     ALL IN THE FAMILY:
  637.  
  638.     Attention shareware distributors!!!!   If you would like  to
  639.     use  The  Disk  Vendor  to  distribute  public  domain   and
  640.     shareware software disks, we  have a special version  of The
  641.     Disk Vendor JUST  FOR YOU!   Custom tuned for  the shareware
  642.     industry,  The  Disk  Vendor  "shareware vendor" version has
  643.     features  unique  to  your  industry,  such  as   multi-disk
  644.  
  645.     prices,  separate  pricing  structures  for 360K, 720K, 1.2M
  646.     and 1.4M disk  sizes.  We  highly recommend this  "shareware
  647.     vendor" version  if you  need a  catalog on  disk system  to
  648.     distribute  your  shareware  library.   Contact  the program
  649.     author  with a SASE  or by phone to  learn more details.  Or
  650.     better yet, download a demo copy from our BBS: 703 372-9680.
  651.     The shareware file is named VEND??SW.ZIP where ?? represents
  652.     the current program version, or leave a message to SYSOP.
  653.  
  654.  
  655.     CAN I CONVINCE YOU TO CONVERT?:
  656.  
  657.     Question:  "I  currently  use  EmmaSoft's  Catalog-On-A-Disk
  658.     program to distribute  the  products we sell and would  like
  659.     to switch  to The  Disk Vendor.   What are  the  differences
  660.     between these two products, and can I salvage my COAD  *.TXT
  661.     files for use with The Disk Vendor?"
  662.  
  663.     Answer:
  664.  
  665.     1)  A  very  clean,  uncluttered,  attractive user interface
  666.     distinguishes   our   product   from   EmmaSoft's   product.
  667.     Your customers will find   it easier to  use,  and hopefully
  668.     order more products from you   if they can navigate   easily
  669.     through the on-disk catalog that you have provided them.
  670.  
  671.     2)  The  Disk  Vendor  run-time  distribution  .EXE   module
  672.     (CATALOG.EXE) is only 62000 bytes in size.  Our competitor's
  673.     product is approximately  81000 bytes.   So what?   The more
  674.     products you  offer your  customers, the  more products  you
  675.     are likely to sell.   The more disk space available  on your
  676.     distribution disk  means more  products you  can list.   The
  677.     smaller the  run-time .EXE  program, the  more products  you
  678.     can offer  your customer.   You know  how many  products you
  679.     can get into  19000 bytes of  disk space (the  difference in
  680.     size between our product  and theirs)?  Literally  hundreds!
  681.     The more  product selections  you offer  your customers,  or
  682.     the better you  describe your products,  the more disks  you
  683.     will  be  able  to  sell.   Free  disk  space  equals   more
  684.     potential sales.
  685.  
  686.     3)  On  your  distribution  disk  to your customer, only two
  687.     files need to  exist for your  on-disk catalog to  run using
  688.     The  Disk  Vendor  -  (CATALOG.EXE  and  CATALOG.DAT).   Our
  689.     competitor creates dozens of ".CM" files if you have  dozens
  690.     of  product  categories.   So  what,  you  may  ask?  Again,
  691.     getting back  to the  story of  available disk  space.   The
  692.     more available  space on  your distribution  disk, the  more
  693.     products  or   better  descriptions   you  can   offer  your
  694.     customers.  It is a hardware fact in DOS that if you have  a
  695.     file  on  a  360K  disk  that  is  only  11  bytes  long, it
  696.     actually will  take up  1024 bytes  of disk  space!  This is
  697.  
  698.     due  to  the  way  files  are  allocated  on  a  disk.   For
  699.     instance,  if  you  have  a  file  called  "HELLO.CM" and in
  700.     it contains  the letters  "HELLO WORLD",  although the  file
  701.     listed in  a DIR  command shows  the file  size as  11 bytes
  702.     long, it actually  displaces 1024 bytes  on disk.   Multiply
  703.     "HELLO.CM" two dozen times, and 264 bytes (24 x 11) now  has
  704.     displaced 24576 bytes!  Alright,  so what's the point?   The
  705.     point is that the more  files you have on your  distribution
  706.     disk, the more  disk space you  are most likely  wasting due
  707.     to partially  filled clusters.   The Disk  Vendor eliminates
  708.     wasted disk  space by  needing only  two files  to exist  on
  709.     your  distribution  disk  -  CATALOG.EXE  and   CATALOG.DAT.
  710.     Also,  needing  only  two  files  on  your distribution disk
  711.     makes file housekeeping chores much easier.
  712.  
  713.     4) The  compilation of  your catalog  ASCII text  files to a
  714.     single catalog  data file  (CATALOG.DAT) is  a one-step wham
  715.     bam, "run it once and  I'm done process".  Our  competitor's
  716.     product requires you  to compile two  dozen ".CM" files  one
  717.     at a  time if  you have  two dozen  product categories.  The
  718.     Disk  Vendor  saves  you  time,  compiling  ALL your catalog
  719.     ASCII files  automatically in  one swoop,  insuring that the
  720.     resulting  CATALOG.DAT  file  is  the  latest  and  contains
  721.     complete, up to date information.
  722.  
  723.     5) The  Disk Vendor  provides you  with a  utility that will
  724.     convert all  your Catalog-On-A-Disk  .TXT files  to The Disk
  725.     Vendor ASCII .CAT format.  Converting from our  competitor's
  726.     product to  The Disk  Vendor couldn't  be easier!   You lose
  727.     none of  your hard  work.   Copy the  file "COAD_CVT.EXE" to
  728.     the directory where you store your EmmaSoft COAD .TXT files,
  729.     then  run "COAD_CVT.EXE" from DOS.  This conversion  utility
  730.     will create new  catalog files (*.CAT)  that can be   placed
  731.     in  the  directory  where  The  Disk  Vendor  resides.
  732.  
  733.