home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT121.ZIP / MANUAL.TXT < prev    next >
Text File  |  1992-03-14  |  69KB  |  1,446 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                             CATALOG-ON-A-DISK
  11.  
  12.                   For viewing a catalog on your computer.
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                      Copyright ■1991-1992, EmmaSoft
  41.  
  42.                             TABLE OF CONTENTS
  43.  
  44.  
  45. LICENSE AGREEMENT AND WARRANTY. . . . . . . . . . . . . . . . . . . . .   3
  46.                 License . . . . . . . . . . . . . . . . . . . . . . . .   3
  47.                 Warranty. . . . . . . . . . . . . . . . . . . . . . . .   3
  48.  
  49.  
  50. CHAPTER ONE: INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . .   4
  51.                 1.1 What is this thing for????! . . . . . . . . . . . .   4
  52.                 1.2 USING THE PROGRAM . . . . . . . . . . . . . . . . .   4
  53.                 1.3 DEFINITIONS . . . . . . . . . . . . . . . . . . . .   5
  54.  
  55. CHAPTER TWO: VIEWING A CATALOG. . . . . . . . . . . . . . . . . . . . .   6
  56.                 2.1 HOW TO READ A CATALOG . . . . . . . . . . . . . . .   6
  57.                 2.2 VIEWING CATALOG INFORMATION AND ORDERING. . . . . .   6
  58.                 2.3 THE EXIT MENU . . . . . . . . . . . . . . . . . . .   7
  59.                 2.4 THE HELP BAR. . . . . . . . . . . . . . . . . . . .   9
  60.                 2.5 PRINTING THE CATALOG. . . . . . . . . . . . . . . .   9
  61.  
  62. CHAPTER THREE: MAKING A CATALOG . . . . . . . . . . . . . . . . . . . .  10
  63.                 3.1 HOW TO MAKE AN OPENING SCREEN FILE. . . . . . . . .  10
  64.                 3.2 HOW TO MAKE A HEADER FILE . . . . . . . . . . . . .  10
  65.                 3.3 HOW TO MAKE A CATALOG FILE. . . . . . . . . . . . .  11
  66.                 3.4 SAMPLE CATALOG FILE . . . . . . . . . . . . . . . .  13
  67.                 3.5 HOW TO MAKE AN EXIT SCREEN FILE . . . . . . . . . .  15
  68.                 3.6 HOW TO MAKE AN ORDER INFORMATION FILE . . . . . . .  16
  69.                 3.7 HOW TO MAKE COUPONS AND OTHER SPECIAL FORMS . . . .  17
  70.                 3.8 AUTOMATING SALES TAX AND SHIPPING/HANDLING. . . . .  17
  71.                 3.9 CHANGING HELP . . . . . . . . . . . . . . . . . . .  19
  72.  
  73.  
  74. CHAPTER FOUR:  THE COMPANION. . . . . . . . . . . . . . . . . . . . . .  20
  75.                 4.1 COMMAND LINE FUNCTIONS: . . . . . . . . . . . . . .  20
  76.                 4.2 INTERACTIVE MODE. . . . . . . . . . . . . . . . . .  21
  77.                 4.3 COMPRESSING CATALOG FILES . . . . . . . . . . . . .  21
  78.                 4.4 ASCII DELIMITED FILES:. . . . . . . . . . . . . . .  22
  79.                 4.5 EXPORTING CATALOG FILES:. . . . . . . . . . . . . .  22
  80.                 4.6 IMPORTING CATALOG FILES:. . . . . . . . . . . . . .  24
  81.                 4.7 CONVERTING V1 TO V2 . . . . . . . . . . . . . . . .  25
  82.                 4.8 COLORS. . . . . . . . . . . . . . . . . . . . . . .  26
  83.                 4.9 CURRENCY SYMBOL . . . . . . . . . . . . . . . . . .  26
  84.                 4.10 DEFINING A HELP BAR. . . . . . . . . . . . . . . .  27
  85.                 4.11  NATIONALITY SETTING . . . . . . . . . . . . . . .  27
  86.  
  87. CHAPTER FIVE:  COMMANDS . . . . . . . . . . . . . . . . . . . . . . . .  28
  88.                 5.1 COMMAND SUMMARY (CATALOG.EXE):. . . . . . . . . . .  28
  89.                 5.2 COMMAND LINE FLAG SUMMARY (CATCOM.EXE): . . . . . .  28
  90.  
  91.  
  92. CHAPTER SIX: FILES. . . . . . . . . . . . . . . . . . . . . . . . . . .  29
  93.                 6.1 EXPLANATION . . . . . . . . . . . . . . . . . . . .  29
  94.                 6.2 LIST OF FILES . . . . . . . . . . . . . . . . . . .  29
  95.  
  96. Appendix A:   Distributing Catalogs . . . . . . . . . . . . . . . . . .  31
  97.  
  98. Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  32
  99.  
  100. LICENSE AGREEMENT AND WARRANTY
  101.  
  102. License
  103.  
  104. 1. You may use the program on a single computer at one time.  You may not
  105.    copy the program and accompanying materials except for backup purposes
  106.    or to distribute it as shareware (see the section on distribution).
  107.  
  108. 2. You may not make copies of the program for sale.
  109.  
  110. 3. This software is copyrighted, and all rights therein are reserved for
  111.    EmmaSoft.  Registration or purchase of this product does not transfer
  112.    any right, title, or interest in the software except as specifically set
  113.    forth in this agreement.  You are hereby notified that the software
  114.    product is protected by United States Copyright Law, and you may be held
  115.    by responsible by EmmaSoft for any infringement of such rights or
  116.    violations to this agreement.
  117.  
  118. 4. This license is effective until terminated.  You may terminate it at any
  119.    time by destroying the program and all copies of it.  It will also
  120.    terminate if you fail to comply with any term or condition on this
  121.    agreement.  You agree upon termination to destroy the program together
  122.    with all copies of the program.
  123.  
  124. Warranty
  125.  
  126. 1. This program is provided "as is" without warranty of any kind, either
  127.    expressed or implied, including any warranty of merchantability or
  128.    fitness for a particular purpose.  In no event shall EmmaSoft be held
  129.    liable for any loss of profit, special, incidental, consequential, or
  130.    other similar claims.
  131.  
  132. 2. EmmaSoft does warrant that the magnetic media on which the software is
  133.    furnished is free of defects of materials and workmanship under normal
  134.    use for 60 days, provided that EmmaSoft provided your copy of the
  135.    program on such media.  If during this period the diskette should become
  136.    defective it may be returned to EmmaSoft for replacement without charge.
  137.  
  138. Governing law shall be that of New York State. CATALOG-ON-A-DISK MANUAL                                            page 4
  139. ===========================================================================
  140.  
  141. CHAPTER ONE: INTRODUCTION
  142.  
  143. 1.1 What is this thing for????!
  144.  
  145.  
  146.  
  147. CATALOG ON A DISK makes it easy for  your customers see your catalog on 
  148. their computers and order from it.  It is so easy to use that customers won't 
  149. put off ordering from you.  Also a disk catalog is economical to produce, 
  150. compared to printed ones.  It's simple for your customers to find what 
  151. items they want by browsing or searching, and generate an order form that can 
  152. be mailed, faxed, or sent to you by modem.  You can configure your catalog 
  153. to give it your company's distinctive look.
  154.  
  155. Each category can hold from 61 to 790 items, including their order number,
  156. name, price and a zero to twelve line long description of the product.  You
  157. may have a total of 99 categories (for a total of up to 78210 items,
  158. depending on the length of the long description, and disk space permitting). 
  159. Your catalog is kept in compressed files so more product listings can fit on
  160. the disk.  These are very easy to create on any word processor or text editor
  161. that can save files in pure ascii format.  Then use the CATALOG-ON-A-DISK
  162. Companion to compress the files.
  163.  
  164. 1.2 USING THE PROGRAM
  165.  
  166. CATALOG-ON-A-DISK is two programs.  
  167.  
  168. The first, CATALOG.EXE is a catalog reader.  This is what you send to your
  169. customers.  It displays your catalog, and lets your customers browse or
  170. search for items to order.  It prints out order forms, coupons, and it can
  171. even print the catalog on a printer.
  172.  
  173. CATCOM.EXE is the companion program that assists you in creating and
  174. maintaining your catalog.  It is for your use only and you do not send this
  175. to customers.
  176.  
  177. For building and maintaining catalogs you should have a catalog directory on
  178. your hard disk (you may do this on a floppy disk if you prefer).  You should
  179. keep all of the text files you use to make your catalogs here as well as the
  180. CATALOG and CATCOM programs, the compressed (.CM) files, and any related
  181. files.  You then copy the files you need onto a master disk (a floppy) which
  182. you will then duplicate for your customers' copies of the catalog.
  183.  
  184. The file CATALOG.INI is a very important file for both programs.  It is the
  185. initialization file that tells the two programs which screen colors to use,
  186. and holds other important information the programs need internally.  For
  187. example, if you want to change screen colors you use CATCOM to do it.  If
  188. CATALOG is in the same directory and disk you'll see the colors have changed
  189. the next time you use it.  When you copy CATALOG.EXE onto the master disk
  190. make sure you also copy CATALOG.INI along with all of your catalog files. CATALOG-ON-A-DISK MANUAL                                            page 5
  191. ===========================================================================
  192.  
  193. 1.3 DEFINITIONS
  194.  
  195. In this manual a few terms are used:
  196.  
  197. Ascii Delimited    A file that has been saved in pure ascii (American
  198.                    Standard Code for Information Exchange) format (most word
  199.                    processors, data bases, etc. can do this), that has one
  200.                    or more data fields delimited by quotation marks and
  201.                    commas.
  202. Catalog File       A compressed file containing catalog information with the
  203.                    extension ".CM".  The format for these files is described
  204.                    in section 3.3. 
  205. Default File       A file CATALOG ON A DISK uses for anything except catalog
  206.                    information, such as the opening screen, the main menu
  207.                    header, and so on.  Most of these files have the
  208.                    extension .CM.
  209. Field              A database term meaning a type of information (such as a
  210.                    name, address, etc.).
  211. Menu               A box in CATALOG ON A DISK containing several items that
  212.                    are chosen by placing the menu bar over the item you
  213.                    want. CATALOG-ON-A-DISK MANUAL                                            page 6
  214. ===========================================================================
  215.  
  216. CHAPTER TWO: VIEWING A CATALOG
  217.  
  218. 2.1 HOW TO READ A CATALOG
  219.  
  220.  
  221. Start the program by typing CATALOG (Enter).
  222.  
  223. The Opening Screen Comes on.  This will be one or more screens full of
  224. company information, instructions, or other information.  To go to the next
  225. screen press any key until you get to the main menu screen.
  226.  
  227. At any menu you may use the following keys:
  228.  
  229. (Alt) (x)    Exit the program
  230. (Esc)        Back out of current window
  231. (F1)         Help
  232. (Alt) (i)    Program Information
  233. (Alt) (p)    Print the whole catalog
  234. (Alt) (h)    Display a Help Bar
  235. (PgUp)       More Categories or Products
  236. (PgDn)       More Categories or Products
  237.  
  238. When viewing the category menu or categories that are larger than one screen
  239. the arrow keys work as follows:
  240.  
  241. (Up)         Up one choice.  Scrolls to next screen full.  Stops at first
  242.              choice.
  243. (Down)       Down one choice.  Scrolls to next screen full.  Stops at last
  244.              choice with a message.
  245. (Left)       Same as up arrow, but wraps to the bottom of the window instead 
  246.              of scrolling.
  247. (Right)      Same as down arrow, but wraps to the top of the window instead 
  248.              of scrolling.
  249.  
  250. 2.2 VIEWING CATALOG INFORMATION AND ORDERING
  251.  
  252. The Main Menu Screen may have information on the left of the screen and a
  253. menu at the right.  The menu shows up to twenty categories of items at a time
  254. you may look up and order.  If there are more than twenty use (PgUp) and
  255. (PgDn) to view more.
  256.  
  257. To choose a category place the menu bar over it, using the arrow keys to move
  258. the bar and press (Enter).
  259.  
  260.  
  261. CATALOG-ON-A-DISK MANUAL                                            page 7
  262. ===========================================================================
  263.  
  264. Now you will see a screen full of catalog items.  If there are more items 
  265. than you can see on one screen use the (PgUp) (PgDn) (Home) (End) keys to 
  266. see more items.  When you see an item of interest place the menu bar over 
  267. it and press enter.  (To return to the main menu press (Esc).)
  268.  
  269. You may search for an item by pressing (alt) (s).  This is not a case
  270. sensitive search.  If you are looking for an item called "widget" type
  271. "widget" when prompted.  Type (Enter) to search forward from the current
  272. item, or (b) to search forward from the beginning of the file.  This search
  273. will find "WIDGET" or "Widget".
  274.  
  275. The search function looks through the entire catalog entry.  This means that
  276. if a word, or part of a word exists anywhere in the order number, short
  277. description, price, or long description CATALOG-ON-A-DISK will find it.  This
  278. is perfect for product listings that use key words in the long descriptions.
  279.  
  280.  
  281.  
  282. Now you will see a product description (if it is present in the file).  To
  283. order this product press (Enter), or press (Esc) to back out.
  284.  
  285. Type the number of this product you want to order.  CATALOG-ON- A-DISK
  286. confirms your order and gives you the total for that number of items.  To
  287. accept this order press (Enter) .  To change the quantity press (r) and re-
  288. enter the quantity you want.  To exit without ordering this item press (Esc).
  289.  
  290. You may back into the main menu screen to choose other categories to order
  291. from.  When you are done ordering go to the main menu screen and press
  292. (Enter).  You may order up to 200 different items in one session.
  293.  
  294. 2.3 THE EXIT MENU
  295.  
  296.  
  297. Now you see the Exit Menu.  From Here you may
  298. print an order form, view your order, go back to the main menu screen to
  299. order more items, enter your name and address, or leave the program.
  300.  
  301.  
  302. Printing an Order Form:
  303.  
  304. You can print the order form to your printer (to mail or fax) or to a file on
  305. your disk (to send by modem if the company accepts orders this way).  If
  306. printing on your printer MAKE SURE YOUR PRINTER IS ON LINE AND READY.
  307.  
  308. When printing to a file you will be prompted for a file name.
  309.  
  310. A catalog can be set up to work in a few different
  311. ways that affect how you must deal with sales taxes and shipping/handling
  312. charges. CATALOG-ON-A-DISK MANUAL                                            page 8
  313. ===========================================================================
  314.  
  315. If the order form prints without asking you for any information you may have
  316. to fill in the taxes and shipping/handling charges by hand, and add the final
  317. total yourself.
  318.  
  319. A catalog may be set up so it will check the state or province you entered in
  320. your address (see section on name and address below), and if it finds a match
  321. it automatically charges the appropriate sales tax.  If you are ordering from
  322. a different state or province it will not charge the tax.
  323.  
  324. Another way a catalog may be set is to ask you how much tax to charge.  In
  325. this case a window pops up, and you fill in a percent.  Press (Enter) for no
  326. sales tax.
  327.  
  328. Some catalogs will have a menu of shipping and handling options.  If so, a
  329. menu of these options will pop up while the order form is printing, so you
  330. may make the appropriate choice.
  331.  
  332. Reviewing Your Order:
  333.  
  334. Here you can see what you have ordered with the subtotal for the whole 
  335. order (tax, shipping, etc. is not included here).  If there are more 
  336. items than can be seen on one screen you may view the rest by using 
  337. (PgUp) (PgDn) (Home) (End).
  338.  
  339. To delete an item press (Del) and type the number of the item you want to
  340. delete.  The subtotal will be adjusted.
  341.  
  342.  
  343.  
  344. Go Back To Catalog:
  345.  
  346. If you want to add items to your order you can go
  347. back to the main menu screen and order more
  348. products.
  349.  
  350. Name and Address:
  351.  
  352. CATALOG ON A DISK will remember your name
  353. and shipping address, and print it on your order form
  354. whenever you order if you enter it here.  This is great
  355. if you order from the catalog a lot, or even if you only order a few times.
  356.  
  357. Special Forms:
  358.  
  359. If special forms, coupons, company descriptions,and so on have been included
  360. with a catalog this menu item will appear on the exit menu.  When you choose
  361. it a menu appears with a choice of forms to print out.  First make sure your
  362. printer is ready, then place the menu bar over your choice and press enter.
  363. CATALOG-ON-A-DISK MANUAL                                            page 9
  364. ===========================================================================
  365.  
  366. Exit:
  367.  
  368. You may exit the program by choosing this option. 
  369. You may exit to DOS at any menu by pressing (Alt) (x).
  370.  
  371.  
  372. 2.4 THE HELP BAR
  373.  
  374. To display a bar at the bottom of the screen with reminders of the most used
  375. keystrokes press (Alt) (h).
  376.  
  377.  
  378.  
  379. 2.5 PRINTING THE CATALOG
  380.  
  381. If you want a printout of the catalog make sure your printer is ready (and
  382. has plenty of paper) and press (Alt) (p).  The catalog will be printed
  383. including the first screens, the categories in alphabetical order, a blank
  384. order form, and special forms (coupons, etc).  This takes some time, so you
  385. should be sure you want to do it before starting. CATALOG-ON-A-DISK MANUAL                                            page 10
  386. ===========================================================================
  387.  
  388. CHAPTER THREE: MAKING A CATALOG
  389.  
  390. For each category of items you want in your catalog you need to create a
  391. Catalog file.  You also need to create an Opening Screen file and a Header
  392. file, and an Order Information File.  Any ASCII characters may be used in
  393. these files.  
  394.  
  395. However, you should be aware that some printers
  396. don't print the upper ascii characters (128-255) as expected.  If printing
  397. catalogs is very important for your customers you'll want to stick to the
  398. lower 127  (of course upper and lower case letters, normal punctuation, and
  399. numbers are all contained within the lower ascii set). 
  400.  
  401. You could note this as part of your opening screen, and point out that if a
  402. printer has an "IBM" setting it will probably print all the ascii characters.
  403.  
  404.  
  405. 3.1 HOW TO MAKE AN OPENING SCREEN FILE
  406.  
  407. The Opening Screen file is the first information your
  408. customer sees when he or she starts the catalog program.  This can be your
  409. company name, a brief general description of how to order, something about
  410. your products or whatever.  You will want to keep this fairly short.
  411.  
  412. Using an ASCII text editor you can create the opening screen(s) that your
  413. customers will see.  This information will be shown, a screen at a time, to
  414. your customers when they first start the program.  
  415.  
  416. Make sure that no line is wider than 76 characters, and that you press Enter
  417. at the end of the last line to put a newline character there (otherwise the
  418. last line won't show up on the screen).  
  419.  
  420. Each screen has 23 lines (rows), so if you have more than one screen you
  421. should start screen 2 on line 24, screen 3 on line 47, and so on.
  422.  
  423. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  424. CATALOG FILES" below).  The name of this file MUST be FIRST.TXT.
  425.  
  426. 3.2 HOW TO MAKE A HEADER FILE
  427.  
  428. The HEADER is the information that appears on the
  429. menu screen, just above the menu choices.
  430.  
  431. Use an ASCII text editor to create a file. This can have your company name,
  432. a slogan, special help, advertising, or whatever you want.
  433.  
  434. CATALOG-ON-A-DISK MANUAL                                            page 11
  435. ===========================================================================
  436.  
  437. Make sure that no line is wider than 40 characters, and that you press
  438. (Enter) at the end of the last line to put a newline character there
  439. (otherwise the last line won't show up on the screen).  This information
  440. appears on the left of your screen, while the categories menu appears on the
  441. right.  If you only have a few categories you may make the lines below the
  442. menu 78 characters wide to give additional information.  Experiment with how
  443. this looks.
  444.  
  445. This file should be 23 or fewer lines long.
  446.  
  447. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  448. CATALOG FILES" below).  The name of this file MUST be HEADER.TXT.
  449.  
  450.  
  451. 3.3 HOW TO MAKE A CATALOG FILE
  452.  
  453. Using an ASCII text editor it is easy to make a
  454. catalog file.  There are three parts of a catalog file:  The category title,
  455. the header line, and description blocks.  Just follow this format:  
  456.  
  457. Title:       Line one of the file is the category title.  Type your title,
  458.              and if you want to password protect your file type a vertical
  459.              line and your password.
  460.  
  461. Header Text: Line two can be a line for the category header.  This is
  462.              optional, and it can contain any text.  It should begin with
  463.              a double tilde symbol so CATALOG-ON-A-DISK will know it is 
  464.              for your header.  These symbols will not appear on the 
  465.              screen. For example you might want the header to say:
  466.  
  467. ~~Order #:  Product Description:     List Price:      Your Price:
  468.  
  469.                 Another choice is to use it for an advertising banner:
  470.  
  471. ~~===WIDGETWARE is Your Choice In Tee Shirts!===
  472.  
  473. Description 
  474. Blocks:      These are followed by one description block per item in your
  475.              catalog.  A description block consists of from 1 to 13 lines.  
  476.              On the top line is the marker, item number, a short product
  477.              description, and the price.  These items must be in this order. 
  478.              This is followed by a zero to twelve line product write-up 
  479.              (long description).
  480.  
  481. Marker:      You have to use a ~ symbol at the beginning of the top line 
  482.              of each description block.  It must be the left most character 
  483.              on the line with no other characters or spaces in front of it.  
  484.              This is mandatory.
  485.  
  486. CATALOG-ON-A-DISK MANUAL                                            page 12
  487. ===========================================================================
  488.  
  489. Order Number  Can be any combination of numbers, letters and punctuation. 
  490.               Must have NO blank spaces.  If you do not use order numbers
  491.               you must leave one blank space at the beginning of the line,
  492.               after the marker.  Order numbers are optional.
  493.  
  494. Short Desc:   Can be any number of letters, numbers and words as long as it
  495.               fits with the Order Number and Price on 1 line (75 characters
  496.               total maximum).  This is mandatory.
  497.  
  498. Price:        Must be numbers and decimal point only.  The best format to
  499.               use is XXX.XX where you show two numbers after the decimal
  500.               point, even if it is an even dollar figure.  This is
  501.               mandatory.   Some good examples:                
  502.               .55     132.12     12.00
  503.  
  504. Write-Up:     This can be any text, from 0 to 12 lines long. If you don't 
  505.               want to use long description write ups, you don't have to.  
  506.               This is optional.
  507.  
  508.  
  509. Line#  What To Type:                                                                        # of chars Description
  510. ------+-------------------------------------+-----------+-----------------
  511. 1     |~Menu Title | Password               |28 | 20    |Title | Password
  512. ------+-------------------------------------+-----------+-----------------
  513. 2     |~~Header Text  (optional)            |76         |Category Header
  514. ------+-------------------------------------+-----------+-----------------
  515. 3     |~Order#  Short Description    Price  |75         |Description
  516. 4     |Product Description                  |75         |Block
  517. 5     |Product Description                  |75         |
  518. 6     |Product Description                  |75         |(13 Line Maximum)
  519. etc.  |                                     |           |
  520. ------+-------------------------------------+-----------+-----------------
  521.  
  522. Etc.
  523.  
  524.  
  525. A catalog text file may have a maximum of 794 lines, including the title, all
  526. the description blocks and the final line.
  527.  
  528. Catalog files may have any name except the following:
  529.  
  530. first header manual cmhelp cmoshelp orderinf manual temp
  531.  
  532. Make sure that you press Enter at the end of the last line to put a newline
  533. character there.  When the file is finished you must compress it (see section
  534. 4.3, "COMPRESSING CATALOG FILES" below).
  535. CATALOG-ON-A-DISK MANUAL                                            page 13
  536. ===========================================================================
  537.  
  538. 3.4 SAMPLE CATALOG FILE
  539.  
  540.  
  541. Shareware | my_password
  542. ~~Order #:    Product Description:                                Your Price:
  543. ~SW2002      Programmer's SUPER-MAINT     Evaluation Disk        4.00
  544. Programmer's SUPER-MAINT is the make
  545. utility that simplifies your program
  546. building chores.  SUPER-MAINT builds
  547. your make files and response files           
  548. for you, and remembers all your command line flags and even the name of 
  549. the make file, so all YOU need to remember is "sm <Enter>."  No need to 
  550. memorize complicated macro assignments for special program builds.
  551.  
  552. Just point and shoot at the source code files you want to include in your 
  553. program.  Automatic installation, user configurable, context sensitive 
  554. help, mouse support, online manual,  and more!  Supports Microsoft, Borland, 
  555. Aztec, Clipper and Mix programming languages.  ASP shareware from EmmaSoft
  556. ~SW4004      Mah Jongg                    Evaluation Disk        4.00
  557. Mah Jongg is a colorful and addictive solitaire game.  It's played
  558. with a set of 144 tiles and the object is to remove pairs of tiles
  559. from the playing board until the board is cleared.  It sounds easy,
  560. and it is easy to learn the basic rules, but success is elusive.
  561. Includes many features such as undo, multiple saved games, extensive
  562. player statistics, help, shell to DOS, etc.
  563. ~SW4007      ZPAY 3 Payroll System        Evaluation Disks (2)   8.00
  564. ZPAY 3 is the easiest to use and most flexible payroll package for the PC
  565. ever!  Pays salaried, hourly, commissioned, 1099 type payments by any pay
  566. period.  Prints checks, W2's and a multitude of reports.  Has data 
  567. exporting so you can manipulate the data with other applications such as a 
  568. spreadsheet program.  Supports laser printers as well as your pin feeders.  
  569. Manual has a "test ride" tutorial to make learning a snap!  ASP Shareware
  570. ~SW4008      TSR Download                 Evaluation Disk        4.00
  571. A soft font manager for LaserJet and DeskJet printers.  Pops up over your
  572. application to find your fonts automatically and displays them in English.
  573. Compress fonts so they occupy 1/6 the disk space.  Program remembers the
  574. fonts in your printer and their RAM requirements.  Create landscape fonts
  575. on the fly, offers scalable font support, works from DOS or Windows, all in
  576. a 7K TSR.  ASP Shareware  $45 (registration) from Elfring Soft Fonts.
  577. ~SW4009      Easy Format                  Evaluation Disk        4.00
  578. Protect your data.  Never send out a faulty disk again!  Easy format
  579. provides you with 4 disk testing methods, six bad spot marking options,
  580. custom boot messages, and more (includes a DESQview-specific version for
  581. formatting in the background).  Easy Format from Falk Data Systems.
  582. CATALOG-ON-A-DISK MANUAL                                            page 14
  583. ===========================================================================
  584.  
  585. ~SW4010      PC-Draft-Cad                 Evaluation Disk        4.00
  586. Vector based CAD:  Automatic dimensions, unlimited layers, multiple fonts &
  587. Object libraries.  Virtual memory - Extended, Expanded memory or disk for
  588. drawings up to 32 Megabytes.  Pop up menus or single keystroke commands.
  589. Context sensitive help.  Over 65 commands + undo/redo, pan, zoom, fill 
  590. pattern, macros.
  591. CGA, EGA, VGA, Hercules.  Mouse Optional.  Prints exact scale on HPGL 
  592. plotters, dot matrix, laser printers.  Exports WPG GEM HPGL ASCII.  
  593. Imports WPG DXF ASCII.
  594. ~SW4011      By The Numbers               Evaluation Disk        4.00
  595. Uses the philosophy of Numerology to analyze your name and birthdate for 
  596. their symbolic meaning and metaphysical vibrations, giving you a complete 
  597. personality profile, and a forecast for the coming year.  Professional 
  598. looking reports can be editied for truly personalized interpretations.  
  599. Simple installation, user configurable, and more!  ASP shareware from
  600. R.K. West Consulting
  601. ~SW4012      DMPLAS                       Evaluation Disk        4.00
  602. Background (TSR) program that translates Epson Printer output to HP 
  603. LaserJet.  Handles both text (elite, pica, condensed, bold, italic, wide, 
  604. superscript, subscript, etc.) as well as graphics.  Takes only 6K of memory.
  605. Extend the life of your programs.  ASP shareware from Software Co-op.
  606. ~SW4013      STACKEY (with BATUTIL)       Evaluation Disk        4.00
  607. STACKEY (bundled with BATUTIL) has the basic function of stacking keystrokes.
  608. It uses English like F1 for the F1 key rather than cryptic hex codes.  It
  609. includes simulated pressing of lock keys, shifts, support for Carousel, 
  610. Desqview and hotkey/screen reading script control.  PC Magazine called it
  611. the 'ultimate batch enhancer' and PC World and PC Computing included it in
  612. "Best Of.." articles.
  613. ~SW4015      ReNamer                      Evaluation Disk        4.00
  614. ReNamer - A professional tool for programmers.
  615. ReNamer converts file and symbol names across the many types of files that
  616. make up an application - source code, MAKE files, DOS batch files, and 
  617. documentation.  Use ReNamer when you want to port your software to another 
  618. platform or when you want to globally change your naming conventions.
  619. ~SW4018      4Print 4.1                   Evaluation Disk        4.00
  620. 4Print is a paper-saving utility for the HP LaserJet, DeskJet
  621. and compatibles which prints 4-6 or more pages of text on each sheet.
  622. Can print double-sided on any LaserJet or DeskJet, even non-
  623. duplex models!  Perfect for progam listings and documentation; 
  624. can also print wide spreadsheet and database reports.  Includes 
  625. 4Book utility for printing handsome, pre-collated booklets that
  626. you just take from the printer and fold in half.  Optional
  627. Windows interface also included.  Supports A4 paper.  "Way cool...
  628. Many useful features" -- Bill Machrone, PC Magazine 1/28/92
  629. ~SW4020      PopDBF v4.0 4K TSR           Evaluation Disk        4.00
  630. PopDBF is a memory resident program which provides "instant access" to your
  631. dBase compatible .DBF files at any time.  Use it from DOS or inside other
  632. programs!  Just press the hotkey and your database information is 
  633. "instantly" available!  Append, Browse, Delete, Edit, Print, Search records,
  634. and much more!  ASP shareware from Bowen Software.
  635. CATALOG-ON-A-DISK MANUAL                                            page 15
  636. ===========================================================================
  637.  
  638. ~SW4022      TCXL User Interface System   Evaluation Disk        4.00
  639. The TesSeRact CXL User Interface Development System is one of the fastest
  640. and smallest Windowing packages available.  With modules of Extended and 
  641. Expanded Memory (DPMI, VCPI and XMS fully supported), String Handling, 
  642. Mouse Support and more, the library is currently being used by millions of 
  643. developers all over the world.
  644.  
  645. It contains over 400 multi-purpose functions which provide a variety of
  646. capabilities, and supports many popular C compilers, including Microsoft
  647. C (version 5.1 and 6.0), Quick C, Turbo C 2.0, and Turbo C++ 1.0, and
  648. Zortech C/C++ 2.1.
  649.  
  650. ASP shareware from Innovative Data Concepts.
  651. ~SW4025      Personal Calendar for DOS    Evaluation Disk        4.00
  652. Personal Calendar (PC) is a Personal Information Manager (PIM) which
  653. contains an appointment reminder, and a notepad.  PC displays a three-
  654. month scrollable calendar, a running analog and digital clock, and a
  655. time-oriented event (to-do) list and text note list, each 300 in
  656. capacity.  A modifiable unlimited historical tracking (diary) is made of
  657. events and notes, all printable.  Warnings and alarms tell when something
  658. is pending or overdue (ticklers).  Driven by a simple flexible menu
  659. interface, Personal Calendar can be a normal TSR (pop up) program, as
  660. you choose;  TSR use interrupts you at the earliest event.  As a TSR, an
  661. extremely small 6K byte kernel remains in DOS memory, with the balance
  662. swapped to EMS or disk.  TSR programming is extremely stable and
  663. environment-sensitive.   ASP shareware.
  664. ~SW4026      BOXER Text Editor            Evaluation Disk        4.00
  665. BOXER is a full-featured text editor with 512-level undo, full mouse 
  666. support, support for extended video modes, multiple files & windows, 
  667. pull-down menus, column marking, editable keystroke macros, word 
  668. processing, and context sensitive online help.  Also: forward and 
  669. backward searches with wildcards, EMS swap for DOS shell, graphic 
  670. drawing, auto indent, find mating parenthetical characters, block: 
  671. sort, total, average, fill, print, invert, detab.  Dr. File Finder 
  672. says: "Feature for feature, BOXER is the BEST Shareware text editor 
  673. available today!"  (ASP) Shareware $35-50 from David R. Hamel.
  674. [End of file]
  675.  
  676.  
  677. 3.5 HOW TO MAKE AN EXIT SCREEN FILE
  678.  
  679. The Exit Screen File controls what your customer sees
  680. beneath the exit menu when it is displayed on the screen.
  681.  
  682. Use an ASCII text editor to create this file.  This can have your company
  683. name, a slogan, special help, advertising, or whatever you want.  You may
  684. want to talk about special forms, or give ordering instructions.
  685.  
  686. The first line has a color instruction, followed by up to 10 or fewer lines
  687. of text.   CATALOG-ON-A-DISK MANUAL                                            page 16
  688. ===========================================================================
  689.  
  690. The color instruction tells the program which colors to display the file in. 
  691. It should be one word with nothing else on the line with it.  Type Main to
  692. use the main screen colors, Hilight to use the hilight colors, or Help to use
  693. the help screen colors.
  694.  
  695. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  696. CATALOG FILES" below).  The name of this file MUST be EXIT.TXT.
  697.  
  698. 3.6 HOW TO MAKE AN ORDER INFORMATION FILE
  699.  
  700. When CATALOG ON A DISK prints an order form it looks for a file called
  701. ORDERINF.TXT.  If it finds this file it includes the information in it 
  702. on your order form.  This is where you put shipping information, tax 
  703. information, and any special ordering information, such as information 
  704. for charge card orders.  Because there are so many ways to do this, 
  705. CATALOG ON A DISK lets the customer fill in shipping, discount and tax 
  706. information.
  707.  
  708. Using an ASCII text editor you can create the Order Form Information file. 
  709. You should keep this file short, to keep the order form to one page.  It will
  710. be printed at the bottom of the order form.
  711.  
  712. +--------------------------------------------------------------------------+
  713. |New York Residents MUST Add Sales Tax                                     |
  714. |                                                                          |
  715. |Shipping and Handling:                     PAYMENT MUST BE IN U.S. FUNDS  |
  716. |Please add $3.00 for the first item        DRAWN ON A U.S. BANK.          |
  717. |1.00 each additional item                                                 |
  718. |Prices Good Through December 1992.                                        |
  719. |                                                                          |
  720. |I would like to pay by:                                                   |
  721. |__Check __Master Card __Visa    Card Number______________________________ |
  722. |                                Expiration Date__________________________ |
  723. |                                                                          |
  724. |                         CONSOLIDATED WIDGETS, INC.                       |
  725. |                 1000 Widget Industrial Park      Building 10             |
  726. |                            Widgetville, NY 14882                         |
  727. +--------------------------------------------------------------------------+
  728.  
  729.  
  730. Make sure that no line is wider than 78 characters, and that you press Enter
  731. at the end of the last line to put a newline character there (otherwise the
  732. last line won't show up on the screen).  
  733.  
  734. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  735. CATALOG FILES" below).  The name of this file MUST be ORDERINF.TXT. 
  736.  
  737. CATALOG-ON-A-DISK MANUAL                                            page 17
  738. ===========================================================================
  739.  
  740. 3.7 HOW TO MAKE COUPONS AND OTHER SPECIAL FORMS
  741.  
  742. CATALOG-ON-A-DISK can display a menu of special forms, coupons and so on. 
  743. These can contain special offers, company description, special instructions,
  744. and so on.
  745.  
  746. If forms exist CATALOG-ON-A-DISK adds a special menu item to the Exit Menu
  747. that reads Special Forms.  The customer can choose from a menu of forms and
  748. print them to a printer (the printer must be attached to LPT1 for this to
  749. work:  this prevents coupons from being printed to a file and changed by the
  750. customer).
  751.  
  752. Using an ASCII text editor you can create a Form file.  Type any printable
  753. ascii characters to make your form.
  754.  
  755. Make sure that no line is wider than 78 characters, and that you press Enter
  756. at the end of the last line to put a newline character there (otherwise the
  757. last line won't show up on the screen).  It is suggested that you keep forms
  758. below 60 lines.
  759.  
  760. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  761. CATALOG FILES" below).  The name of this file MUST have the extension .FRM in
  762. order for CATALOG-ON-A-DISK to place it in the Forms menu and treat it as a
  763. form.
  764. Example:  COUPON.FRM
  765.  
  766.  
  767. 3.8 AUTOMATING SALES TAX AND SHIPPING/HANDLING
  768.  
  769. You may choose the way your catalog handles sales taxes and shipping and
  770. handling charges on the order form.  The simplest way to handle this is to do
  771. nothing.  CATALOG-ON-A-DISK will print out blank spaces for sales taxes, S&H,
  772. and the final total that your customers can fill in manually.  In this case
  773. be sure to put your tax and S&H information in the ORDERINF file.
  774.  
  775. If you include a file called TOTAL.CM you can have CATALOG-ON-A-DISK figure
  776. sales tax and/or S&H automatically or semi-automatically.
  777.  
  778. When the file is finished you must compress it (see section 4.3, "COMPRESSING
  779. CATALOG FILES" below).  The name of this file MUST be ORDERINF.TXT. 
  780. CATALOG-ON-A-DISK MANUAL                                            page 18
  781. ===========================================================================
  782.  
  783. +--------------------------------------+
  784. | Total                                |
  785. | t NY | 7                             |
  786. | s USPS (US)            3.00 | 3.00   |
  787. | s USPS (Canada)        5.00 | 5.00   |
  788. | s USPS (Elsewhere)     9.00 | 9.00   |
  789. | s UPS Ground (US)      3.00 | 3.00   |
  790. | s UPS BLUE (48 Sts)    6.00 | 6.00   |
  791. | s UPS BLUE (AL HI PR)  8.00 | 8.00   |
  792. | s UPS RED (US)        15.00 | 15.00  |
  793. | s UPS RED (AL HI PR)  19.00 | 19.00  |
  794. | s Customer Pick Up     0.00 |  0.00  |
  795. | [End of file]                        |
  796. +--------------------------------------+
  797.  
  798. This file must use a specific format:  The top line in the file must have the
  799. word Total with nothing else (upper or lower case, or both is OK).
  800.  
  801. This should be followed by up to 13 lines that are formatted as follows:
  802.  
  803. If you want to automatically charge a specific sales tax percent for your
  804. state or province include a line that has a t at the beginning of the line
  805. (no spaces before it), then the name of the state or province (if a US state
  806. you should use the two letter indicator recommended by the post office. 
  807. Example: NY for New York).  Next there should be a pipe symbol (|) with a
  808. space on either side of it.  Finally the sales tax percent age that applies
  809. to your state.
  810.  
  811. Example:
  812.  
  813.                                 t NY | 7
  814.  
  815. Some states have different taxes in their various regions.  If this is the
  816. case in your state you set your tax line to 999.  CATALOG-ON-A-DISK will ask
  817. the customer to enter the tax rate only if he or she resides in the chosen
  818. state.
  819.  
  820. Example:
  821.  
  822.                                 t NY | 999
  823.  
  824. To include shipping and handling options you use a similar format.  You start
  825. with the letter s at the beginning of the line.  Next you type in the
  826. shipping option you want to appear on the shipping menu (it is recommended
  827. that you include the price here so your customers can see what they have to
  828. pay for various shipping options.  Follow that with a pipe symbol (|) with a
  829. space on either side of it.  And then type in the shipping price for that
  830. entry.
  831.  
  832. CATALOG-ON-A-DISK MANUAL                                            page 19
  833. ===========================================================================
  834.  
  835. Example:
  836.  
  837.                       s FedEx         8.50 | 8.50
  838.  
  839. You may have up to 12 options on this menu.  You are not required to have any
  840. if you don't want the shipping menu to appear in your catalog.
  841.  
  842. When you are done typing this file you must compress it using the -c option
  843. (see section 4.3, "COMPRESSING CATALOG FILES" below).  The name of the file
  844. must be TOTAL.TXT.
  845.  
  846. Some companies must collect sales tax in more than one state.  CATALOG-ON-A-
  847. DISK can be set to charge sales tax in just one state, or in all states.  You
  848. set this by calling CATCOM with the -sa flag (for all) or the -so (for one)
  849. from the DOS command line as follows:
  850.  
  851.                              catcom -s (Enter)
  852.  
  853. If you set CATALOG-ON-A-DISK for ALL states a window will pop up asking the
  854. customer to fill in the correct percentage of sales tax for his or her state. 
  855. You may still set one state to automatically charge a set percentage (using
  856. the total file) if you want to.  If you do the sales tax will automatically
  857. be figured in without asking for input from customers in that state.
  858.  
  859. Some states charge sales tax on shipping and handling as well as merchandise. 
  860. Use the -mo flag for merchandise only, or the -mb flag to set CATALOG-ON-A-
  861. DISK to charge tax on both.
  862.  
  863.  
  864. 3.9 CHANGING HELP
  865.  
  866. CATALOG-ON-A-DISK comes with two help files.  The first, CMHLP.CM, holds the
  867. text you see if you ask for help at the command line (by typing "CATALOG -
  868. h").  The second, CMOSHLP.CM, has the text you see when you press (F1) while
  869. viewing a catalog.
  870.  
  871. If you want to customize your own help files, create text files called
  872. CMHLP.TXT and/or CMOSHLP.TXT.  When they are as you want them compress them.
  873. (see section 4.3, "COMPRESSING CATALOG FILES" below). CATALOG-ON-A-DISK MANUAL                                            page 20
  874. ===========================================================================
  875.  
  876. CHAPTER FOUR:  THE COMPANION
  877.  
  878. Beginning with Version 2, CATALOG-ON-A-DISK has been split into two programs. 
  879.  
  880.  
  881. The catalog viewer, CATALOG.EXE, lets your customers view your catalog.  
  882.  
  883. CATCOM.EXE is the CATALOG-ON-A-DISK Companion, which helps you make your
  884. catalog.
  885.  
  886. In general you make these files in a text editor or word processor that has
  887. the capability to save text in pure ascii format.  Most word processors have
  888. this capacity.  Then you use CATCOM to compress your files into a form that
  889. CATALOG can read, and that take up less space on your disk.  You can also use
  890. CATCOM to change the colors of your catalog, to import and export catalog
  891. files to a data base or other program, and so on.
  892.  
  893. CATCOM can be run in two ways.  Command line mode lets you use CATCOM'S 
  894. capabilities using flags on the DOS command line.  For example, to compress
  895. a file you would type:
  896.  
  897. catcom -c myfile.txt (Enter)
  898.  
  899. CATCOM also has an interactive mode that allows you to perform tasks
  900. interactively within a menu driven program.  If you are new to CATALOG-ON-A-
  901. DISK you'll probably want to start with interactive mode.
  902.  
  903. To start the Companion in interactive mode type:
  904.  
  905.                                CATCOM (Enter)
  906.  
  907. Important NOTE:  Some functions work only in command line mode (such as tax
  908. settings), and others only in interactive mode (such as converting v1 to v2).
  909.  
  910. The main menu screen appears.  You are presented with four menu choices.  The
  911. first three are for making a file conversion.  The last lets you exit back to
  912. DOS.
  913.  
  914. In interactive mode at the main CATCOM menu press (Alt) (r) to review the
  915. current settings for tax, currency symbol, and other settings.
  916.  
  917.  
  918.  
  919. 4.1 COMMAND LINE FUNCTIONS:
  920.  
  921. CATCOM's catalog making functions can be called from the command line.  It is
  922. very easy to use these functions.  Normally you call CATCOM with a flag and
  923. a file name as follows:
  924.  
  925.  
  926.                        catcom [flags] [filename] (Enter) CATALOG-ON-A-DISK MANUAL                                            page 21
  927. ===========================================================================
  928.  
  929. NOTES:
  930.  
  931. ■The flags can be upper or lower case (ex.  -E or -e).
  932. ■You may use \ instead of - in flags (ex:  -e or \e).
  933. ■The filename may come before or after the flag.
  934.  
  935. 4.2 INTERACTIVE MODE
  936.  
  937. In interactive mode you are shown a main menu.  To go to a menu choice either
  938. press the first letter of the choice and then press (Enter), or use the arrow
  939. keys to go to your choice and press (Enter).
  940.  
  941. The menu choices are:  File Compression, Export a file, Import a file,
  942. Convert v1 to v2, Set Colors, and Leave.  All but the last two require you to
  943. specify a file you want to perform the operation on.
  944.  
  945. Both CATCOM.EXE and CATALOG.EXE use and operate on a file called CATALOG.INI. 
  946. This initialization file is vital to the working of both programs.  When you
  947. use CATCOM to set CATALOG-ON-A-DISK you must make sure that you ship the same
  948. copy CATALOG.INI with your catalogs that CATCOM operated on if you want those
  949. settings to take effect.
  950.  
  951.  
  952.  
  953. When you have made a choice a window appears in which you may type the name
  954. of the file.  If you remember the file name you may just type it here.  If
  955. you want to search for the file, press (F2).  Now you are asked for a search
  956. mask.  This tells CATCOM what type of file to look for.
  957.  
  958. If you want to search all the files on the current disk and directory just
  959. press (Enter).  This sets the default mask to "*.*", which is the same as the
  960. DOS mask for searching all files.  If you wanted to search for files that all
  961. have the .TXT extension, type "*.TXT".  Or if you want to only search files
  962. with CATALOG in their name type "CATALOG.*".  To search for a particular file
  963. type its full name.
  964.  
  965. Now press the space bar to toggle the files.  When you see the one you want
  966. press (Enter).  At any time you can press (Esc) to escape back.
  967.  
  968. Note that when exporting you must export from a catalog file.  All catalog
  969. files have the .CM extension.  CATCOM  automatically sets this extension for
  970. searching, so just press (Enter) when you see "*.CM" in the window.
  971.  
  972. 4.3 COMPRESSING CATALOG FILES
  973.  
  974. CATALOG ON A DISK gets all its information from compressed files.  Since
  975. compressed files are smaller than regular ASCII files you can fit more of
  976. them on
  977. a floppy disk.  It is easy to compress a file.  Let's say you want to
  978. compress HEADER.TXT. CATALOG-ON-A-DISK MANUAL                                            page 22
  979. ===========================================================================
  980.  
  981.  
  982. In interactive mode start CATCOM and choose File Compression.  Choose the
  983. file you want to compress (see section 4.3) and press (Enter).  CATCOM will
  984. compress the file for you.
  985.  
  986. At the DOS command line to compress a file called WIDGETS just type:
  987.  
  988.                          CATALOG -C WIDGETS
  989.  
  990. When CATALOG ON A DISK makes a catalog file it converts the tab character to
  991. spaces.  The default is eight spaces per tab.  If your word processor uses a
  992. different setting you may force CATALOG ON A DISK to use it by using the -T
  993. flag.  Call the program as above, but adding the -T flag followed by a
  994. number.  For example, to set the tabs in your widgets file to 6 spaces, type
  995.  
  996.                          CATCOM -C -T6 WIDGETS
  997.  
  998. Tab setting is not available in interactive mode.
  999.  
  1000.  
  1001.  
  1002. 4.4 ASCII DELIMITED FILES:
  1003.  
  1004. An ascii delimited file is a database file that only uses ascii characters
  1005. (does not have any special codes or headers).  Each field is identified
  1006. (delimited) by a system of commas and quotation marks.
  1007.  
  1008. Although this is supposed to be a standard that almost all data base, word
  1009. processor, etc. programs can read and write to there are some variations. 
  1010. For example, some programs just use a comma (,,,)for a blank field, while
  1011. others use quotes and commas ("","","",).  There are common general rules
  1012. that all these programs use, and CATCOM can read and write both variations.
  1013.  
  1014. 4.5 EXPORTING CATALOG FILES:
  1015.  
  1016. When you export a file CATCOM reads the compressed catalog file (.CM) and
  1017. translates it into ascii delimited format, placing the translated data in a
  1018. file of the same name, but with the extension .ASC.
  1019.  
  1020. From the main CATCOM menu choose Export a file.  Now you will be presented
  1021. with a menu of ascii delimitation formats.  Most databases read type 1, but
  1022. check yours to see which format is appropriate.
  1023.  
  1024. Place the menu bar on the correct choice and press (Enter).
  1025.  
  1026. To export a compressed catalog file to ascii delimited format ("field1",
  1027. "field2", "field3", field4") you call CATCOM from the command line, using the
  1028. -e flag.  The resulting file can then be imported into a Database, Word
  1029. Processor, etc.
  1030.  
  1031. CATALOG-ON-A-DISK MANUAL                                            page 23
  1032. ===========================================================================
  1033. Use the following syntax:
  1034.  
  1035.                        CATCOM -E FILENAME.CM
  1036.  
  1037. NOTES:  ■You do not have to use the file extension.
  1038.  
  1039.  
  1040. Some databases import and export numbers with no quotation marks around them
  1041. in the ascii delimited field.  For this reason a window has been added to
  1042. CATALOG-ON-A-DISK to allow you some flexibility in dealing with such a
  1043. situation.
  1044.  
  1045. Examples:
  1046.  
  1047. You want the default, which saves 15 fields: the order number, the short
  1048. description, the price, and 12 long description lines of up to 75 characters
  1049. each:
  1050.  
  1051.                                 Default Reg
  1052.  
  1053. Each line in the file will look something like this (it will probably all be
  1054. on one line, though):
  1055.  
  1056. "MS402", "Sixteen Ton Widget", "64.59", "The long description goes
  1057. here.....", "More Long Des", "More Long Des", "More Long Des", "More Long
  1058. Des", "More Long Des", "More Long Des", "More Long Des", "More Long Des",
  1059. "More Long Des", "More Long Des", "More Long Des"
  1060.  
  1061.  
  1062. You are using a number field for price, but not order number, and you do not
  1063. want quotations around the price.  To export in this format for a catalog
  1064. file called MYSTUFF.CM type the following at the command line:
  1065.  
  1066.                              Default P
  1067.  
  1068. "MS402", "Sixteen Ton Widget", 64.59, "The long description goes here.....",
  1069. "More Long Des", "More Long Des", "More Long Des", "More Long Des", "More
  1070. Long Des", "More Long Des", "More Long Des", "More Long Des", "More Long
  1071. Des", "More Long Des", "More Long Des"
  1072.  
  1073. You are using a number field for price and order number, and you do not want
  1074. quotations around them. To export in this format for a catalog file called
  1075. MYSTUFF.CM type the following at the command line:
  1076.  
  1077.                              Default Both
  1078.  
  1079. MS402, "Sixteen Ton Widget", 64.59, "The long description goes here.....",
  1080. "More Long Des", "More Long Des", "More Long Des", "More Long Des", "More
  1081. Long Des", "More Long Des", "More Long Des", "More Long Des", "More Long
  1082. Des", "More Long Des", "More Long Des"
  1083. CATALOG-ON-A-DISK MANUAL                                            page 24
  1084. ===========================================================================
  1085. 4.6 IMPORTING CATALOG FILES:
  1086.  
  1087. CATCOM can import catalog files from a database or other program that can
  1088. produce an ascii delimited file in the following format:  
  1089.  
  1090. "Item_Number", "Short_Description", "Price", "Long_Description"
  1091.  
  1092. Item_Number, Short_Description, and Price should have a total length of 70
  1093. characters or less.  Long_Description can be up to 296 characters long, but
  1094. should NOT have any line feed characters in it.
  1095. There should be a line feed after the last entry, or the last item on the
  1096. list won't be read in.
  1097.  
  1098. In interactive mode choose Import a file from the main menu, and choose an
  1099. ascii delimited file to import.
  1100.  
  1101. From the command line use the following syntax:
  1102.  
  1103.                           CATCOM -I FILENAME.ASC
  1104.  
  1105.  
  1106. CATCOM reads the file and a window pops up on the screen.  You are asked for
  1107. the Category Title.  This is what will appear on the menu your customers see. 
  1108. Next you are asked for a password.  (This protects your final compressed
  1109. catalog file from being exported).  If you don't want to use a password just
  1110. press (Enter).
  1111.  
  1112. Now the window shows the first record in the database.  Each line on the
  1113. screen shows one field for that record, and a chart appears on the left hand
  1114. side of the screen.
  1115.  
  1116. You must tell CATALOG-ON-A-DISK which record is which by filling in the
  1117. chart.
  1118.  
  1119. If the field is for your order number place a letter n
  1120. next to it.
  1121.  
  1122. If the field is for your short description place a letter d next to it.
  1123.  
  1124. If the field is for your price place the letter p next to it.
  1125.  
  1126. If you do not want to include the field as part of your catalog file, place
  1127. the letter x next to it.
  1128.  
  1129. After you have marked the above fields you may number the remaining fields
  1130. for inclusion in the long description.  Number the first field 1, the next
  1131. one 2, and so on.
  1132.  
  1133. CATALOG-ON-A-DISK MANUAL                                            page 25
  1134. ===========================================================================
  1135. Any unmarked fields will be added to the long description in the order in
  1136. which they appear.  Therefore, if all the long description fields are already
  1137. in order, from top to bottom, you can just leave those blank.
  1138.  
  1139. When you are done filling in the chart press (Enter).  CATALOG-ON-A-DISK will
  1140. import the file and take you back to DOS.
  1141. If your original data base didn't have a price field CATCOM gives you the
  1142. opportunity to fill in prices now.  However, if you want to save this for
  1143. later just tell it to leave all prices at 0.00 when prompted.
  1144.  
  1145.  
  1146. If you choose to leave the prices at 0.00 you will have to go into your .TXT
  1147. file later with a text editor to change the prices.
  1148.  
  1149. As each item is processed it appears on the screen.
  1150.  
  1151. When CATCOM is done importing it has created a file with the .TXT extension. 
  1152. You are asked if you want to compress the file now.  
  1153.  
  1154. You may want to check out the text file for its spacing before compressing
  1155. it.  However, if you compress it now it will instantly be readable by
  1156. CATALOG.EXE.  The .TXT file is not erased, so you can always go back later,
  1157. fix the .TXT file in your text editor and then compress the file again.
  1158.  
  1159. Now you have a file with the same name as the original file, but with a .TXT
  1160. extension.  This file should look just like a file you would make from
  1161. scratch in a word processor.  It is always a good idea to check this file for
  1162. spacing, and you may edit it in your word processor.
  1163.  
  1164. Finally you must compress the file using the -c flag.  Example:
  1165.  
  1166.                          CATCOM -C FILENAME.TXT
  1167.  
  1168. Now CATALOG-ON-A-DISK can read the new file.
  1169.  
  1170. 4.7 CONVERTING V1 TO V2
  1171.  
  1172. If you used a previous version of CATALOG-ON-A-DISK it is easy to convert
  1173. your old catalog files to the new format using CATCOM in interactive mode.
  1174.  
  1175. Simply choose Convert v1 to v2 and type in the name of the file you want to
  1176. convert.
  1177.  
  1178. Important Note:  You are converting the text file version of your catalog
  1179. file, not the compressed version.  Once the conversion has been done you must
  1180. still compress the new file.  CATCOM does not do this in one step, because
  1181. you may want to go back into the file with your text editor and add more
  1182. description lines, a password, or a category header.
  1183.  
  1184. CATALOG-ON-A-DISK MANUAL                                            page 26
  1185. ===========================================================================
  1186. When you view the new file you will notice that the ~ symbol has been placed
  1187. at the beginning of each product, and blank lines have been erased.  The
  1188. original file is given a new file extension "BAK."  So when you convert
  1189. WIDGETS.TXT the new file will have the original name, and the old version
  1190. will be called WIDGETS.BAK.
  1191.  
  1192. 4.8 COLORS
  1193.  
  1194. You may change the display colors by pressing alt-c at the main menu. There
  1195. are three types of screen colors:
  1196.  
  1197. Main:                           Most of the displays from CATALOG
  1198. Help:                           Help screens displayed when F1 is pressed
  1199. Hilight:                        Special messages generated by the program.
  1200.  
  1201. Use the right and left arrow keys to toggle the color choices.  press enter
  1202. when a choice is set.  If you don't like the colors you have set, press alt-c
  1203. to set them again.  NOTE:  The color change doesn't take full effect until
  1204. you exit and re-enter the program.
  1205.  
  1206. 4.9 CURRENCY SYMBOL
  1207.  
  1208. At certain points in the program and on the order form CATALOG-ON-A-DISK
  1209. displays prices with a currency symbol.  You can change this symbol to
  1210. reflect the one used for your country's currency.
  1211.  
  1212. There are two ways to set the currency symbol using CATCOM in command line
  1213. mode.
  1214.  
  1215. Since not all currency symbols appear on your keyboard, you may use the ascii
  1216. number (in decimal) to set yours.  For example, to use the British pound
  1217. symbol you could type:
  1218.  
  1219.                            CATCOM -*a156
  1220.  
  1221.  
  1222.  
  1223. For no symbol at all you should use the ascii number for a blank space:
  1224.  
  1225.                            CATCOM -a*32
  1226.  
  1227.  
  1228. If the currency symbol you want does appear on your keyboard you may use the
  1229. -*s flag.  To set the symbol to the dollar sign, for example, you would type:
  1230.  
  1231.                            CATCOM -*s$
  1232.  
  1233. CATALOG-ON-A-DISK MANUAL                                            page 27
  1234. ===========================================================================
  1235.  
  1236. 4.10 DEFINING A HELP BAR
  1237.  
  1238. The help bar appears on the screen when you press (Alt) (h) in CATALOG.EXE. 
  1239. If you want to use it you should add a message in your Help screen, or on
  1240. your header screen telling your customers that it is there.  You also have to
  1241. define the help you want displayed.
  1242.  
  1243. Defining a help bar is easy.  On the command line type:
  1244.  
  1245.                                    CATCOM -hb
  1246.  
  1247. A Box will pop up.  You can type anything you want in the box.  When you
  1248. press (Enter) it will be saved.
  1249.  
  1250. Use -h+ to make it the default, or -h- to turn it off. 
  1251.  
  1252. 4.11  NATIONALITY SETTING
  1253.  
  1254. CATALOG-ON-A-DISK now supports two customer address formats:  United States
  1255. and European/Canadian styles.  You use the -nu (Nationality) flag to set the
  1256. program to US style, and 
  1257. -ne for European/Canadian.  To do this type:
  1258.  
  1259.                              catalog -nu
  1260.  
  1261. The program will respond, "CATALOG-ON-A-DISK set for US Style Address", or
  1262. "CATALOG- ON-A-DISK set for European Style Address."
  1263.  
  1264. Examples:
  1265.  
  1266. US Style                   European/Canadian
  1267. Name                       Name
  1268. Address                    Address
  1269. Address                    Address
  1270. City, State Zip Code       City, Province or County, Postal Code
  1271. Country                    Country
  1272. CATALOG-ON-A-DISK MANUAL                                            page 28
  1273. ===========================================================================
  1274. CHAPTER FIVE:  COMMANDS
  1275.  
  1276.  
  1277. 5.1 COMMAND SUMMARY (CATALOG.EXE):
  1278.  
  1279. (Esc)            Exit
  1280. (alt) (i)        Program Information
  1281. (alt) (x)        Exit
  1282. (Alt) (p)        Print the whole catalog
  1283. (Alt) (h)        Display a Help Bar
  1284. (F1)             Help
  1285. (PgUp) (PgDn)    See more than 20 Categories or Products
  1286. (Up) (Dn)        Up or Down 1 Category or Product
  1287. (Lt) (Rt)        Up or Down 1 Category or Product
  1288.  
  1289. 5.2 COMMAND LINE FLAG SUMMARY (CATCOM.EXE):
  1290.  
  1291.  -c             Compress a text file to make a catalog file
  1292.  -e             Export a compressed catalog file to ascii delimited format
  1293.  -i             Import an ascii delimited file to a text file
  1294.  -t#            Expand tabs to # spaces
  1295.  -hb            Set Help Bar Text
  1296.  -h+            Set Help Bar On  (-h- Sets Help Bar Off)
  1297.  -nu            Set Nationality address format to US style
  1298.  -ne            Set Nationality address format to European/Canadian style
  1299.  -so            Charge Sales Tax in One State 
  1300.  -sa            Charge Sales Tax in All States
  1301.  -mo            Tax merchandise only
  1302.  -mb            Tax both merchandise and Shipping & Handling
  1303.  -*a            Set currency character using ascii number (numbers in 
  1304.                 decimal.  32 for blank)
  1305.  -*s            Set currency character using symbol
  1306. CATALOG-ON-A-DISK MANUAL                                            page 29
  1307. ===========================================================================
  1308.  
  1309. CHAPTER SIX: FILES
  1310.  
  1311.  
  1312. 6.1 EXPLANATION
  1313.  
  1314. When you want to look at a catalog, CATALOG looks for Default Files and
  1315. Catalog Files.  All of the files have the .CM extension.
  1316.  
  1317. Default files hold information for the opening screen, the catalog header, on
  1318. screen help, and so on.  These files have the .CM extension (CATALOG ON A
  1319. DISK's extension that identifies compressed files).
  1320.  
  1321. Catalog Files have the catalog information in them.  CATALOG-ON-A-DISK
  1322. automatically reads whichever Catalog Files are on your disk to create the
  1323. menu of categories.  Catalog files have the extension .CM (the compressed
  1324. product information) For example: WIDGETS.CM.  There must be no more than
  1325. ninety-nine of these files on the disk at any one time.  Each Catalog File is
  1326. listed in the Title file (CATALOG.TL) with the menu heading used to call it.
  1327.  
  1328. Special Forms files are optional.  They contain anything:  an explanation of
  1329. your company policies, special coupons, whatever you want to use them for. 
  1330. These compressed files have the .CM extension, and they are listed in the
  1331. file CATALOG.FM, along with the menu title used to call them.  Important
  1332. NOTE:  if CATALOG.FM does not exist on your disk, the Special Forms menu item
  1333. in the exit menu does not appear.
  1334.  
  1335. 6.2 LIST OF FILES
  1336.  
  1337. CATALOG.EXE          The main program CATALOG.INI                                                                  Contains initialization
  1338.                                                                                                                    information such as color
  1339.                                                                                                                    choices, buyer's name and
  1340.                                                                                                                    address, etc.
  1341. FIRST.CM             Default file.  Contains opening screen information.  If
  1342.                      present it will be used instead of FIRST.CM.
  1343. HEADER.CM            Default file.  Contains opening screen text.  If present
  1344.                      will be used instead of HEADERE.CM.
  1345. ORDERINF.CM          Default file.  If present this will be added to the 
  1346.                      end of the order form.  Contains charge card, shipping 
  1347.                      and handling information, company name and address, 
  1348.                      and so on, in compressed form.
  1349. XXXXXXXX.CM          Catalog file.  Compressed file containing information on
  1350.                      products
  1351. CATALOG.TL           Catalog File.  A short ascii file containing the 
  1352.                      category titles for the main menu.
  1353. CATALOG.FM           Catalog File.  A short ascii file containing the form 
  1354.                      /coupon titles for the Forms menu.
  1355. README               The most up to date information about CATALOG-ON-A-DISK
  1356. EXIT.CM              Default file.  The file that shows your exit message.
  1357. CATALOG-ON-A-DISK MANUAL                                            page 30
  1358. ===========================================================================
  1359. TEMP                 A file created and deleted by CATALOG-ON-A-DISK for 
  1360.                      certain operations.  You won't see this in your 
  1361.                      directory, but you shouldn't keep a file of this name 
  1362.                      in your directory, since CATALOG-ON-A-DISK will delete 
  1363.                      it. CATALOG-ON-A-DISK MANUAL                                            page 31
  1364. ===========================================================================
  1365. Appendix A:   Distributing Catalogs
  1366.  
  1367. CATALOG-ON-A-DISK is protected by US Copyright law.  This section tells how
  1368. you may distribute catalogs.  Distribution of your catalog must follow these
  1369. rules to avoid infringement of EmmaSoft's copyright.  If you have any
  1370. questions about catalog distribution requirements, call EmmaSoft for
  1371. clarification.
  1372.  
  1373. First, some definitions:
  1374.  
  1375. CATALOG-ON-   The software package
  1376. A-DISK        including CATALOG.EXE, CATCOM.EXE, and their accompanying
  1377.               files as shipped from EmmaSoft.
  1378.  
  1379. Your Catalog  Your company's catalog which included CATALOG.EXE,
  1380.               CATALOG.INI, and the files you have created to display your
  1381.               catalog using CATALOG.EXE.
  1382.  
  1383.  
  1384. 1.   A registered user is an individual or company
  1385.      who has paid a registration fee to EmmaSoft and received 
  1386.      a registered copy with a valid serial number from EmmaSoft. 
  1387.  
  1388. 2.   Only registered users may distribute catalogs using CATALOG.EXE.  If you
  1389.      are a registered user you may make unlimited copies of your catalog,
  1390.      including CATALOG.EXE and CATALOG.INI. 
  1391.  
  1392.      Associated individuals or companies not part of the registered user must
  1393.      be registered users before distributing catalogs with CATALOG-ON-A-DISK. 
  1394.      For example, each member of a franchise must individually buy a copy of
  1395.      the program.  An easy way to distinguish:  if you or your company can
  1396.      receive catalog orders directly from a customer you must be a registered
  1397.      user.
  1398.  
  1399. 3.   If you charge a fee for your catalog it should be explicitly understood
  1400.      that you are not selling a copy of the CATALOG-ON-A-DISK product, but
  1401.      are simply charging for a copy of your catalog.  
  1402.  
  1403. 4.   When distributing catalogs CATALOG.EXE MUST be included, unchanged from
  1404.      its original form.  In addition you must include the file CATALOG.INI
  1405.      for the program to work correctly.  Your FIRST, HEADER, ORDERINF, TL,
  1406.      FM, help, and CM files should be included as needed.  CATCOM.EXE must
  1407.      not be sent with your catalogs.
  1408.  
  1409.  
  1410. 5.   Unregistered Users:  Unregistered users are invited to experiment with
  1411.      CATALOG-ON-A-DISK to see if the program meets their needs.  However it
  1412.      is a violation of EmmaSoft's copyright for an unregistered user to
  1413.      distribute catalogs using the program. CATALOG-ON-A-DISK MANUAL                                            page 32
  1414. ===========================================================================
  1415. Index
  1416.  
  1417. Ascii . . . . . . . . . . . . . . . .4, 5, 10, 11, 14-17, 20-24, 26, 28, 29
  1418. Catalog File. . . . . . . . . . . . . . . . . .5, 10, 11, 13, 21-25, 28, 29
  1419. CATALOG.EXE . . . . . . . . . . . . . . . . . . . .4, 20, 21, 25, 27-29, 31
  1420. CATALOG.INI . . . . . . . . . . . . . . . . . . . . . . . . . 4, 21, 29, 31
  1421. CATCOM.EXE. . . . . . . . . . . . . . . . . . . . . . . . 4, 20, 21, 28, 31
  1422. Colors. . . . . . . . . . . . . . . . . . . . . . . . . . 4, 16, 20, 21, 26
  1423. Command line mode . . . . . . . . . . . . . . . . . . . . . . . . . .20, 26
  1424. Companion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 20
  1425. Compress. . . . . . . . . . . . . . . . . . 4, 10-13, 16, 17, 19-22, 25, 28
  1426. Currency symbol . . . . . . . . . . . . . . . . . . . . . . . . .20, 26, 28
  1427. Description blocks. . . . . . . . . . . . . . . . . . . . . . . . . .11, 12
  1428. Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3, 31
  1429. Exit. . . . . . . . . . . . . . . . . . . . . . .6-9, 15-17, 20, 26, 28, 29
  1430. Exit Menu . . . . . . . . . . . . . . . . . . . . . . . . .7, 8, 15, 17, 29
  1431. First . . . . . . . . . . . . . . 4, 6, 8-10, 12, 15, 16, 19-21, 24, 29, 31
  1432. Header. . . . . . . . . . . . . . . . . . . . .5, 10-12, 21, 25, 27, 29, 31
  1433. Help bar. . . . . . . . . . . . . . . . . . . . . . . . . . . .6, 9, 27, 28
  1434. Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . 20-22, 24, 25
  1435. Nationality . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27, 28
  1436. Order Information . . . . . . . . . . . . . . . . . . . . . . . . . .10, 16
  1437. Order Number. . . . . . . . . . . . . . . . . . . . . . . .4, 7, 12, 23, 24
  1438. Price . . . . . . . . . . . . . . . . . . . . . . . .4, 7, 11-13, 18, 23-25
  1439. Printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7-10, 14
  1440. Sales Tax . . . . . . . . . . . . . . . . . . . . . . . . . . .8, 16-19, 28
  1441. Scrolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  1442. Shipping. . . . . . . . . . . . . . . . . . . . . . . . 7, 8, 16-19, 28, 29
  1443. Special Forms . . . . . . . . . . . . . . . . . . . . . . .8, 9, 15, 17, 29
  1444. Total . . . . . . . . . . . . . . . . . . . . . .4, 7, 8, 12, 15, 17-19, 24
  1445. Viewing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1, 6, 19
  1446.