home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / textfile / vndinf.zip / VENDINFO.DOC < prev   
Text File  |  1993-10-25  |  30KB  |  827 lines
  1.  
  2.     
  3.  
  4.  
  5.  
  6.  
  7.                   +----------------------------------------+
  8.                   |                                        |
  9.                   |                                        |
  10.                   |      Introduction and Guide to the     |
  11.                   |                                        |
  12.                   |              VENDINFO(TM)              |
  13.                   |   Software Distribution Information    |
  14.                   |                 System                 |
  15.                   |         Beta-Test Version 0.93         |
  16.                   |                                        |
  17.                   |                                        |
  18.                   |       Last updated: October 1993       |
  19.                   |                                        |
  20.                   |                                        |
  21.                   |  Copyright 1993 Rams' Island Software  |
  22.                   |          All rights reserved           |
  23.                   |                                        |
  24.                   +----------------------------------------+
  25.  
  26.  
  27.  
  28.                                    ABSTRACT
  29.  
  30.         This document provides an overview of the VENDINFO Product
  31.         Information System, with several concrete examples of its
  32.         capability, and will soon contain a brief guide to the as-
  33.         sociated file-format standard. The full standard is contained
  34.         in a separate document.
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.    Rams' Island Software
  45.    7644 E. Lakecliff Way                   _______
  46.    Parker, CO 80134-5904 (USA)        ____|__     |                (R)
  47.                                    --|       |    |-------------------
  48.    Voice: (303) 841-2848             |   ____|__  |  Association of
  49.    BBS:   (303) 841-6269             |  |       |_|  Shareware
  50.    CompuServe: 76244,324             |__|   o   |    Professionals
  51.                                    -----|   |   |---------------------
  52.    FidoNet:  1:104/333                  |___|___|    MEMBER
  53.    RIME:     RAMSISLE
  54.    Internet: 76244.324@CompuServe.Com
  55.  
  56.  
  57.                                                                            
  58.  
  59.  
  60.  
  61.  
  62.    Guide to VENDINFO                                      Table of Contents
  63.  
  64.  
  65.                              +-------------------+
  66.                              | Table of Contents |
  67.                              +-------------------+
  68.  
  69.  
  70.     The VENDINFO System ................................................  1
  71.        Components of the System ........................................  1
  72.        Structure of a VENDINFO File ....................................  2
  73.        A Little Background .............................................  3
  74.        Industry Support and Endorsements ...............................  4
  75.        Other VENDINFO Documents and Packages ...........................  5
  76.  
  77.     A Few Concrete Examples ............................................  6
  78.        Content of a VENDINFO File ......................................  6
  79.        Extraction of FILES.BBS Information .............................  8
  80.        A Distribution Permission Decision ..............................  8
  81.        Automatic Routing of Packages ................................... 10
  82.        Automatic Permission Requests ................................... 10
  83.  
  84.     Guide to the Standard .............................................. 12
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.    VENDINFO System v0.93             -ii-                          Oct 1993
  117.  
  118.  
  119.  
  120.  
  121.  
  122.    Guide to VENDINFO                               Introduction to VENDINFO
  123.  
  124.  
  125.     
  126.                             +---------------------+
  127.                             | The VENDINFO System |
  128.                             +---------------------+
  129.  
  130.       VENDINFO is a system for conveying software product information and
  131.       distribution permissions from the author to distributors. A standard
  132.       (public) file format allows a VENDINFO.DIZ file to carry extensive
  133.       information in a compressed, efficient form. The associated toolset
  134.       aids the author in constructing the record, and allows the dis-
  135.       tributor to extract portions of the record, or to make distribution
  136.       decisions based on its content, in a highly automated way.
  137.  
  138.       VENDINFO provides unprecedented capabilities for
  139.  
  140.            o  Communication of product information and distribution
  141.               policies from author to distributor.
  142.  
  143.            o  Automation of many aspects of package handling by shareware
  144.               distributors of all types.
  145.  
  146.  
  147.  
  148.    Components of the System
  149.    ------------------------
  150.  
  151.       The VENDINFO "record" is the key. This is an efficiently compressed
  152.       file (VENDINFO.DIZ) containing a great deal of information about the
  153.       product, the author, and the product's distribution policies.
  154.  
  155.       The VendEdit editor allows the author to construct a complete
  156.       VENDINFO record in just a few minutes, assuming that the necessary
  157.       descriptive texts have already been prepared.
  158.  
  159.       The VendPrcs processor is a batch program allowing automated deci-
  160.       sions based on VENDINFO content, and automated extraction of VENDINFO
  161.       information.
  162.  
  163.       VendView is a simple viewer allowing the end-user to see relevant
  164.       portions of the VENDINFO data. This program should be available by
  165.       January 1994. Even without VendView, an ordinary text viewer will
  166.       display a good deal of useful information.
  167.  
  168.       The Product Registry is a collection of VENDINFO records available
  169.       for searches and queries by subscription, BBS login, or mail-order
  170.       query. This service will begin in November or December 1993.
  171.  
  172.       The VendLib Library allows software developers to build VENDINFO
  173.       access directly into such products as BBS programs and upload proces-
  174.  
  175.  
  176.    VENDINFO System v0.93              -1-                          Oct 1993
  177.  
  178.  
  179.  
  180.  
  181.    Guide to VENDINFO                               Introduction to VENDINFO
  182.  
  183.  
  184.       sors. This library is already in the hands of 27 vendors of BBSes,
  185.       BBS utility software, and other relevant software.
  186.  
  187.       The file-format standard describing the VENDINFO file is public, and
  188.       draft versions have been published since July 1993. The final version
  189.       1.00 will be issued with the release of the basic toolset in November
  190.       1993. VendEdit is almost ready for beta test, and is scheduled for
  191.       release in November 1993, along with VendPrcs, which is already in
  192.       beta test.
  193.  
  194.       VendPrcs Plus, a non-shareware version of VendPrcs, is planned for
  195.       release by March 1994. It will have a full-screen interface, using
  196.       scripts for easier, more efficient information extraction, and
  197.       templates for easier description of decision situations. It will also
  198.       allow management of a library of VENDINFO files, and will provide
  199.       automated access to the Product Registry BBS.
  200.  
  201.       Additional services for authors, users, and distributors are under
  202.       consideration.
  203.  
  204.  
  205.    Structure of a VENDINFO File
  206.    ----------------------------
  207.  
  208.       The VENDINFO.DIZ file contains two sections. A human-readable front
  209.       section contains information about how to use the VENDINFO file, and
  210.       presents most of the basic information about the product in readable
  211.       form.
  212.  
  213.       The second section is a binary data record, compressed with a PKZIP
  214.       1.10 algorithm, and appended to the file after the first section.
  215.       This record has some 750 fields of information about such things as
  216.  
  217.            o  Product name, date, and version
  218.  
  219.            o  Preferred package filename, other parts of product, replaced
  220.               versions
  221.  
  222.            o  Product descriptions of varying length, categories, keywords
  223.  
  224.            o  Required platform (CPU, operating system, memory, disk,
  225.               features)
  226.  
  227.            o  Contact information for author, for registering, for tech
  228.               support
  229.  
  230.            o  Registration prices and benefits, acceptable forms of payment
  231.  
  232.            o  Warranty and trial-use license
  233.  
  234.  
  235.    VENDINFO System v0.93              -2-                          Oct 1993
  236.  
  237.  
  238.  
  239.  
  240.    Guide to VENDINFO                               Introduction to VENDINFO
  241.  
  242.  
  243.            o  Detailed distribution policy, in general and by distribution
  244.               channel
  245.  
  246.            o  Information about regional distributors and registration
  247.               services.
  248.  
  249.  
  250.  
  251.    A Little Background
  252.    -------------------
  253.  
  254.       The author of the VENDINFO standard and tools, Rudy Ramsey, has been
  255.       agitating since early 1992 for the development of an improved
  256.       mechanism for conveying product information and permissions from
  257.       authors to distributors. Initially, the intent was to make this a
  258.       purely volunteer-based effort, probably conducted within the auspices
  259.       of the Association of Shareware Professionals. However, others were
  260.       slow to respond to the idea (with the exception of Richard Holler and
  261.       Fred Hill), and it gradually became clear that it would have to be
  262.       done as an "extracurricular" effort, if at all.
  263.  
  264.       In the Spring of 1993, Rudy began the VENDINFO effort in earnest, by
  265.       preparing the CONCEPT.DOC concept paper and distributing it to a few
  266.       key shareware industry figures for comment. (At this time, he still
  267.       imagined VENDINFO as an all-volunteer effort.) The reviewers were
  268.       uniformly excited about the idea, and greatly encouraging. Most felt
  269.       that it was an idea whose time had come, and that the technical
  270.       approach described in the concept paper was very appropriate.
  271.  
  272.       Their second response, however, was that the effort contained the
  273.       seeds of its own failure. It might provide all the necessary incen-
  274.       tives for participation by authors, distributors, and users. But if
  275.       it didn't also provide an incentive for continued development and
  276.       support by its own development team, it would fail. It was simply too
  277.       big an activity for successful execution by volunteers.
  278.  
  279.       As a result of that input, a decision was made to regard VENDINFO as
  280.       partly a business opportunity. Although this makes a few people
  281.       suspicious, most agree it's in the best interest of the VENDINFO
  282.       effort itself, and of the industry. In fact, VENDINFO has developed
  283.       rapidly, partly because it has been a full-time focus of its author
  284.       for many months. That wouldn't have been possible in an all-volunteer
  285.       effort.
  286.  
  287.       The VENDINFO file-format standard is public. A substantial period was
  288.       provided for public comment on the concept paper, and then on the
  289.       standard, and public input is always welcome. Some of the tools that
  290.       make use of the standard are free (a viewer for end users, and the
  291.       processor when used by single-line, noncommercial BBSes). Most are
  292.  
  293.  
  294.    VENDINFO System v0.93              -3-                          Oct 1993
  295.  
  296.  
  297.  
  298.  
  299.    Guide to VENDINFO                               Introduction to VENDINFO
  300.  
  301.  
  302.       low-cost shareware. There will also be much-enhanced, non-shareware
  303.       programs later, for special purposes, but none of them are necessary
  304.       to achieve the benefits of the VENDINFO system.
  305.  
  306.  
  307.    Industry Support and Endorsements
  308.    ---------------------------------
  309.  
  310.       Support for the VENDINFO concept has been extraordinarily high
  311.       throughout the industry. Authors, disk vendors, CD-ROM publishers,
  312.       Sysops, and BBS software manufacturers have all expressed their
  313.       support, and many have pledged to build VENDINFO capability into
  314.       their own software products.
  315.  
  316.       The following shareware trade groups have formally endorsed the
  317.       VENDINFO file-format standard as a means of conveying product and
  318.       product-distribution information from authors to users and dis-
  319.       tributors.
  320.  
  321.          Association of Shareware Professionals (ASP)
  322.          Shareware Trade Association and Resources (STAR)
  323.          Association of Shareware Authors and Developers (ASAD)
  324.          Educational Software CoOperative (ESC)
  325.  
  326.       The following software manufacturers have "committed in principle" to
  327.       support VENDINFO in their own software offerrings by mid-1994. In the
  328.       context of these products, "support" for VENDINFO means extracting
  329.       relevant descriptive information automatically from VENDINFO files.
  330.       It does not necessarily mean making decisions based on the product's
  331.       distribution policy. VendPrcs will provide that capability.
  332.  
  333.          BBSes
  334.             PCBoard, Clark Development Co.
  335.             Wildcat!, Mustang Software, Inc.
  336.             Major BBS, Galacticomm
  337.             RBBS, RBBS Development Team
  338.             Searchlight BBS, Searchlight Software
  339.             TBBS, eSoft
  340.             Auntie BBS, Wes Meier
  341.             Executive Host BBS, Steve Wood
  342.             MainLine BBS, Scott Green, City Limits Software
  343.             OmegaComm BBS, Larry Loiselle
  344.             PowerBBS for Windows, Russell Frey
  345.             ProBoard BBS, Philippe Leybaert
  346.             Sapphire BBS, Pinnacle Software
  347.             Tinyhost, Bruce Krobusek
  348.             UltraBBS, UltraBBS Software
  349.             Windowed Modem Environment, Jason Fesler
  350.  
  351.  
  352.  
  353.    VENDINFO System v0.93              -4-                          Oct 1993
  354.  
  355.  
  356.  
  357.  
  358.    Guide to VENDINFO                               Introduction to VENDINFO
  359.  
  360.  
  361.          File Upload Processors
  362.             CatScan, Mike Ortiz
  363.             CheckZip, Bill Hull
  364.             DIZIT, Robert Neal/CorpSoft
  365.             HoboScan, Floyd Hobson
  366.             TransScan, Craig Dunstan
  367.  
  368.          Other Products
  369.             Colorado Utilities Disk Manager, Micro Systems Solutions
  370.             SmartCat Disk Cataloger, Oakley Data Services
  371.  
  372.  
  373.    Other VENDINFO Documents and Packages
  374.    -------------------------------------
  375.  
  376.       The VENDINFO idea is documented in a concept paper and in the VEN-
  377.       DINFO file-format standard. These two documents are available in the
  378.       VENDINFO package, usually named VNDINFxx.ZIP. It can be obtained from
  379.       the Rams' Island BBS on first login or by FidoNet or RIME file re-
  380.       quest. It is also available in the CompuServe SHAREWARE and UKSHARE
  381.       forums; the ASP Hub Network BBSes, many local BBSes, and some disk
  382.       vendors.
  383.  
  384.       If necessary, the concept paper and evaluation versions of the basic
  385.       toolset can be obtained on diskette from Rams' Island Software for
  386.       US$ 8.00 plus $2.00 shipping and handling in North America, $4.00
  387.       elsewhere (starting December 1993). Payment is accepted by
  388.       Visa/MasterCard, check in U.S. dollars drawn on a U.S. bank, cash in
  389.       any hard currency, and various other forms.
  390.  
  391.       An article about the VENDINFO system will appear in the
  392.       November/December 1993 issue of Shareware Magazine.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.    VENDINFO System v0.93              -5-                          Oct 1993
  413.  
  414.  
  415.  
  416.  
  417.    Guide to VENDINFO                                               Examples
  418.  
  419.  
  420.        
  421.                           +-------------------------+
  422.                           | A Few Concrete Examples |
  423.                           +-------------------------+
  424.  
  425.       Concrete examples are often easier to assimilate than abstract ideas,
  426.       and can convey lots of detailed understanding in a small package.
  427.       This section will therefore present a few such examples. Keep in
  428.       mind, though, that these examples are being presented without com-
  429.       plete explanation, to help you understand the overall idea. You
  430.       should not expect to understand every detail.
  431.  
  432.       The examples presented below are representative, but don't begin to
  433.       exhaust the capabilities of the VENDINFO system.
  434.  
  435.  
  436.    Content of a VENDINFO File
  437.    --------------------------
  438.  
  439.       To give an idea of some of the information in a VENDINFO.DIZ file, a
  440.       sample is shown below. This sample was produced by a simple batch
  441.       file that uses the VendPrcs processor to extract individual informa-
  442.       tion fields from the VENDINFO.DIZ file. Here's one line of the batch
  443.       file, which extracts the product version:
  444.  
  445.          vendprcs VENDINFO.DIZ -xpv -y " Version: @"
  446.  
  447.       Here's a VERY SMALL FRACTION of the output of the batch file, and
  448.       therefore of the content of the VENDINFO.DIZ file:
  449.  
  450.                        Product Information
  451.             Product Type: Software
  452.             Product Name: InContext
  453.           Name Extension: Work Environment Manager
  454.                  Version: 1.10
  455.                     Date: 1/31/93
  456.           Version Reason: Major new release, with many feature enhancements
  457.          Filename Prefix: INCXT11
  458.          Number of Parts: 2
  459.                This Part: INCXT11A
  460.            List of Parts: INCXT11A INCXT11B
  461.         CompuServe Parts: INCXTA INCXTB
  462.         Screenshot Types: PCX CGM FLM
  463.                 Replaced: INCX102A INCX102B
  464.            Description 1:
  465.                 InContext Work Environment Manager V1.10 <ASP>
  466.            ...
  467.            Description 4: InContext(TM) Work Environment Manager V1.10
  468.                           Part 1 of 2 <ASP>. Complete Work Environment
  469.  
  470.  
  471.    VENDINFO System v0.93              -6-                          Oct 1993
  472.  
  473.  
  474.  
  475.  
  476.    Guide to VENDINFO                                               Examples
  477.  
  478.  
  479.                           Manager for expert PC users. Automates more
  480.                           aspects of the PC user's work than any other
  481.                           product. Designed by a PhD ergonomist, it is
  482.                           based on fundamental principles of how people
  483.                           actually work. Much more than a DOS shell.
  484.                           NEW VERSION 1.10 has Gantt charts, multi-file
  485.                           tagging, 4DOS long descriptions, PKZIP 2.04
  486.                           support, *many* new features.
  487.            ...
  488.            Description 6:
  489.            ...
  490.                 Keywords: Work Environment Manager Object Oriented DOS
  491.                           Shell Calendar Project
  492.  
  493.       Platform Information (highly abbreviated)
  494.        Minimal Platform
  495.                      CPU: Intel 8086/8088
  496.                Op System: MS-DOS 3.0
  497.               Std Memory: 512K
  498.           Disk Min Instl: 1000K
  499.        Features
  500.         Config:   Laptop: Supported
  501.         RAM:         EMS: Supported
  502.         Disk: Hard Drive: Required
  503.         Disk:  Flop Only: Won't Work
  504.         Disk:     CD-ROM: Supported
  505.  
  506.       Author Information
  507.              Author Name: H. Rudy Ramsey
  508.             Company Name: Rams' Island Software
  509.                  Address: 7644 E. Lakecliff Way
  510.                           Parker, CO  80134-5904
  511.                           USA
  512.             Author Phone: 303-841-2848
  513.            Queries Phone: 303-841-2848
  514.                 BBS Name: Rams' Island BBS
  515.                BBS Phone: 303-841-6269
  516.             BBS Username: Rudy Ramsey
  517.               CompuServe: 76244,324
  518.                  FidoNet: 1:104/333
  519.                 Internet: 76244.324@compuserve.com
  520.                     RIME: RAMSISLE
  521.         Known Trade Assn: ASP STAR
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.    VENDINFO System v0.93              -7-                          Oct 1993
  531.  
  532.  
  533.  
  534.  
  535.    Guide to VENDINFO                                               Examples
  536.  
  537.  
  538.    Extraction of FILES.BBS Information
  539.    -----------------------------------
  540.  
  541.       BBS Sysops often keep lists of their files in a particular descrip-
  542.       tive form known as FILES.BBS. Many BBS and BBS utility manufacturers
  543.       have committed to import VENDINFO information directly into their
  544.       files databases, but it will still be useful to show the construction
  545.       of a FILES.BBS description using a batch file.
  546.  
  547.       Here's an example of a FILES.BBS description, truncated on the right
  548.       to fit here:
  549.  
  550.          INCXT11D.ZIP  216251 1/31/93   InContext(TM) Work Environment Mana
  551.                                         Part 1 of 2 <ASP>. Complete Work En
  552.                                         Manager for expert PC users. Automa
  553.                                         aspects of the PC user's work than
  554.                                         product. Designed by a PhD ergonomi
  555.                                         based on fundamental principles of
  556.                                         actually work. Much more than a DOS
  557.                                         NEW VERSION 1.10 has Gantt charts,
  558.                                         tagging, 4DOS long descriptions, PK
  559.                                         support, *many* new features.
  560.  
  561.       Here's the working part of a simple batch file, which constructed the
  562.       description above. This example uses the VendPrcs processor, with
  563.       various command-line flags, to extract each of the fields of informa-
  564.       tion that make up a FILES.BBS entry.
  565.  
  566.          vendprcs -p .\INCXT11D.ZIP -xxpf -zw12 -zn
  567.          vendprcs -p .\INCXT11D.ZIP -xxps -zw8  -zn -zl
  568.          vendprcs                   -y " "      -zn
  569.          vendprcs -p .\INCXT11D.ZIP -xxpd -zw9  -zn -zd "mm/dd/yy"
  570.          vendprcs VENDINFO.DIZ      -xpd4 -zi31 -zc45 -y " @"
  571.  
  572.       In plain English, the first command above says "write the package
  573.       filename of the compressed package .\INCXT11D.ZIP, padding to a width
  574.       of 12 characters, and not writing a newline."
  575.  
  576.  
  577.    A Distribution Permission Decision
  578.    ----------------------------------
  579.  
  580.       In this example, a CD-ROM publisher wishes to select, from a large
  581.       set of programs, all those that satisfy two criteria:
  582.  
  583.            o  Distribution by BBS is totally unlimited.
  584.  
  585.            o  Distribution on a $40 CD-ROM is allowed, possibly subject to
  586.               additional requirements.
  587.  
  588.  
  589.    VENDINFO System v0.93              -8-                          Oct 1993
  590.  
  591.  
  592.  
  593.  
  594.    Guide to VENDINFO                                               Examples
  595.  
  596.  
  597.       The result will be a candidate set of programs for a CD-ROM that can
  598.       be sold strictly to BBS sysops, for on-line access via BBS.
  599.  
  600.       Shown below is the working portion of a simple batch file that per-
  601.       forms this function. The batch file leaves a copy of the package in
  602.       one of several directories, as defined in the batch file itself and
  603.       in VPRESULT.CFG, along with a correspondingly named LOG file.
  604.  
  605.          pkunzip %1 vendinfo.diz
  606.          if not exist vendinfo.diz goto manual
  607.  
  608.          rem ----- reject BBS-limited products --------------------------
  609.          vendprcs vendinfo.diz -db
  610.          if errorlevel 40 goto bbsok
  611.          if errorlevel 20 goto reject
  612.          goto bad_vendinfo
  613.  
  614.          :bbsok
  615.          rem ----- now test for CD-ROM distributability -----------------
  616.          vendprcs vendinfo.diz -dc -cc40 -mcb -rmnd -p .\%1
  617.          goto done
  618.  
  619.       Here's a portion of a log file produced by a distribution test, to
  620.       give you an idea what information it might contain:
  621.  
  622.          VendPrcs invoked on file INCXT11.DIZ (InContext Work
  623.                                         Environment Manager v1.10)
  624.             Testing for...
  625.             ...Acceptability of Distribution to End User by BBS
  626.             ...Authenticity/validity of VENDINFO record(s)
  627.             ...Package contents checked for ALLOWED CHANGES
  628.             ...Executable programs tested for VENDINFO records
  629.             Description of distributor and distribution...
  630.             ...Distributor is ASP BBS Member
  631.             ...Distributor makes no charges to users
  632.             Package will be unmodified and separate, except:
  633.             ...Advertisements may be added as SEPARATE FILES.
  634.             ...Compression method may be changed.
  635.             Distributor...
  636.             ...Is "qualified" because: All distributors are qualified
  637.             Additional requirements or prohibitions...
  638.             ...Proposed change of compression must satisfy conditions:
  639.                Internal LZH archives must remain intact, or install
  640.                                         and execution fail
  641.             Test result...
  642.             ...Distribution is allowed if additional requirements
  643.                                         are satisfied.
  644.             Actions taken by VendPrcs...
  645.             ...Moved .\incxt11.zip
  646.  
  647.  
  648.    VENDINFO System v0.93              -9-                          Oct 1993
  649.  
  650.  
  651.  
  652.  
  653.    Guide to VENDINFO                                               Examples
  654.  
  655.  
  656.                to c:\tohandle\NeedAddl\INCXT11.zip
  657.             ...Saved copy of VENDINFO file as
  658.                c:\Library\INCXT11.DIZ
  659.  
  660.  
  661.  
  662.    Automatic Routing of Packages
  663.    -----------------------------
  664.  
  665.       In this example, a BBS sysop wants to automatically route packages
  666.       depending on their subject matter. To do this, he prepares a
  667.       VPCATGRY.CFG file based on the category scheme used by VENDINFO.
  668.       Here's a section of the CATEGORY.INF file that comes with VENDINFO:
  669.  
  670.          14000000 Business
  671.             14010000 Business finances
  672.                14010100 Business accounting
  673.                14010200 Point-of-sale systems
  674.                14010300 Billing systems
  675.                14010400 Purchase order systems
  676.                14010500 Payroll systems
  677.             14020000 Inventory systems
  678.             14140000 Equipment use & maintenance
  679.             14040000 Project management
  680.                14040100 Project bidding & costing
  681.                   14040101 Decision analysis tools
  682.                14040200 Project scheduling
  683.  
  684.       Here's a segment of a VPCATGRY.CFG file used to do automated file
  685.       routing:
  686.  
  687.          00000000 Reject
  688.          14000000 C:\BBSFILES\BUSINESS
  689.             14010000 C:\BBSFILES\FINANCE
  690.             14040000 C:\BBSFILES\PROJMAN
  691.  
  692.       Given this file, the command
  693.  
  694.          vendprcs vendinfo.diz -p <package_name> -rcn
  695.  
  696.       will move the package to the correct directory. There's a little more
  697.       detail involved, but this conveys the basic idea.
  698.  
  699.  
  700.    Automatic Permission Requests
  701.    -----------------------------
  702.  
  703.       This example shows automated production of a letter to an author from
  704.       a disk vendor, describing the vendor's company and requesting permis-
  705.  
  706.  
  707.    VENDINFO System v0.93             -10-                          Oct 1993
  708.  
  709.  
  710.  
  711.  
  712.    Guide to VENDINFO                                               Examples
  713.  
  714.  
  715.       sion to distribute the author's product. It is also possible to
  716.       automatically construct electronic mail messages in this way. Here's
  717.       a segment of a batch file, to illustrate the idea. This batch file
  718.       produces a text file (LETTER.TXT) suitable for use with Ventura
  719.       Publisher to print the letter on existing company letterhead.
  720.  
  721.          vendprcs %1 -xac -y "@@AUTHOR = @"             > letter.txt
  722.          vendprcs -y " "                               >> letter.txt
  723.          vendprcs %1 -xaa -y "@@ADDRESS = @" -zv       >> letter.txt
  724.          vendprcs -y " "                               >> letter.txt
  725.          echo Dear Author:                             >> letter.txt
  726.          vendprcs -y " "                               >> letter.txt
  727.  
  728.          echo We have recently received a copy of your >> letter.txt
  729.          vendprcs %1 -xpp -y "<B>@" -zn                >> letter.txt
  730.          vendprcs %1 -xpe           -zn                >> letter.txt
  731.          vendprcs %1 -xpv -y "v@<D>."                  >> letter.txt
  732.          vendprcs -y " "                               >> letter.txt
  733.  
  734.          echo We are quite interested in adding this   >> letter.txt
  735.          echo program to our inventory, but we observe >> letter.txt
  736.          echo that you require written permission...   >> letter.txt
  737.          vendprcs -y " "                               >> letter.txt
  738.  
  739.          echo This letter will serve to introduce you  >> letter.txt
  740.          echo to our business, and...                  >> letter.txt
  741.          vendprcs -y " "                               >> letter.txt
  742.  
  743.          echo @CLOSING = Yours truly,                  >> letter.txt
  744.          vendprcs -y " "                               >> letter.txt
  745.          vendprcs -y "@SIGNATURE = Ima D. Vendor"      >> letter.txt
  746.  
  747.       A similar application of these techniques could produce a catalog
  748.       entry for a disk vendor's mail-order catalog.
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.    VENDINFO System v0.93             -11-                          Oct 1993
  767.  
  768.  
  769.  
  770.  
  771.    Guide to VENDINFO                                  Guide to the Standard
  772.  
  773.  
  774.        
  775.                            +-----------------------+
  776.                            | Guide to the Standard |
  777.                            +-----------------------+
  778.  
  779.       This section will be supplied for the November 1993 edition,
  780.       VNDINF07.ZIP. It will provide a guide to the File-Format Standard
  781.       contained in STANDARD.DOC. It should make STANDARD.DOC a bit easier
  782.       to understand, but STANDARD.DOC is useable without the guide.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.    VENDINFO System v0.93             -12-                          Oct 1993
  826.  
  827.