home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / ULP_108.ZIP / ULP.DOC < prev    next >
Text File  |  1994-06-08  |  98KB  |  1,778 lines
  1.  
  2.     ┌───────────────────┐
  3.     │                   │ ║                UpLoadProcessor
  4.     │    ╥   ╥ ╥        │ ║
  5.     │    ║   ║ ║ ╓──╖   │ ║                 Version 1.08
  6.     │    ║   ║ ║ ║  ║   │ ║
  7.     │    ╙───╜ ╨ ║──╜   │ ║     (c) Copyright 1992-1994 - Stacy Smith
  8.     │            ╨      │ ║
  9.     └───────────────────┘ ║
  10.       ════════════════════╝
  11.  
  12.                                 Courtesy of:
  13.  
  14.                         The Bloom Beacon-Picayune BBS
  15.           Node 1: (919) 557-3845 (USRobotics Courier Dual Standard)
  16.              Node 2: (919) 557-0645 (USRobotics Courier V.32bis)
  17.                              FidoNet 1:151/106
  18.                                   Intelec
  19.                                  CompuLink
  20.  
  21.                                 Stacy Smith
  22.                             305 Cottonwood Lane
  23.                           Holly Springs, NC 27540
  24.  
  25.  
  26. ┌───────────────────┐
  27. │  1. Introduction  │
  28. └───────────────────┘
  29.  
  30. This system was born out of a need for a universal upload processor. There are
  31. many alternative systems available, but they are limited to the ZIP format and
  32. perhaps one or two others. Few are able to handle self-extracting archives.
  33. Most are limited in the number of levels of archive nesting allowed in a file
  34. to be tested. All require the use of a third-party duplicate file checking
  35. system if you want to screen your uploads for duplicates.
  36.  
  37. Tired of waiting for PKZIP 2.something-or-another, I converted my BBS files
  38. over to the ARJ compression format, due to its superior compression ratio over
  39. PKZip and its features over LHA (I have since switched back to ZIP...the
  40. undertow was overwhelming <g>).  But due to that decision, the need for a
  41. universal upload processor became apparent, so off I went.
  42.  
  43. While I was at it, I decided to incorporate other technologies, such as
  44. duplicate checking, archive format conversion, information lines, support for
  45. internal description files, etc., into a single package. This software is the
  46. result of my efforts to allow my BBS to handle any archive that my users can
  47. throw at it.
  48.  
  49.  
  50. ┌─────────────────────────────────────────────┐
  51. │  2. Features of the UpLoadProcessor System  │
  52. └─────────────────────────────────────────────┘
  53.  
  54.   ∙ Identifies and processes ARC, ARJ, HYP, LZH, PAK, SQZ, ZIP, ZOO and GIF
  55.     files, regardless of their file extensions (ideal for software distribution
  56.     network files, e.g. SDN).
  57.   ∙ Identifies and processes ARJ, LZH, PAK, SQZ and ZIP self-extracting (SFX)
  58.     archives.
  59.   ∙ Scans ARC, PAK, ZIP and ZIP SFX archives for DOS reserved keywords to
  60.     prevent hacking by hex-editing. (ARJ and LHA are resistant to these type of
  61.     hacking attempts).
  62.   ∙ Detects ARJ security envelopes and ZIP version 1.x and 2.x authenticity
  63.     verification (-AV) stamps and may be retained intact.
  64.   ∙ Detects and processes ARJ and ZIP archives with imbedded paths.
  65.   ∙ Detects and rejects encrypted ARJ and ZIP archives.
  66.   ∙ Selected uncompressed files uploaded can be processed and compressed using
  67.     your default format.
  68.   ∙ Removes known BBS ads from archives; includes a BBS ads maintenance utility
  69.     so sysops can update their BBS ads databases in real time. ULP can also
  70.     insert a BBS ad, if desired.
  71.   ∙ Updates the PCBoard DOWNLOAD.TXT file, if desired, with the correct archive
  72.     extension to reflect the conversion process.
  73.   ∙ Allows the use of up to 9 different archiving programs, all user-
  74.     configurable. Any archiving program used that is not listed above will be
  75.     identified using it's unique file extension only, until it's signature is
  76.     determined and incorporated into the program.
  77.   ∙ Uses a recursive processing routine that will allow (theoretically)
  78.     unlimited nested archives (the only limit is imposed by the DOS path). This
  79.     routine has been tested to 5 levels deep as of this writing.
  80.   ∙ Allows the use of up to 3 different file-checking programs, all user-
  81.     configurable, for virus and trojan checking, third-party utilities, etc.
  82.   ∙ Allows the use of a GIF file checking program, completely configurable.
  83.   ∙ Rejects GIF files based upon image width, height, colors and compression.
  84.   ∙ User-definable disposition (rename or delete) of corrupted, duplicate or
  85.     other archives (not virus-related).
  86.   ∙ User-definable disposition (rename or delete) of virus-infected archives.
  87.   ∙ Incorporates it's own duplicate checking system, as well as the associated
  88.     database processing software. No more executing (and registering!)
  89.     third-party duplication checking software, sacrificing speed and memory.
  90.     This system is extremely fast and it's database is much smaller than other
  91.     systems. Despite it's size, the probability of a false duplication is
  92.     almost 1 in 10 trillion! The system is self-validating, to quickly
  93.     determine if a database has been corrupted or altered.
  94.   ∙ Optional seamless interface with the ZDCS duplication system by Mike Cocke.
  95.   ∙ ULP determines duplication using two filters, total duplication and
  96.     executable duplication, preventing false rejection by simply counting up
  97.     the number of blatantly duplicate files.
  98.   ∙ Converts all uploads into a default archive format of your choosing, or
  99.     they may be re-archived in their original format (user-defined). Nested
  100.     archives can also be converted to your default format, or re-archived using
  101.     their original format. SFX archives can be archived using your default
  102.     format, or optionally left alone after verification.
  103.   ∙ Can utilize a user-defined time window (in months) for acceptance of new
  104.     upload files, based on the average age of the files within the archive, or
  105.     optionally, the age of the newest file.
  106.   ∙ Changes all archive file attributes to 'read/write' from 'read-only'.
  107.   ∙ Supports the use of private and public upload directories. Moves files and
  108.     upload descriptions from the private directory to the public directory.
  109.     Single directory operation may also be configured.
  110.   ∙ Honors the '/' identifier in the description marking the file as a private
  111.     upload for the sysop by processing the file, but not making it public.
  112.   ∙ Supports the use of DESC.SDI and FILE-ID.DIZ description files in an
  113.     archive, user-configurable, for those not running PCBoard 14.5a+ and
  114.     PCBDESC.
  115.   ∙ Smart word-wrapping word-wraps descriptions or leaves them as entered,
  116.     depending upon the presence of boxes, etc.
  117.   ∙ Can optionally insert an archive or GIF information line in the file
  118.     description that contains various information about the archive or GIF
  119.     files.
  120.   ∙ Three modes of online testing are available: slow mode, which completely
  121.     processes files at the time of upload; normal mode, which fully unpacks the
  122.     archive and tests each file individually; and fast mode, which scans a ZIP
  123.     or ARJ archive directly for file CRCs, sizes and dates, and uses the
  124.     archiving program's internal integrity testing.
  125.   ∙ The online tester will accept a redirected ARJ or PKUNZIP archive listing
  126.     file to pre-verify the duplication and age limits before a user uploads the
  127.     actual archive, saving him or her wailing and gnashing of teeth.
  128.   ∙ ULPTEST can generate COM port status output to inform the online user of
  129.     the progress of testing. ULPTEST supports IRQs 2 through 7, non-standard
  130.     port addresses and baud rates to 115K in direct mode, and also supports
  131.     FOSSIL drivers. The port information can be defined on the command-line or
  132.     can be read directly from PCBOARD.DAT and PCBOARD.SYS. ULP can also be
  133.     implemented in a "seamless" mode (when registered) to look like a part of
  134.     PCBoard.
  135.   ∙ Import of FWKCS(TM) contents_signature databases is supported to ease
  136.     transition to the ULP duplication system. No need to rebuild databases for
  137.     FWKCS users!
  138.   ∙ Archives failed for exceeding duplication limits can be viewed using ULPDB
  139.     (the database program), to allow easy determination of manual archive
  140.     acceptance.
  141.   ∙ User-selectable process logging to a disk file. Two logging modes are
  142.     available: terse and verbose.
  143.   ∙ Menu-driven windowed system manager for maximum ease of configuration.
  144.   ∙ Written mostly in C (and a little assembler) for optimal speed, using
  145.     Microsoft C 7.0, Borland C++ 3.1 and Turbo Assembler 3.1.
  146.  
  147.  
  148. ┌─────────────────────────────────────────────────────┐
  149. │  3. Files Included in the ULP Distribution Archive  │
  150. └─────────────────────────────────────────────────────┘
  151.  
  152.     ULP.EXE         Event upload processing program.
  153.     ULPTEST.EXE     On-line testing program for use in PCBTEST.BAT.
  154.     ULPDB.EXE       Duplication database creation and maintenance program.
  155.     ULPSM.EXE       System and configuration manager for the ULP system.
  156.     ULPADS.EXE      BBS ads database maintenance program.
  157.     ULPADS.DB       BBS ads database file.
  158.     SAMPLE.CFG      Sample configuration file for the ULP system.
  159.     SAMPLE.DIR      Sample directory configuration file.
  160.     UPDATE.EXE      Configuration file conversion utility (only if necessary).
  161.     EXCLUDE.LST     Sample exclusion list for archivers.
  162.     PCBTEST.BAT     Sample PCBTEST.BAT file for using ULPTEST.
  163.     ULP.DOC         This file.
  164.     Q&A.DOC         Answers to common questions regarding the ULP system.
  165.     HISTORY.TXT     ULP revision history in reverse order.
  166.     UPGRADE.TXT     Information specific to upgrading from previous versions.
  167.     ULPBLT          Archive verification bulletin for sysops to post.
  168.     REGISTER.FRM    Registration form for ULP.
  169.     COMMENT.TXT     Sample comment file for inclusion in archive headers.
  170.     FILE_ID.DIZ     Internal description file.
  171.  
  172. When you unzip the distribution archive, you should see my PKZIP authenticity
  173. verification stamp, and a '-AV' after every file in the archive:
  174.  
  175.     # SSU301    The Bloom Beacon-Picayune BBS
  176.  
  177. If there are any files missing or added, or the -AV stamp is missing, the
  178. archive has been tampered with. It would be advisable to call my BBS (listed at
  179. the top of this document) for the latest version of ULP.
  180.  
  181.  
  182. ┌───────────────────────────┐
  183. │  4. Program Requirements  │
  184. └───────────────────────────┘
  185.  
  186. To the best of my knowledge, this program will run on most any machine capable
  187. of running PCBoard 14.5+. My BBS setup is DESQview on a LANtastic network with
  188. hard disks and CD-ROMs, but other sysops that I have been in contact with have
  189. successfully implemented ULP on setups other varying hardware and software.
  190.  
  191. ULP has been developed and tested using the following third party utilities:
  192.  
  193.     ARJ 2.10 and higher (by Robert Jung)
  194.     HYPER 2.5 (by P. Sawatzki and K. P. Nischke)
  195.     LHA 2.12 and higher (by Haruyasu Yoshizaki)
  196.     LHarc 1.13c (by Haruyasu Yoshizaki)
  197.     PAK 2.51 (by NoGate Consulting)
  198.     PKPAK 3.61 (by PKWare)
  199.     PKZIP 1.10 and higher (by PKWare)
  200.     SQZ 1.08.2 (by Jonas Hammarberg)
  201.     ZOO 2.01 and higher (by Rahul Deshi)
  202.     AntiAd 0.98ß and higher (by Stacy Smith)
  203.     F-PROT 2.07 and higher (by Frisk Software International)
  204.     SCAN V82 and higher (by McAfee Associates)
  205.     GIFTEST 4.0 Beta 10 and higher (by Dave Navarro)
  206.     ZDCS 2.02 and higher (by Stacy Smith)
  207.     SHROOM 2.3a (by Davis Augustine)
  208.  
  209. The ULP system requires DOS 3.x or later, as it uses DOS SHARE-compatible file
  210. reads and writes, and can use the DOS PATH to find the archiving and other
  211. utilities.
  212.  
  213. ULP and ULPTEST's memory requirements are relatively small (about 110K or so
  214. with data buffers allocated), but all programs are spawned or shelled, which
  215. reduces the free memory for the program being executed. It would be a good idea
  216. to have as much free conventional memory as possible (ULP itself cannot use EMS
  217. or XMS memory), especially if you use the ARJ compression system, which
  218. requires in the neighborhood of 300K itself to run.
  219.  
  220. ULPDB also should have as much conventional memory as can be afforded, as it
  221. performs its sort in memory for optimal speed; it may use from 120K to 575K of
  222. memory depending upon the operation being performed. If your duplication
  223. database is larger than 500K (over 50,000 file entries), ULPDB may utilize a
  224. segmented sort algorithm, which is slower but capable of completely compiling a
  225. database up to 128MB in size (almost 13,000,000 file entries)! The memory sort
  226. will probably be fine for many systems, as 50,000 files would probably average
  227. out to be about 4,000 to 5,000 typical archives.
  228.  
  229. Obviously, the 286+ and 386+ versions of these programs that is available to
  230. registered users will not run on a 8088, 8086 or 80186 (huh?) based computer.
  231. So don't try it (I haven't, so I don't have a clue what will happen...probably
  232. spontaneous combustion...).
  233.  
  234.  
  235. ┌───────────────────┐
  236. │  5. Registration  │
  237. └───────────────────┘
  238.  
  239. The ULP system is not free; nor is ULP is crippled to force registration.  ULP
  240. is fully functional, and will always remain so.  The primary difference is no
  241. time delay and beg message once registered.
  242.  
  243. Why register? Besides a clean conscience, you will get a diskette including the
  244. latest version of ULP and a registration key that will work for all future
  245. versions of ULP, and will remove the delay and message at the end of execution
  246. of each program.  In addition, registration will allow you to run ULPTEST in a
  247. "seamless" mode so that it looks like a part of PCBoard to the user.
  248.  
  249. In addition, the registation key will allow use of the 286 or 386 specific
  250. versions of ULP that are made available to registered users of ULP.  These
  251. versions are slightly smaller and faster than the shareware 086+ version.
  252.  
  253. The registration fee for ULP is $25 for hobbyist BBSes.  The registration fee
  254. for commercial BBSes, defined as running your BBS in the course of a commercial
  255. business or for profit, is $40.  Please print the file REGISTER.FRM and fill it
  256. out.  You can print out the form by issuing the following command from the DOS
  257. prompt:
  258.  
  259.     TYPE REGISTER.FRM > PRN
  260.  
  261.  
  262. ┌───────────────────────────────────────┐
  263. │  6. License, Warranty and Disclaimer  │
  264. └───────────────────────────────────────┘
  265.  
  266. I'll keep this part short and sweet, and dispense with the legal-ese:
  267.  
  268.     License: You are allowed to use ULP for 30 days, after which you must
  269.         either register ULP or stop using it completely. ULP registration is a
  270.         license for your use of ULP; I retain ownership of the software. A
  271.         single registration applies to a single BBS system, regardless of the
  272.         number of computers used in the system. If you run two or more distinct
  273.         BBS systems on the same computer or network (with different names), you
  274.         require two or more ULP registrations. Refer to the registration form
  275.         for the currect pricing structure.
  276.  
  277.     Warranty: There isn't one. The only thing I'll guarantee is that ULP will
  278.         take up disk space, and will disappear when deleted.
  279.  
  280.     Disclaimer: I'm not responsible for anything bad that happens. ULP works
  281.         here, but I cannot be held responsible for it not working on your
  282.         computer or doing any damage to hardware or software.
  283.  
  284. If these aren't agreeable with you, then the best thing to do is delete ULP
  285. right now. I'll do my best to help any user (registered or not) that wants to
  286. use ULP, and I'll act on bug reports quickly, but I simply cannot and will not
  287. be responsible for anything bad, like lost data, disk crashes, or whatever
  288. else you can think of.
  289.  
  290.  
  291. ┌────────────────────────────┐
  292. │  7. Conceptual Background  │
  293. └────────────────────────────┘
  294.  
  295. Since the ULP system is made up of several inter-operating programs, this
  296. overview and concept explanation should help you understand how ULP is
  297. designed to be used.
  298.  
  299. *******************************************************************************
  300.      READ THIS SECTION VERY CAREFULLY, AS IT WILL MAKE LIFE MUCH EASIER!!!
  301. *******************************************************************************
  302.  
  303. I believe that all responsible BBS sysops verify all of their uploads prior to
  304. posting them, in order to protect both themselves and their users. ULP is
  305. designed with idea in mind. Most, if not all, sysops process uploads in one of
  306. two ways (listed with benefits and liabilities as I see them):
  307.  
  308.     1) Make all uploads private, processing them during a system event.
  309.  
  310.        BENEFITS:
  311.            ∙ Takes up very little on-line time on the user's part to process
  312.              archives.
  313.            ∙ Allows the conversion of all archives to a default format, so that
  314.              the BBS archives are consistent.
  315.            ∙ Allows the BBS to accept any archive format...face it, it's hard
  316.              enough to get some of these weenies to upload, much less compress
  317.              them the same way.
  318.  
  319.        LIABILITIES:
  320.            ∙ Files are not available immediately for download.
  321.            ∙ The 'U' subcommand of PCBoard's (F)ile Directories command is no
  322.              longer available to the user (PCBoard 14.5a and below).
  323.            ∙ Does not catch duplicates or aged archives until after the user
  324.              has uploaded them, and perhaps leads to abuse by clever (?) users.
  325.              (It is assumed that these sysops still use the venerable 'PKUNZIP
  326.              -T' in their PCBTEST.BAT...)
  327.  
  328.     2) Process (test) each upload online after the user uploads them, and
  329.        making them available for immediate download.
  330.  
  331.        BENEFITS:
  332.            ∙ Catches duplicate, defective and aged archives while the user is
  333.              online, denying him upload credits.
  334.            ∙ Files are available immediately for download if they are not made
  335.              private in the PCBoard setup.
  336.  
  337.        LIABILITIES:
  338.            ∙ Takes up on-line time for a user, potentially adding to his
  339.              long-distance phone bill, discouraging further uploading; this
  340.              process is typically quite slow for large archives.
  341.            ∙ The archive format cannot be converted (a limitation of PCBoard),
  342.              leaving many different archive formats in your BBS directories.
  343.              Because of this, many sysops force users to use a specific format,
  344.              which may or may not be consistent with other BBS's the user
  345.              calls.
  346.  
  347. The ULP system takes the best of both of these methods of testing. ULP.EXE is
  348. an event-mode processor which will fully process every new archive found in the
  349. source upload directory, including archive format conversion, and optionally
  350. move the file and description to a destination directory. In the simplest
  351. ULP system setup, you MUST run ULP.EXE in your event to completely process all
  352. uploads to your system.
  353.  
  354. ULPTEST.EXE is an online processor, with a varying modes of operation, from
  355. complete processing to a very fast scan of the archive directly for data. These
  356. modes will allow you to run your BBS in the most efficient manner. Note that
  357. the conversion process MUST be handled by ULP during the system event, due to
  358. the design of PCBoard.
  359.  
  360. Pay attention to this part:
  361.  
  362. PCBoard normally has two upload directories for each conference: a private and
  363. a public directory. When PCBoard invokes PCBTEST.BAT, the upload is in the
  364. private directory. If the archive fails the testing, it will remain there.
  365. However, if it passes, one of two things will occur depending upon your system
  366. setup; if you have made all uploads private, the file will remain in the
  367. private directory; if you have not made uploads private, it will be moved BY
  368. PCBOARD (not ULPTEST) to the public directory.
  369.  
  370. If you have made all uploads private, then setup and configuration of ULP is a
  371. snap: the source directory is the private upload directory, and the destination
  372. is the public directory. However, if you want to allow users access to untested
  373. uploads, then your source directory is the public upload directory, and the
  374. destination information is left blank. To illustrate the operation:
  375.  
  376.   MAKE ALL UPLOADS PRIVATE           │  ALL UPLOADS AVAILABLE AFTER TESTING
  377.   ───────────────────────────────────┼─────────────────────────────────────
  378.   2 directories:  C:\PRIVATE         │  2 directories:  C:\PRIVATE
  379.                   C:\PUBLIC          │                  C:\PUBLIC
  380.                                      │
  381.   User uploads a file, gets placed   │  User uploads a file, gets placed
  382.   in C:\PRIVATE by PCBoard           │  in C:\PRIVATE by PCBoard
  383.                                      │
  384.   ULPTEST.EXE tests it               │  ULPTEST.EXE tests it
  385.                                      │
  386.   PCBoard leaves file in C:\PRIVATE  │  If it passes, PCBoard moves it to
  387.                                      │  C:\PUBLIC; if it fails, PCBoard
  388.                                      │  leaves it in C:\PRIVATE
  389.                                      │
  390.   ULP.EXE processes all new uploads  │  ULP.EXE processes all *new* uploads
  391.   found in C:\PRIVATE since last     │  found in C:\PUBLIC since last event
  392.   event and moves all good uploads   │
  393.   to C:\PUBLIC                       │
  394.  
  395. ULPTEST.EXE also has three modes of operation: slow, normal and fast. Slow mode
  396. completely tests the upload as in the event, except for archive conversion.
  397. Note that you MUST use the "all uploads public" mode of operation to run slow
  398. mode.
  399.  
  400. The normal mode decompresses the files, performs file, duplication and age
  401. checking, and then deletes the extracted files and returns to PCBoard,
  402. informing PCBoard of the test results. It does not recompress the archive,
  403. remove BBS ads, add information lines, etc.; this is saved for the event
  404. processing. This mode can be used with both setup paradigms, making all uploads
  405. private or public.
  406.  
  407. Fast mode DOES NOT decompress the file; it firsts performs an archive integrity
  408. check, then scans ARJ and ZIP archives directly for duplicate and age
  409. information, and then returns to PCBoard (if the archive is not ARJ or ZIP,
  410. then normal mode is forced). In fast mode, file checking (viruses, etc.) is
  411. left for ULP to do (which is why the above discussion regarding private/public
  412. directories is important). This mode can also be used either in making uploads
  413. public or private, although it would be a good idea to make them private with
  414. this mode, since the uploads are not file-checked (e.g. viruses) during
  415. test.
  416.  
  417. ULPTEST.EXE will also accept a redirected ARJ or PKUNZIP listing text file with
  418. the special name VERIFY.ULP as input to pre-verify an upload for a user, before
  419. the user actually spends his time uploading the file only to find out it won't
  420. pass the limits you set.
  421.  
  422.  
  423. ┌───────────────────┐
  424. │  8. Installation  │
  425. └───────────────────┘
  426.  
  427. GENERAL (REQUIRED!):
  428. ───────────────────
  429. Make a subdirectory on your hard drive. For the purposes of this document,
  430. we'll call it "C:\ULP". Unarchive the ULP distribution archive into this
  431. subdirectory. You've more than likely already made it this far, if you're
  432. reading this file. <g>
  433.  
  434. The ULP system opens several files at once for various reasons. I would
  435. recommend that you have a minimum of FILES=30 per node in your system
  436. CONFIG.SYS file, since ULPTEST is run in conjunction with PCBoard.
  437.  
  438. If you are running PCBoard under a network or a multitasking operating system,
  439. you should already have DOS's SHARE.EXE loaded. You must have SHARE loaded in
  440. order to take advantage of the file sharing and locking methods used by the ULP
  441. programs to prevent data loss. (If you are running a single-node system without
  442. a multitasker, SHARE is not needed).
  443.  
  444. * NOTE: DOS 5 has a documented bug when SHARE is loaded high, where it loses
  445.     the table in memory. Please load SHARE low to prevent potential sharing
  446.     problems.
  447.  
  448. Using ULPSM, configure the ULP system to suit your needs. Proper configuration
  449. will require you to refer to this section, the previous section and the section
  450. titled "Configuration", which has an in-depth explanation of each configuration
  451. option and its function. It would probably be wise to fire up your printer for
  452. this document.
  453.  
  454. For this document, we'll assume the name of your configuration file is
  455. "ULP.CFG".
  456.  
  457. Note that for any of the ULP programs, you can obtain a limited program syntax
  458. screen simply by executing the program with no arguments.
  459.  
  460. FOR EVENT-MODE UPLOAD PROCESSING (REQUIRED!):
  461. ────────────────────────────────────────────
  462. As a minimum setup, you MUST run ULP as an event-mode processor, as ULP.EXE
  463. handles most of the database updating, archive conversion, file and description
  464. moving, archive information line computation, and other features. THIS IS NOT
  465. AN OPTION!!!
  466.  
  467. Further, ULP requires that you define the upload disk directories and upload
  468. DIRxx files. They can be either a private/public setup or public setup, as
  469. described below (and in the 'principles of operation' section):
  470.  
  471.   - PRIVATE/PUBLIC SETUP:  This setup will not allow users to get to any
  472.     archive that has not been fully processed. In PCBSETUP, under Main Board
  473.     Configuration (and any other conferences you want ULP to process), make all
  474.     uploads private. Define a private upload directory and a private DIRxx file
  475.     (which should have already been done, since all sysop-only uploads are
  476.     placed here by PCBoard). In PCBSETUP, be sure to set the "make all uploads
  477.     private" flag to "Y". This is how I have my system setup.
  478.  
  479.   - PUBLIC SETUP:  This setup will allow users to download archives from the
  480.     public upload directory, including partially testing archives. In PCBSETUP,
  481.     under Main Board Configuration (and any other conferences you want ULP to
  482.     process), define a private upload directory and a private DIRxx file, and a
  483.     public upload directory and a public DIRxx file (this is where PCBoard will
  484.     place all new non-private uploads since you did not make them private). Be
  485.     sure to set the "make all uploads private" flag to "N".
  486.  
  487. To process your uploads during your system event, add the following lines to
  488. your EVENT.SYS file (be sure to change the drive and path as necessary):
  489.  
  490.     C:
  491.     CD \ULP
  492.     ULP -CULP.CFG
  493.  
  494. ULP will lock the duplication database, preventing any other program from
  495. accessing them (ULPTEST and ULPDB, specifically). Therefore, I strongly suggest
  496. you have all nodes down when running ULP.EXE, or at least disable uploading
  497. during this time.
  498.  
  499. Once you have ULP configured, before you run ULP for the first time, the
  500. process data file must be initialized (either via ULPSM or using ULP.EXE's -I
  501. parameter). The syntax for ULP.EXE is as follows, but please refer to the
  502. manual operation section below for more information:
  503.  
  504.     ULP -CULP.CFG -I
  505.  
  506. This is only done ONCE, and never needs to be done again; ULP maintains this
  507. file as a course of action during normal operation.
  508.  
  509. FOR THE INTEGRATED DUPLICATION SYSTEM (HIGHLY RECOMMENDED):
  510. ───────────────────────────────────────────────────────────
  511. Initially, you must create the duplication database from scratch. If you have
  512. mostly ZIP and ARJ files, then this should be very quick (on the order of 10
  513. minutes per 1000 archives for my 10MHz AT clone on a hard disk; a CD-ROM will
  514. be somewhat slower). After you configure ULP, go to the ULP directory and this
  515. command will create and compile your database of your current downloadable file
  516. base:
  517.  
  518.     ULPDB -CULP.CFG -A@C:\PCB\GEN\DLPATH.LST -S
  519.  
  520. The '@' symbol (a '!' may also be used) indicates to ULPDB that the argument is
  521. a list file, not a directory. The list file must have one path per line, and
  522. each path must end with a trailing backslash. In general, you may simply use
  523. your PCBoard DLPATH.LST file, unless you index your downloads.
  524.  
  525. If you would like to include any off-line files in your duplication database
  526. (or have to add files originally not included in the database) you can
  527. temporarily copy your offline files to a temp directory (for the sake of
  528. argumentation, let's call it "C:\TEMP\"; note the trailing backslash). You can
  529. then add and compile them into the duplication database with the following
  530. command (no list symbol!):
  531.  
  532.     ULPDB -CULP.CFG -AC:\TEMP\ -S
  533.  
  534. After you've added the offline files, just delete them from the disk, and if
  535. someone uploads a file that you already have, it will be rejected.
  536.  
  537. * NOTE: The default method of database generation will be the fastest mode
  538.     since ULPDB will scan ARJ and ZIP archives for data without unpacking. This
  539.     is not as accurate as recursively unpacking the archives since ULPDB can
  540.     only 'see' one level deep into an archive; nested information will not be
  541.     obtained. If this poses a problem, add the -U parameter to the end of the
  542.     command lines above; this will force ULPDB to unpack all archives and
  543.     compute the CRCs. This will be significantly slower than the default
  544.     method, but 100% accurate.
  545.  
  546. If you already have a FWKCS duplication database, you can import and translate
  547. it into the ULP database by using the -I command line parameter. ULPDB will
  548. prompt you for which database format it is, and will then proceed to import it
  549. into the ULP database defined in ULP.CFG:
  550.  
  551.     ULPDB -CULP.CFG -IC:\FWKCS\CSLIST -S
  552.  
  553. Once you have your database built, you should also perform maintenance on the
  554. duplication database files regularly. This will compile any new data from the
  555. day's uploads into the main database, and remove any added temporary data from
  556. ULPTEST. This is not required to be done every day, but it will speed the
  557. duplicate checking of ULP and ULPTEST. To perform database maintenance, add the
  558. following line to your PCBoard EVENT.SYS after the event-mode processor has
  559. run:
  560.  
  561.     C:                    ──────┐        These lines are repeated
  562.     CD \ULP                     ├─────   for clarity.
  563.     ULP -CULP.CFG         ──────┘
  564.     ULPDB -CULP.CFG -S
  565.  
  566. ULPDB also locks the duplication database, preventing any other program from
  567. accessing them. I strongly suggest you have all nodes down when running ULPDB.
  568.  
  569. IF YOU USE PCBOARD'S 'TESTFILE.EXE' UTILITY:
  570. ────────────────────────────────────────────
  571. * NOTE: If you are unfamiliar with the operation of PCBTEST.BAT, you will need
  572.     to refer to the PCBoard manual for an explanation of PCBTEST.BAT and
  573.     TESTFILE.EXE.
  574.  
  575. In general, the use of TESTFILE.EXE is not necessary with ULPTEST. ULPTEST is
  576. fully capable of handling most any situation that arises. However, if you must
  577. use TESTFILE.EXE for some reason, in order to take advantage of the upload
  578. pre-verification abilities of ULPTEST, you must add the extension 'ULP' to the
  579. TESTFILE.EXE extension list. This will allow the file 'VERIFY.ULP' to pass
  580. through the filter created by TESTFILE so that ULPTEST may scan it. You will
  581. also have to add 'EXE' to your extension list if you use TESTFILE.EXE, to allow
  582. SFX archives to be processed by ULPTEST.
  583.  
  584. FOR THE ONLINE UPLOAD TESTING (OPTIONAL):
  585. ─────────────────────────────────────────
  586. Online testing of archives can greatly reduce the amount of garbage your BBS
  587. can pick up from user's uploading defective archives, ancient files, and
  588. duplicates. The theory that ULPTEST uses is to simply check the archive AS
  589. FAST AS IT CAN for archive integrity, duplication, and age, and then return
  590. the user to greater and better things. ULP.EXE will handle everything else
  591. during the system event.
  592.  
  593. * NOTE: In order to use ULPTEST, you must set PCBoard to swap by adding the
  594.     /SWAP switch to the SET PCB= environment variable in BOARD.BAT (in PCBoard
  595.     15.0, this is in PCBSETUP, not the environment variable). Otherwise, there
  596.     will not be enough memory for ULPTEST to execute programs like ARJ, SCAN,
  597.     etc.
  598.  
  599. To use ULPTEST.EXE for on-line testing of archives, use the following command
  600. line in PCBTEST.BAT (refer to the sample PCBTEST.BAT included in the ULP
  601. distribution archive, and the PCBoard manual, to get the general logic of
  602. PCBTEST.BAT's operation). Note the explicit paths to the ULPTEST executable and
  603. the ULP configuration file:
  604.  
  605.     C:\ULP\ULPTEST -CC:\ULP\ULP.CFG -F%1 -M%2 -D%3
  606.  
  607. ULPTEST will garner any other information that is required for operation from
  608. the PCBOARD.DAT and PCBOARD.SYS files. In most installations, ULPTEST will
  609. locate these two system files via the environment variables PCBDAT, PCBDRIVE
  610. and PCBDIR. If the environment variables are used, PCBDIR and PCBDAT are
  611. required; PCBDRIVE is required only if the BBS drop files exist on a different
  612. drive than PCBTEST.BAT is being executed from.
  613.  
  614. * NOTE: Don't rely on PCBoard to create these variables; it only does so prior
  615.     to executing a door. As a last resort, ULPTEST will look in the current
  616.     directory for the files it requires.
  617.  
  618. If you have the environment variables disabled in PCBoard (using the /NOENV
  619. switch), you can define the location of these files by adding the -P parameter:
  620.  
  621.     C:\ULP\ULPTEST -CC:\ULP\ULP.CFG -F%1 -M%2 -D%3 -PC:\PCB\NODE1\
  622.  
  623. Or, or you can provide the port and node number information directly to ULPTEST
  624. by using the -N, -I, -A and -B command switches:
  625.  
  626.     C:\ULP\ULPTEST -CC:\ULP\ULP.CFG -F%1 -M%2 -D%3 -N5 -I4 -A3F8 -B38400
  627.  
  628. where -N is the node number, -I is the port IRQ line, -A is the port base
  629. address (in hex) and -B is the baud rate of the port. If you are using the
  630. DSZPORT environment variable to define the port IRQ and address to DSZ, ULPTEST
  631. will use this information as well. Refer to the documentation for DSZ for the
  632. proper specification of the DSZPORT environment variable.
  633.  
  634. In addition, regardless of the method used to inform ULPTEST of the port
  635. information, ULPTEST defaults to using hardware handshaking. If you want to use
  636. software (XON/XOFF) handshaking or both, use the -H command switch with either
  637. HARDWARE, SOFTWARE or BOTH as the argument:
  638.  
  639.     C:\ULP\ULPTEST -CC:\ULP\ULP.CFG -F%1 -M%2 -D%3 -Hboth
  640.  
  641. ULPTEST is also capable of using a FOSSIL driver, and automatically detects if
  642. you are running PCBoard /M and uses the appropriate FOSSIL port. However, if
  643. you wish to force ULPTEST to use a FOSSIL driver (for example, to access high
  644. IRQs), use the -X command switch with the FOSSIL port number as the argument:
  645.  
  646.     C:\ULP\ULPTEST -CC:\ULP\ULP.CFG -F%1 -M%2 -D%3 -X1
  647.  
  648. During the course of testing, ULPTEST will output the current testing status to
  649. the user online. Note that this information is not displayed locally; it is
  650. being transmitted to the online user only. The program header can be disabled
  651. in registered versions of ULP, making ULPTEST seamless to look like a part of
  652. PCBoard itself. A sample follows:
  653.  
  654.     Verifying FILENAME.ZIP...
  655.     ┌────────────────────────────────┐
  656.     │      UpLoadProcessor 1.00      │  Registered to: Bloom Beacon-Picayune
  657.     │ Copyright 1992-93  Stacy Smith │  Serial number: 1000
  658.     └────────────────────────────────┘
  659.        Identifying file archive format...ZIP
  660.        Screening archive for corruption...OK
  661.        Unpacking archive...OK
  662.        Testing files for viruses, etc...OK
  663.        Checking for duplicate files...OK
  664.        Checking age of files...OK
  665.        Archive passed.
  666.  
  667. ULPTEST will return a DOS errorlevel of 0 if the archive is OK, and an
  668. errorlevel of 1-13 if there was an error (depending on the error). This allows
  669. the PCBTEST.BAT batch file to branch based upon the results of the ULPTEST. The
  670. appendix to this document lists all of the DOS errorlevels set by various ULP
  671. programs.
  672.  
  673. ULPTEST also creates the requires PCBPASS.TXT and PCBFAIL.TXT for PCBoard to
  674. determine if the archive passed or not.
  675.  
  676.  
  677. ┌────────────────────┐
  678. │  9. Configuration  │
  679. └────────────────────┘
  680.  
  681. ULPSM makes the configuration process very easy for the ULP system. The sample
  682. configuration files provided in the distribution archive contain much of the
  683. information required, but needs to be customized to some degree to fit your
  684. application.
  685.  
  686. To begin ULPSM, you must include a configuration filename on the command-line,
  687. denoted by the -C switch. For example, to edit the default configuration file,
  688. ULP.CFG, type:
  689.  
  690.     ULPSM -CULP.CFG
  691.  
  692. and the main menu screen will appear:
  693.  
  694. ┌───────────────────────────────┐┌─────────────── Registered To ──────────────┐
  695. │   ULP System Manager 1.00     ││                UNREGISTERED                │
  696. │ Copyright 1992-93 Stacy Smith ││              SYSOP - S/N 0000              │
  697. └───────────────────────────────┘└────────────────────────────────────────────┘
  698. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  699. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  700. ░░░░░░░░░░░░░░░░░░░░░░░┌────────────────────────────────┐░░░░░░░░░░░░░░░░░░░░░░
  701. ░░░░░░░░░░░░░░░░░░░░░░░│  A - Registration information  │░░░░░░░░░░░░░░░░░░░░░░
  702. ░░░░░░░░░░░░░░░░░░░░░░░│  B - General options           │░░░░░░░░░░░░░░░░░░░░░░
  703. ░░░░░░░░░░░░░░░░░░░░░░░│  C - Upload directories        │░░░░░░░░░░░░░░░░░░░░░░
  704. ░░░░░░░░░░░░░░░░░░░░░░░│  D - Archiving options         │░░░░░░░░░░░░░░░░░░░░░░
  705. ░░░░░░░░░░░░░░░░░░░░░░░│  E - Archivers                 │░░░░░░░░░░░░░░░░░░░░░░
  706. ░░░░░░░░░░░░░░░░░░░░░░░│  F - Virus/file testers        │░░░░░░░░░░░░░░░░░░░░░░
  707. ░░░░░░░░░░░░░░░░░░░░░░░│  G - Duplicate checking        │░░░░░░░░░░░░░░░░░░░░░░
  708. ░░░░░░░░░░░░░░░░░░░░░░░│  H - Age checking              │░░░░░░░░░░░░░░░░░░░░░░
  709. ░░░░░░░░░░░░░░░░░░░░░░░│  I - BBS ad processing         │░░░░░░░░░░░░░░░░░░░░░░
  710. ░░░░░░░░░░░░░░░░░░░░░░░│  J - GIF file testing          │░░░░░░░░░░░░░░░░░░░░░░
  711. ░░░░░░░░░░░░░░░░░░░░░░░│  K - Description processing    │░░░░░░░░░░░░░░░░░░░░░░
  712. ░░░░░░░░░░░░░░░░░░░░░░░│  L - Online testing            │░░░░░░░░░░░░░░░░░░░░░░
  713. ░░░░░░░░░░░░░░░░░░░░░░░│  M - Special-case files        │░░░░░░░░░░░░░░░░░░░░░░
  714. ░░░░░░░░░░░░░░░░░░░░░░░│  N - Init process data file    │░░░░░░░░░░░░░░░░░░░░░░
  715. ░░░░░░░░░░░░░░░░░░░░░░░└────────────────────────────────┘░░░░░░░░░░░░░░░░░░░░░░
  716. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  717. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  718. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  719.  
  720. Using the up and down arrow keys, you can select any of the options. A shortcut
  721. is to type the letter preceding the option you wish to edit. If you press your
  722. escape key (ESC), the following pop-up question box will appear:
  723.  
  724.     ┌─────────────────────────────────────────────────────────────────┐
  725.     │  Do you wish to save the ULP configuration file (Y/N or Esc)?   │
  726.     └─────────────────────────────────────────────────────────────────┘
  727.  
  728. To save any edits you made to the data to the disk configuration file, type
  729. "Y", otherwise type "N" or press the ESC again. Note that, with the exception
  730. of the upload directory configuration information, no data is saved until you
  731. do so when exiting ULPSM.
  732.  
  733. A - REGISTRATION INFORMATION
  734. ────────────────────────────
  735. When selected, the following pop-up box will appear. By using the up and down
  736. arrow keys, you can move the cursor to the desired field to be edited.
  737.  
  738.     ┌───────────────────────────────────────────────────────────────┐
  739.     │  Sysop name         SYSOP                                     │
  740.     │  BBS name           UNREGISTERED                              │
  741.     │  Registration code  0000000000                                │
  742.     └───────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  743.  
  744. Sysop name - Enter EXACTLY as provided to you on your registration letter. If
  745.     this is an unregistered version, leave the default of SYSOP. Note that this
  746.     field is case-sensitive!
  747. BBS name - Enter EXACTLY as provided to you on your registration letter. If
  748.     this is an unregistered version, leave the default of "UNREGISTERED". This
  749.     field is also case-sensitive!
  750. Registration code - Enter EXACTLY as provided to you on your registration
  751.     letter. If this is an unregistered version, leave the default of
  752.     "0000000000". This is also case-sensitive...you get the picture by now...
  753.  
  754. After editing the fields, press F10 to keep the edits, or press ESC to abort
  755. the changes. In either instance, you will be returned to the main menu after
  756. the data has been automatically checked for errors. Any errors detected in the
  757. data will generate a pop-up error window that describes the error.
  758.  
  759. B - GENERAL OPTIONS
  760. ───────────────────
  761. When selected, the following pop-up box will appear. By using the up and down
  762. arrow keys, you can move the cursor to the desired field to be edited.
  763.  
  764.     ┌─────────────────────────────────────────────────────────┐
  765.     │  Error disposition  (Keep/Delete/Rename)  R             │
  766.     │  Virus disposition  (Keep/Delete/Rename)  R             │
  767.     │  Work subdirectory      D:\WORK\                        │
  768.     │  Disk log file          C:\ULP\ULP.LOG                  │
  769.     │  Disk logging mode  (Terse/Verbose)  V                  │
  770.     │  Disk read buffer size  (K)          4                  │
  771.     │  Swapping (None/Ems/Xms/Disk/Auto)   A                  │
  772.     │  Internal file deletion  (Yes/No)    Y                  │
  773.     │  Update DOWNLOAD.TXT file  (Yes/No)  Y                  │
  774.     │  DOWNLOAD.TXT file      C:\PCB\MAIN\DOWNLOAD.TXT        │
  775.     │  Privileged users list  C:\ULP\PRIVUSER.LST             │
  776.     │  File viewing utility   LIST @FILE@                     │
  777.     └─────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  778.  
  779. Error Disposition - This defines how ULP dispositions archives found to have an
  780.     error other than a file check failure. These kind of errors take the form
  781.     of ZIP CRCs, duplication, age, etc., and are not potentially system-
  782.     damaging. Under some conditions, these archives can be restored. If you
  783.     want ULP to delete the failed archive and description, enter "D"; if you
  784.     want ULP to rename the archive to a error extension, enter "R". If, for
  785.     some reason, you wish to keep the files without renaming, enter "K".
  786. Virus Disposition - This defines how ULP dispositions archives that fail a file
  787.     check, such as a virus scan. These errors are potentially system-damaging.
  788.     If you want ULP to delete the failed archive and description, enter "D"; if
  789.     you want ULP to rename the archive to a .CHK extension, enter "R". If you
  790.     wish to keep the defective files without renaming, enter "K".
  791. Work subdirectory - If you want ULP, ULPTEST or ULPDB to use a specific
  792.     subdirectory for storage while processing, enter the full pathname
  793.     (including the trailing backslash; ULPSM will add it if necessary.). The
  794.     drive letter MUST be included. If this directory does not exist at runtime,
  795.     the ULP programs will attempt to create it. This can be set to a RAM disk
  796.     for greater speed. ULP will check the drive specified for at least 5 times
  797.     the archive size before attempting to decompress the archive. If you do not
  798.     desire to use a specific directory, leave it blank (the ULP programs will
  799.     extract on the drive from which it was executed). ULP will also accept an
  800.     environment variable defined using the '%VARIABLE%' convention. Note that
  801.     the environment variable must conform to the rules (trailing backslash,
  802.     path length, etc.).
  803. Disk log file - All of the ULP programs will write process and error
  804.     information to a log file, if desired. This is the path/filename of the log
  805.     file for ULP to record its activities. Leave it blank if you don't want any
  806.     disk logging.
  807. Disk logging mode - If you want ULP and ULPTEST to record statistics for each
  808.     archive processed to the log file (verbose mode), enter "V". If you only
  809.     want errors and disposition information (terse mode), logged to disk, enter
  810.     "T". Verbose mode will quickly produce a large log file, but gives much
  811.     more insight into what ULP is doing and why a particular upload failed.
  812. Disk read buffer size - The size of the disk I/O buffer you wish to allocate in
  813.     kilobytes (valid values are between 2K bytes and 16K bytes). Optimal
  814.     performance is obtained with a value that is a multiple of 2K bytes, since
  815.     this is the size of a typical hard disk cluster. 4K seems to be a good
  816.     number for me, although a larger size may improve performance a little. If
  817.     you find yourself running out of memory when executing archivers or file
  818.     checking programs, reduce this number to increase your available memory.
  819. Swapping - If you wish the ULP programs to swap themselves out of memory prior
  820.     to executing external programs, set this parameter to the type of swapping
  821.     desired (E for EMS, X for XMS, D for disk and A for automatic swap device
  822.     selection). If you do not want this feature, enter "N".  This feature will
  823.     be of most benefit to users using ARJ to compress archives, networked
  824.     systems and small DESQview windows.  Use this feature ONLY if you have a
  825.     memory crunch.
  826. Internal file deletion - If the ULP programs are to delete the extracted files
  827.     themselves, versus using DOS, set this parameter to "Y". If not, enter "N".
  828.     In some cases, letting DOS do the work is faster, but foreign language
  829.     implementations of DOS may prevent this ability, since they do not all use
  830.     "Y" as the acceptance character.
  831. Update DOWNLOAD.TXT file - If ULP is to scan your DOWNLOAD.TXT file and update
  832.     the file extension of the upload to reflect the correct archiving method
  833.     used, enter "Y", otherwise enter "N". This feature will allow utilities
  834.     that scan DOWNLOAD.TXT for file information to reflect correct information.
  835.     If you are using a utility that creates an independent database from the
  836.     DOWNLOAD.TXT file, such as PCBFX version 2.x, be sure ULP.EXE is run in the
  837.     event BEFORE that utility so the independent database reflects the changes
  838.     that ULP makes to DOWNLOAD.TXT.
  839. DOWNLOAD.TXT file - The full path and filename for the DOWNLOAD.TXT file. This
  840.     field is necessary only if the "Update DOWNLOAD.TXT file" is set to "Y".
  841. Privileged user list - ULP can use an ASCII text file to disable duplication
  842.     and age failures if the user's name is listed in this file. If you wish to
  843.     use this function, enter the full path and filename for the list file,
  844.     otherwise, leave it blank. The format of the file is a single name
  845.     per line; case is not important.
  846. File viewing utility - The command line for an ASCII file viewing (or editing)
  847.     utility, such as Vernon Buerg's venerable LIST utility. This will be called
  848.     by ULPDB to facilitate viewing of an archive information file generated for
  849.     the purposes of archive review. Place the @FILE@ variable (all caps) where
  850.     the filename is to be entered on the utility's command line.
  851.  
  852. After editing the fields, press F10 to keep the edits, or press ESC to abort
  853. the changes. In either instance, you will be returned to the main menu after
  854. the data has been automatically checked for errors.
  855.  
  856. C - UPLOAD DIRECTORIES
  857. ──────────────────────
  858. When selected, the following pop-up box will appear. By using the up and down
  859. arrow keys, you can move the cursor to the desired field to be edited.
  860.  
  861.     ┌────────────────────────────────────────────────────────────────┐
  862.     │  Upload directory config file  C:\ULP\ULPDIR.CFG               │
  863.     │  Upload directory definitions page number  (1-8)  1            │
  864.     └───────────────────────────────────────────── [Enter] Continue ─┘
  865.  
  866. Upload directory config file - The filename of the upload directory
  867.     configuration file for ULP. This file is automatically created by ULPSM.EXE
  868.     from data entered in the following screen(s), and must be defined for ULP
  869.     to operate.
  870. Upload directory definitions page number - The editing of the upload
  871.     directories is broken into 8 pages, with 3 directories per screen. You can
  872.     configure a total of 24 directories to be processed by ULP (this was an
  873.     arbitrarily-chosen limit, and can be changed if desired). Enter the number
  874.     of the page you wish to edit.
  875.  
  876. After editing the fields, press ENTER to continue. The following pop-up box
  877. will appear, displaying the page requested:
  878.  
  879.     ┌─────────────────────────────────────────────────────────────────────────┐
  880.     │  Source directory path                  C:\PRIVATE1\                    │
  881.     │  Source directory list file             C:\PCB\GEN\PRIVDIR1             │
  882.     │  Number of header lines in source list  1                               │
  883.     │  Destination directory path             C:\PUBLIC1\                     │
  884.     │  Destination directory list file        C:\PCB\GEN\PUBLDIR1             │
  885.     │                                                                         │
  886.     │  Source directory path                  C:\PUBLIC2\                     │
  887.     │  Source directory list file             C:\PCB\GEN\PUBLDIR2             │
  888.     │  Number of header lines in source list  1                               │
  889.     │  Destination directory path                                             │
  890.     │  Destination directory list file                                        │
  891.     │                                                                         │
  892.     │  Source directory path                                                  │
  893.     │  Source directory list file                                             │
  894.     │  Number of header lines in source list  0                               │
  895.     │  Destination directory path                                             │
  896.     │  Destination directory list file                                        │
  897.     └─ Page 1 of 8 ───────────────────────────────── [F10] Save  [ESC] Abort ─┘
  898.  
  899. Source directory path - The directory where the uploads are placed by PCBoard.
  900.     This must include the trailing backslash, ULPSM will add it if necessary.
  901.     If you have "make all uploads private" in PCBSETUP set to "Y", this will be
  902.     your private upload subdirectory; if set to "N", this will be your public
  903.     upload subdirectory. This path must match EXACTLY the appropriate path in
  904.     PCBSETUP (e.g. don't have one named 'C:\DIR\' and the other just '\DIR\').
  905. Source directory list file - The upload directory list file that corresponds to
  906.     the subdirectory defined in "Source directory path" containing the archive
  907.     descriptions.
  908. Number of header lines in source list - The number of lines to ignore at the
  909.     beginning of the source directory list file (for headers, detachable header
  910.     filespecs, etc.)
  911. Destination directory path - The directory where the uploads are to be placed
  912.     by ULP after processing. This must include the trailing backslash, ULPSM
  913.     will add it if necessary. If you have "make all uploads private" in
  914.     PCBSETUP set to "Y", this will be your public upload subdirectory. If you
  915.     have "make all uploads private" set to "N", leave this field blank.
  916. Destination directory list file - The upload directory list file that
  917.     corresponds to the subdirectory defined in "Destination directory path"
  918.     containing the archive descriptions, or blank if "Destination directory
  919.     path" was left blank.
  920.  
  921. After editing the fields on this page, press F10 to save the edits to the
  922. upload directory configuration file on disk, or press ESC to abort the changes.
  923.  
  924. D - ARCHIVING OPTIONS
  925. ─────────────────────
  926. When selected, the following pop-up box will appear. By using the up and down
  927. arrow keys, you can move the cursor to the desired field to be edited.
  928.  
  929.     ┌─────────────────────────────────────────────────┐
  930.     │  Convert archives  (Yes/No)                  Y  │
  931.     │  Convert nested archives  (Yes/No)           N  │
  932.     │  Convert self-extracting archives  (Yes/No)  N  │
  933.     │  Convert -AV stamped ZIP archives  (Yes/No)  N  │
  934.     │  Convert secured ARJ archives  (Yes/No)      N  │
  935.     └─────────────────────── [F10] Keep  [ESC] Abort ─┘
  936.  
  937. Convert archives - If you want ULP to convert the archive to a default
  938.     archiving format of your choice, enter "Y"; if not, enter "N". This only
  939.     affects the 'root' level of the archive. This flag has no affect on the
  940.     conversion of internal, nested archives.
  941. Convert nested archives - If you want ULP to convert any internal archives
  942.     found inside the archive to your default archiving format, type "Y";
  943.     otherwise, type "N", and they will be rearchived using the original
  944.     archiving method (using the original extension, even if it isn't that
  945.     archiver's default extension). The benefit of converting nested archives is
  946.     that it may save some disk space; on the down side, it will potentially
  947.     break automatic installation programs/batch files that may be contained
  948.     within the archive that expect a certain format nested file.
  949. Convert self-extracting archives - If you want ULP to convert a self-extracting
  950.     (SFX) archive to your default archiving format, type "Y"; if not, type "N".
  951.     If NO is selected, the SFX archive will be processed, and then left alone
  952.     if it passes (NOT re-archived!). The reasoning for this is the LHA
  953.     autostart batch files and other similar features; they are usually used for
  954.     novice users and for automatic installation. By converting SFX archives,
  955.     this may save some disk space, but can cause inconveniences. For example,
  956.     if you don't have PKZnnn.EXE on your BBS, a novice user has no way of
  957.     obtaining the PKZIP utilities from your BBS. If there is a BBS ad in a SFX
  958.     archive, and this flag is set to "N", the ad will remain in the archive.
  959.     Can't be helped at the moment...
  960. Convert -AV stamped ZIP archives - If you want ULP to convert ZIP archives with
  961.     authenticity verification stamps (-AV) to your default format, enter "Y".
  962.     If you set this flag to "N", then the original archive will be retained
  963.     after processing. Note that if there is a BBS ad in a -AV stamped archive,
  964.     and this flag is set to "N", the ad will remain in the archive.
  965. Convert secured ARJ archives - If you want ULP to convert ARJ archives with
  966.     security envelopes (similar to a ZIP -AV), then set this to "Y". If you set
  967.     this flag to "N", then the original archive will be retained. If there is a
  968.     BBS ad in a secured ARJ archive, and this flag is set to "N", the ad will
  969.     remain in the archive.
  970.  
  971. After editing the fields, press F10 to keep the edits, or press ESC to abort
  972. the changes.
  973.  
  974. E - ARCHIVERS
  975. ─────────────
  976. When selected, the following pop-up box will appear:
  977.  
  978.     ┌──────────────────────────────────────────────┐
  979.     │  Archiver definitions page number  (1-3)  1  │
  980.     └─────────────────────────── [Enter] Continue ─┘
  981.  
  982. Archiver definitions page number - The editing of the archiver information is
  983.     broken into 3 pages, with 3 archivers per screen. You can configure a total
  984.     of 9 archivers to be utilized by ULP (this was an arbitrarily-chosen limit,
  985.     and can be changed if desired). Enter the number of the page you wish to
  986.     edit.
  987.  
  988. After editing the field, press ENTER to continue. The following pop-up box will
  989. appear, displaying the page requested:
  990.  
  991.     ┌─────────────────────────────────────────────────────────────────────────┐
  992.     │ Extension  ARC    Primary format (Yes/No)  N   Successful errorlevel  0 │
  993.     │ Pack     c:\util\pkpak -a @ARC@ @FILE@                                  │
  994.     │ Unpack   c:\util\pkunpak -r @ARC@                                       │
  995.     │ Test     c:\util\pkunpak -t @ARC@                                       │
  996.     │ Comment                                                                 │
  997.     │                                                                         │
  998.     │ Extension  ARJ    Primary format (Yes/No)  N   Successful errorlevel  0 │
  999.     │ Pack     c:\util\arj a -e -jm -m1 @ARC@ @FILE@                          │
  1000.     │ Unpack   c:\util\arj e -y @ARC@                                         │
  1001.     │ Test     c:\util\arj t @ARC@                                            │
  1002.     │ Comment  c:\util\arj c -zc:\ulp\comment.txt @ARC@                       │
  1003.     │                                                                         │
  1004.     │ Extension  HYP    Primary format (Yes/No)  N   Successful errorlevel  0 │
  1005.     │ Pack     c:\util\hyper -a @ARC@ @FILE@                                  │
  1006.     │ Unpack   c:\util\hyper -x @ARC@                                         │
  1007.     │ Test     c:\util\hyper -v @ARC@                                         │
  1008.     │ Comment                                                                 │
  1009.     └─ Page 1 of 3 ───────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1010.  
  1011. Extension - The default extension for this particular archiving format. ULP is
  1012.     capable of automatically detecting ARC, ARJ, HYP, LZH, PAK, SQZ, ZIP and
  1013.     ZOO archives, and will process them regardless of extension. If you add
  1014.     another archiver that is not automatically detected by ULP, it will be
  1015.     detected by the configured extension only.
  1016. Primary format - If this is the default archiving format you use on your BBS,
  1017.     type "Y"; if not, type "N". There can be only one default archiver, and
  1018.     in the event more than one flag is set, ULPSM will take the first one in
  1019.     the list with the flag set as the default.
  1020. Successful errorlevel - The errorlevel that the archiver returns upon a
  1021.     successful execution. This information should be available in the program's
  1022.     documentation. This is how ULP determines if an archiver is functioning
  1023.     properly, so any archiver configured must return errorlevels that are
  1024.     different for success than errors.
  1025. Pack - The command line to pack archives, including all command-line switches
  1026.     desired. Place the variable @ARC@ (all caps) where the filename is to be
  1027.     inserted in the command line and @FILE@ (also all caps) where the filespec
  1028.     is to be inserted. This cannot be a batch file, nor is DOS re-direction
  1029.     allowed. If you do not explicitly define the path to your archiver(s), it
  1030.     must in a directory included in the DOS 'PATH' environment variable.
  1031. Unpack - The command line to unpack archives, including all command-line
  1032.     switches desired. Place the variable @ARC@ where the filename is to be
  1033.     inserted in the command line. This cannot be a batch file, nor is DOS
  1034.     re-direction allowed.
  1035. Test - The command line for the archiver to test archive integrity, including
  1036.     all command-line switches desired. Place the variable @ARC@ where the
  1037.     filename is to be inserted in the command line. This cannot be a batch
  1038.     file, nor is DOS re-direction allowed.
  1039. Comment - The command line to comment archives. Place the variable @ARC@ where
  1040.     the filename is to be inserted in the command line. If the archiver does
  1041.     not support comments, or if you do not wish to add comments, leave the
  1042.     field blank. This cannot be a batch file, but DOS redirection is permitted
  1043.     to pipe a file into the archiver (PKZIP, for example).
  1044.  
  1045. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1046. the changes.
  1047.  
  1048. F - VIRUS/FILE TESTERS
  1049. ──────────────────────
  1050. When selected, the following pop-up box will appear. By using the up and down
  1051. arrow keys, you can move the cursor to the desired field to be edited.
  1052.  
  1053.     ┌─────────────────────────────────────────────────────────────────────────┐
  1054.     │  Command 1  h:\util\scan /a /nomem /nopause @FILE@                      │
  1055.     │  Successful errorlevel  0                                               │
  1056.     │                                                                         │
  1057.     │  Command 2                                                              │
  1058.     │  Successful errorlevel  0                                               │
  1059.     │                                                                         │
  1060.     │  Command 3                                                              │
  1061.     │  Successful errorlevel  0                                               │
  1062.     └─────────────────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1063.  
  1064. Command n - The command line to execute for the file checker, including all
  1065.     command-line switches. Place the variable @FILE@ where the filespec is to
  1066.     be placed on the command line. This cannot be a batch file, nor is DOS
  1067.     re-direction allowed. Any kind of file checker may be used, such as a virus
  1068.     checker or a BBS ads checker, if desired; they will be executed in the
  1069.     order defined in this screen. If you do not explicitly define the path to
  1070.     your file checking program(s), it must in a directory included in the DOS
  1071.     PATH environment variable. Note that if you are running a network, the use
  1072.     of network-specific scanners may be necessary (e.g. McAfee's SCAN and
  1073.     NETSCAN).
  1074. Successful errorlevel - The errorlevel that the file checker returns upon a
  1075.     successful execution. This information should be available in the program's
  1076.     documentation. This is how ULP determines if the file checker detected a
  1077.     defect, so any file checker configured must return errorlevels that are
  1078.     different for success than errors.
  1079.  
  1080. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1081. the changes.
  1082.  
  1083. G - DUPLICATE CHECKING
  1084. ──────────────────────
  1085. When selected, the following pop-up box will appear. By using the up and down
  1086. arrow keys, you can move the cursor to the desired field to be edited.
  1087.  
  1088.     ┌────────────────────────────────────────────────────────────────────────┐
  1089.     │  Duplication checking  (None/Internal/Zdcs)  I                         │
  1090.     │  Total duplication limit  (%)                55                        │
  1091.     │  Executable dupe limit  (%)                  80                        │
  1092.     │  Duplication database        C:\ULP\DATABASE.DB                        │
  1093.     │  Duplication database index  C:\ULP\DATABASE.IDX                       │
  1094.     │  ZDCS subdirectory                                                     │
  1095.     └────────────────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1096.  
  1097. Duplication checking - If you want ULP to use its internal duplication system
  1098.     checking, type "I". If you want to use the ZDCS external duplication system
  1099.     by Mike Cocke (with the required ZCDSULP interface program), enter "Z". If
  1100.     you desire no duplication checking at all, type "N".
  1101. Total duplication limit - The minimum percentage of duplication allowed for a
  1102.     file to pass. Anything SMALLER will pass regardless of the executable
  1103.     duplication limit. I would suggest this number be set to around 55, as some
  1104.     program authors don't modify every file, especially with maintenance
  1105.     releases. This limit is implemented for both ULP's internal and ZDCS
  1106.     duplication systems.
  1107. Executable dupe limit - The maximum percentage of duplication allowed for
  1108.     executable files and overlays to pass. This number should be higher than
  1109.     the total duplication limit; I would recommend about 80. This will catch
  1110.     archives that are duplicates, but someone has changed enough files to
  1111.     normally pass it when uploaded (such as configs, high score files, etc.).
  1112.     This will also pass files where the author has changed nothing but the
  1113.     executables; they would have failed before. Executables are determined
  1114.     solely by extension; any file with one of the following extensions will be
  1115.     counted as an executable: EXE, COM, SYS, OVL, OVR, DLL. This limit is also
  1116.     implemented for both ULP's internal and ZDCS duplication systems.
  1117. Duplication database - The path and name for the duplication database file.
  1118.     It's a good idea to keep the database and index file together, just to make
  1119.     things easier. This file is used for ULP's internal duplication system
  1120.     only.
  1121. Duplication database index - The path and name for the duplication database
  1122.     file index. This file is also used for ULP's internal duplication system
  1123.     only.
  1124. ZDCS subdirectory - The complete path for your ZDCS files (used only for the
  1125.     ZDCS duplication system). You must include the trailing backslash and drive
  1126.     letter; ULPSM will add it if necessary.
  1127.  
  1128. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1129. the changes.
  1130.  
  1131. H - AGE CHECKING
  1132. ────────────────
  1133. When selected, the following pop-up box will appear. By using the up and down
  1134. arrow keys, you can move the cursor to the desired field to be edited.
  1135.  
  1136.     ┌──────────────────────────────────────────┐
  1137.     │  Age checking  (None/Average/neWest)  A  │
  1138.     │  Minimum age  (months)  48               │
  1139.     └──────────────── [F10] Keep  [ESC] Abort ─┘
  1140.  
  1141. Age checking - If you want ULP to fail an archive based on the average age of
  1142.     the files contained within, enter "A". If you want rejection based upon the
  1143.     age of the newest file, enter "W". Otherwise, if you don't want age
  1144.     checking, enter "N".
  1145. Minimum average age - The maximum average age in months, that you will accept
  1146.     for an upload.
  1147.  
  1148. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1149. the changes.
  1150.  
  1151. I - BBS AD PROCESSING
  1152. ─────────────────────
  1153. When selected, the following pop-up box will appear. By using the up and down
  1154. arrow keys, you can move the cursor to the desired field to be edited.
  1155.  
  1156.     ┌─────────────────────────────────────────────────────────────┐
  1157.     │  Remove BBS ads  (Yes/No)   Y                               │
  1158.     │  BBS ad detection database  C:\ULP\ULPADS.DB                │
  1159.     │  BBS ad file to insert                                      │
  1160.     └─────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1161.  
  1162. Remove BBS ads - If you want ULP to remove known BBS ads from new uploads
  1163.     during processing, type "Y"; if not, type "N". Only ULP.EXE and ULPTEST
  1164.     SLOW mode removes BBS ads; ULPTEST FAST and NORMAL modes do not, but the
  1165.     upload will have any BBS ads removed later in the event.
  1166. BBS ad detection database - The path and name for the BBS ads database. This
  1167.     database can be updated by the sysop by using the ULPADS utility (see
  1168.     section 11 of this document), freeing the sysop from being reliant on me to
  1169.     maintain the ads database. If you find a large number of new BBS ad files,
  1170.     please upload them to my board for inclusion into my master ads database.
  1171. BBS ad file to insert - The path and filename for your BBS ad to be added to
  1172.     each and every archive processed by ULP. If you do not wish to insert a BBS
  1173.     ad, leave the field blank. Note that you must provide a drive and path, or
  1174.     it will not be copied. I STRONGLY recommend against them; BBS ads are
  1175.     aggravating to other sysops, so please be considerate and use the ARJ or
  1176.     ZIP comment instead. BBS ad files are the scourge of the BBS world.
  1177.  
  1178. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1179. the changes.
  1180.  
  1181. J - GIF FILE CHECKING
  1182. ─────────────────────
  1183. When selected, the following pop-up box will appear. By using the up and down
  1184. arrow keys, you can move the cursor to the desired field to be edited.
  1185.  
  1186. * NOTE: If you desire no GIF file testing by ULP, set all minimum image
  1187.         parameters (width, height and colors) to 0 and blank out the GIF file
  1188.         tester command line.
  1189.  
  1190.     ┌─────────────────────────────────────────────────────────────────────────┐
  1191.     │  Minimum image width  (columns)  320                                    │
  1192.     │  Minimum image height  (rows)    200                                    │
  1193.     │  Minimum number of colors        16                                     │
  1194.     │  Keep GIFLITE'd files  (Yes/No)  N                                      │
  1195.     │  Command  giftest /b:0 /l:c:\ulp\giftest.log @FILE@                     │
  1196.     │  Successful errorlevel  0                                               │
  1197.     └─────────────────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1198.  
  1199. Minimum image width - If ULP is to reject GIF files based upon image width,
  1200.     enter the minimum acceptable width in pixels. If no width limit is desired,
  1201.     set it to zero.
  1202. Minimum image height - If ULP is to reject GIF files based upon image height,
  1203.     enter the minimum acceptable height in pixels. If no height limit is
  1204.     desired, set it to zero.
  1205. Minimum number of colors - If ULP is to reject GIF files based upon the number
  1206.     of colors in the image, enter the minimum acceptable number of colors. If
  1207.     no color limit is desired, set it to zero.
  1208. Keep GIFLITE'd files - If ULP is to keep uploaded GIF files if they have been
  1209.     compressed with GIFLITE, set this to "Y". If not, set it to "N". At this
  1210.     time, if you use GIFTEST, this parameter will have no effect; GIFLITE'd
  1211.     files will always be rejected. Accepting GIFLITE'd GIF files can compromise
  1212.     the duplication system due to its variable compression ratio! I strongly
  1213.     suggest you do not accept GIFLITE'd GIF files!
  1214. Command - The command line to execute for the GIF file checker, including all
  1215.     command-line switches. Place the variable @FILE@ where the filespec is to
  1216.     be placed on the command line. This cannot be a batch file, nor is DOS
  1217.     re-direction allowed.  If no GIF tester is desired, leave this field
  1218.     blank.
  1219. Successful errorlevel - The errorlevel that the GIF file checker returns upon a
  1220.     successful execution. This information should be available in the program's
  1221.     documentation. This is how ULP determines if the GIF file checker detected
  1222.     a defect in the GIF file, so the GIF file checker configured must return
  1223.     errorlevels that are different for success than errors.
  1224.  
  1225. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1226. the changes.
  1227.  
  1228. K - DESCRIPTION PROCESSING
  1229. ──────────────────────────
  1230. When selected, the following pop-up box will appear. By using the up and down
  1231. arrow keys, you can move the cursor to the desired field to be edited.
  1232.  
  1233.     ┌─────────────────────────────────────────────────────────────────────────┐
  1234.     │  Strip lost descriptions  (Yes/No)             N                        │
  1235.     │  Smart word wrap descriptions  (Yes/No)        Y                        │
  1236.     │  Strip high ASCII from descriptions  (Yes/No)  N                        │
  1237.     │  Insert internal description files  (Yes/No)   Y                        │
  1238.     │  Maximum number of description lines           10                       │
  1239.     │  Number of columns to indent secondary lines   32                       │
  1240.     │  Insert error description line  (Yes/No)       Y                        │
  1241.     │  Insert lack of description line  (Yes/No)     Y                        │
  1242.     │  Archive information line format                                        │
  1243.     │  (Files: @#@ Newest: @NEW@ Oldest: @OLD@)                               │
  1244.     │  GIF information line format                                            │
  1245.     │  (Resolution: @WID@x@HGT@x@COLOR@  Comp: @COMP@)                        │
  1246.     └─────────────────────────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1247.  
  1248. Strip lost descriptions - If you want ULP to remove "lost" descriptions from
  1249.     the source listing that do not have a corresponding file in the source
  1250.     subdirectory, enter "Y", otherwise, type "N". This is an excellent tool for
  1251.     cleaning up stray descriptions after files have been deleted for some
  1252.     reason.
  1253. Smart word wrap descriptions - If you want ULP to word-wrap descriptions, enter
  1254.     "Y", otherwise, type "N". Due to it's smart word-wrapping, ULP checks for
  1255.     box-draw characters before word-wrapping.
  1256. Strip high ASCII from descriptions - If you want ULP to strip high ASCII and
  1257.     control characters from archive descriptions prior to insertion, enter "Y",
  1258.     otherwise, enter "N". When turned on, ULP will strip all illegal characters
  1259.     (per the FILE_ID.DIZ specification) from descriptions prior to insertion,
  1260.     leaving the text description intact.
  1261. Insert internal description files - ULP can extract and insert FILE_ID.DIZ and
  1262.     DESC.SDI internal description files into the directory list files. If you
  1263.     want ULP to insert internal description files, type "Y"; if not, type "N".
  1264.     Note that ULP gives priority to FILE_ID.DIZ in the event the same archive
  1265.     contains both a FILE_ID.DIZ and a DESC.SDI file.
  1266. Maximum number of description lines - When ULP is to insert internal
  1267.     description files, this is the maximum number of lines that ULP will insert
  1268.     from the description file. Although up to 60 lines can be inserted, Clark
  1269.     Development Company (the developer of PCBoard and FILE_ID.DIZ) has defined
  1270.     that a FILE_ID.DIZ file should have no more than 10 lines.
  1271. Number of columns to indent secondary lines - The column where the '|' marker
  1272.     goes in your directory listing setup for secondary description lines and
  1273.     information lines added by ULP. The standard PCBoard setup indents to
  1274.     column 32.
  1275. Insert error description line - If you want ULPTEST to add a canned line to the
  1276.     description of failed archives describing the failure, enter "Y",
  1277.     otherwise, type "N". Note that ULP.EXE will not add this line, nor will it
  1278.     strip this error line if the file is processed in override mode.
  1279. Insert lack of description line - If you want ULP.EXE to insert a canned "No
  1280.     description available" line for the description of any file that does not
  1281.     have any description associated with it, set this to "Y". If you wish for
  1282.     the file to remain in the source area without a description of any kind,
  1283.     set to "N".
  1284. Archive information line format - The format that you would like for the
  1285.     archive information line (do not include the '|' character or the following
  1286.     space; ULP will add those). If you do not wish to include an archive
  1287.     information line, blank this field out. This format is completely
  1288.     configurable by the user; any ASCII character can be used. To include
  1289.     specific information compiled by ULP, just add the variables. The legal
  1290.     variables must be in all caps, and are as follows:
  1291.         @#@     Number of files in the archive (and nested archives)
  1292.         @NEW@   Date of the newest file in the archive
  1293.         @OLD@   Date of the oldest file in the archive
  1294.         @BYTE@  The total number of bytes (uncompressed) in the archive
  1295.         @DATE@  Today's date
  1296.         @CR@    Inserts a line break for multiline capability
  1297. GIF information line format - The format that you would like for the GIF
  1298.     information line (again, do not include the '|' character or the space). If
  1299.     you do not wish to include a GIF information line, blank this field out.
  1300.     The legal variables are:
  1301.         @WID@    Horizontal resolution (number of columns)
  1302.         @HGT@    Vertical resolution (number of rows)
  1303.         @COLOR@  Number of colors in GIF
  1304.         @COMP@   Inserts "GIFLITE" or "None", depending upon compression
  1305.         @DATE@   Today's date
  1306.         @CR@     Inserts a line break for multiline capability
  1307.  
  1308. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1309. the changes.
  1310.  
  1311. L - ONLINE TESTING
  1312. ──────────────────
  1313. When selected, the following pop-up box will appear. By using the up and down
  1314. arrow keys, you can move the cursor to the desired field to be edited.
  1315.  
  1316.     ┌──────────────────────────────────────────────────────┐
  1317.     │  Default online test mode  (Fast/Normal/Slow)  S     │
  1318.     │  Maximum file size for slow mode  (K)          250   │
  1319.     │  Maximum file size for normal mode  (K)        500   │
  1320.     │  Generate remote user status screen  (Yes/No)  N     │
  1321.     │  Suppress ULP header in serial I/O  (Yes/No)   N     │
  1322.     └──────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1323.  
  1324. Default online test mode - This defines the default mode that ULPTEST processes
  1325.     an archive. The default mode is the mode that ULPTEST *starts* in, and then
  1326.     is forced into the faster mode(s) by the limits defined.
  1327.     SLOW mode fully processes the archive, identical to the ULP event
  1328.         processing except that the archive formats are not converted. Note that
  1329.         archive conversion is not possible in SLOW mode due to limitations of
  1330.         PCBoard and the file will not be reprocessed by ULP.EXE in the event.
  1331.         Also note that you MUST make all uploads public for SLOW mode to work
  1332.         properly. This mode is intended to emulate the operation of other
  1333.         testers like EXZTest and Ziplab. Enter "S" to use this mode.
  1334.     NORMAL mode is a full *test*, except the archive is not repacked, saving a
  1335.         significant amount of the testing time for the online user. Enter "N"
  1336.         to use this mode of operation.
  1337.     FAST indicates a fast test in which the archive is scanned for archive
  1338.         integrity, duplicates, and age without unpacking the archive (ARJ and
  1339.         ZIP files only). If this mode is used, it should be held for later
  1340.         reprocessing by ULP.EXE so that it can be file-checked. Note that FAST
  1341.         mode can only 'see' one level deep in the archive. If you have a slow
  1342.         computer and/or hard disk, FAST mode would be preferable for your users
  1343.         when large archives are uploaded. Enter "F" to utilize this mode.
  1344. Maximum file size for slow mode - If SLOW mode is used, the archive's file size
  1345.     will first be compared against this limit (in kilobytes). If it is larger
  1346.     than this number of bytes (in kilobytes), it will be forced into NORMAL
  1347.     mode to speed the process and prevent wasting the user's online time.
  1348.     Entering 0 will disable this feature, resulting in SLOW mode being used at
  1349.     all times. If the default online test mode is set to NORMAL or FAST, this
  1350.     parameter has no effect.
  1351. Maximum file size for normal mode - If NORMAL mode is used (or has been forced
  1352.     due to an upload exceeding the slow mode size limit), the archive's file
  1353.     size will be compared against this limit (in kilobytes). If it is larger
  1354.     than this number of kilobytes, it will be forced into FAST mode to speed
  1355.     the process and prevent wasting the user's online time. Entering 0 will
  1356.     disable this feature, resulting in NORMAL mode being used at all times. If
  1357.     the default test mode is set to FAST, this parameter has no effect.
  1358. Generate online user status - If you want ULPTEST to output status information
  1359.     to the user on-line, set this flag to "Y"; if you do not want ULPTEST to
  1360.     output status information, enter "N". ULPTEST supports both direct
  1361.     interrupt-driven I/O (IRQs 2-7) and FOSSIL driver I/O.
  1362. Suppress ULP header in serial I/O - If you want ULPTEST to suppress the program
  1363.     header output to the user via the COM port (the program name, copyright
  1364.     notice, and registration information). This gives a seamless look for ULP
  1365.     into PCBoard. If this is desired, set this flag to "Y"; otherwise, set it
  1366.     to "N". This feature will work for registered users only!
  1367.  
  1368. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1369. the changes.
  1370.  
  1371. M - SPECIAL-CASE FILES
  1372. ──────────────────────
  1373. When selected, the following pop-up box will appear. By using the up and down
  1374. arrow keys, you can move the cursor to the desired field to be edited.
  1375.  
  1376.     ┌────────────────────────────────────────────────────┐
  1377.     │  Uncompressed extensions to process and compress   │
  1378.     │  DOC  TXT  COM                                     │
  1379.     │                                                    │
  1380.     │                                                    │
  1381.     │  Extensions to pass without processing             │
  1382.     │  CPT  SIT                                          │
  1383.     │                                                    │
  1384.     └────────────────────────── [F10] Keep  [ESC] Abort ─┘
  1385.  
  1386. Uncompressed extensions to process and compress - ULP can process selected
  1387.     uncompressed uploads, using this option. Up to 24 uncompressed file types
  1388.     can be specified by extension. Do not use any compression format extensions
  1389.     (ARJ, ZIP, etc.)! Any files that are uploaded with one of these extensions
  1390.     and could not be identified by signature will be file-checked,
  1391.     duplicate-checked, and compressed using your default archiving method (in
  1392.     the event). If you do not want to use this feature, simply blank all of the
  1393.     fields. It probably is not a good idea to have EXE as an extension to
  1394.     compress, since ULP is not able to detect ARC, HYP or ZOO self-extractors,
  1395.     and they would be packed again as an uncompressed archive.
  1396. Extensions to pass without processing - ULP can be forced to NOT process
  1397.     selected uploads, using this option. Up to 24 file types can be specified
  1398.     by extension. THESE FILES WILL BE AUTOMATICALLY PASSED WITHOUT ANY TESTING;
  1399.     be sure this is desired. This is intended for use with non-DOS uploads,
  1400.     such as the Unix Tar Z format, or Macintosh files. Since these files will
  1401.     NOT be tested for viruses, etc., note this fact to your users.
  1402.  
  1403. After editing the fields, press F10 to keep the edits, or press ESC to abort
  1404. the changes.
  1405.  
  1406. N - INIT PROCESS DATA FILE
  1407. ──────────────────────────
  1408. When selected, the following pop-up box will appear. By using the up and down
  1409. arrow keys, you can move the cursor to the desired field to be edited.
  1410.  
  1411.     ┌─────────────────────────────────────────────────────┐
  1412.     │  Process data file  C:\ULP\PROCESS.DAT              │
  1413.     │  Initialize process data file  N                    │
  1414.     └───────────────────────────── [F10] Go  [ESC] Abort ─┘
  1415.  
  1416. Process data file - The path and filename of the ULP process data file. This
  1417.     file contains information on previous ULP archive processing and is
  1418.     maintained automatically by ULP. This file must exist, or ULP will not
  1419.     operate.
  1420. Initialize process data file - If you want ULPSM to initialize the process data
  1421.     file when the F10 key (Go) is pressed, enter "Y", otherwise leave it as
  1422.     "N". Note that the process data file can also be initialized using ULP.EXE
  1423.     with the -I command line switch.
  1424.  
  1425. After editing the fields, press F10 to initialize the process data file and
  1426. keep the edits, or press ESC to abort the changes.
  1427.  
  1428.  
  1429. ┌────────────────────────┐
  1430. │  10. Manual Operation  │
  1431. └────────────────────────┘
  1432.  
  1433. While the ULP system is mostly automatic, there are occasions where some
  1434. operations may have to be done manually:
  1435.  
  1436. ULP:
  1437. ────
  1438. During the course of operation, ULP will rename archives that have been found
  1439. to be defective in some manner according to the following convention:
  1440.  
  1441.     .UNK    Unknown archive format
  1442.     .DOS    DOS reserved keyword found in archive
  1443.     .ERR    Error occurred while unpacking archive (archive integrity failure)
  1444.     .CHK    Error found while file checking archive file (virus, etc.)
  1445.     .DUP    Excessive duplicate files contained in archive
  1446.     .PCK    Error occurred while repacking archive file
  1447.     .AGE    Age limit exceeded by archive file
  1448.     .ENC    Encrypted file found in archive
  1449.     .BAD    Error found while testing GIF file
  1450.     .RES    Unacceptable GIF resolution
  1451.     .GLT    GIF compressed with GIFLITE
  1452.     .WRK    Unable to create work space for processing file
  1453.  
  1454. I would enter these extensions in your UPSEC file, as ULP will automatically
  1455. pass over any file with these extensions, presuming that they are defective
  1456. archives. Doing so will prevent a user from uploading a file with one of these
  1457. "reserved" extensions.
  1458.  
  1459. If you feel that these files are acceptable after reviewing them, you can force
  1460. them to be accepted by adding the command-line switch -O (for override) to the
  1461. ULP command line, e.g.:
  1462.  
  1463.     ULP -CULP.CFG -O
  1464.  
  1465. This will accept the archives regardless of duplication or age limits. It will
  1466. not override unpacking, packing, integrity and virus errors, however, for the
  1467. safety of your board and your users.
  1468.  
  1469. To initialize the ULP process database without using ULPSM, use the -I command
  1470. line switch:
  1471.  
  1472.     ULP -CULP.CFG -I
  1473.  
  1474. ULP will scan your source upload directories as configured and generate a
  1475. process data file. From then on, ULP will maintain this data file
  1476. automatically.
  1477.  
  1478. Three other command-line parameters are available in ULP. '-R' will retest all
  1479. archives found in the subdirectory passed to it. It will not use duplication
  1480. checking or age checking, nor will it repack the archive; it was installed to
  1481. allow the periodic retesting of archives for viruses, etc.:
  1482.  
  1483.     ULP -CULP.CFG -Rc:\temp\
  1484.  
  1485. Another, '-M' will retest and convert all archives found in the subdirectory
  1486. indicated; this can be used for mass archive conversion:
  1487.  
  1488.     ULP -CULP.CFG -Mc:\temp\
  1489.  
  1490. Note that the '-R' and '-M' switches cannot be used on a CD-ROM or other
  1491. write-protected media at this time.
  1492.  
  1493. ULPTEST:
  1494. ────────
  1495. If you wish to run ULPTEST without any drop files for comm port configuration
  1496. (e.g. PCBOARD.DAT, PCBOARD.SYS, etc.), add the '-L' command-line switch to
  1497. force comm I/O off and prevent the search for drop files. For example:
  1498.  
  1499.     ULPTEST -CULP.CFG -F%1 -M%2 -D%3 -N%PCBNODE% -L
  1500.  
  1501. * NOTE:  When ULPTEST is run in local mode, it is not possible to support
  1502.     privileged users, since the user's name can only be extracted from
  1503.     PCBOARD.SYS.
  1504.  
  1505. You should also pass the node number with the -N parameter, as ULPTEST does not
  1506. have access to the drop files where this information is available. Otherwise,
  1507. it will default to a node number of 9999.
  1508.  
  1509. ULPDB:
  1510. ──────
  1511. If a file has been failed for some reason, you can view the contents of the
  1512. archive using the -V command switch with ULPDB. This will scan the archive, and
  1513. generate a report of the results, which are indicative of why it failed. For
  1514. example:
  1515.  
  1516.     ULPDB -CULP.CFG -Vc:\privul\archive.dup
  1517.  
  1518. This will produce a report of the archive ARCHIVE.DUP located in the specified
  1519. path. This can be useful in determining if an archive that failed duplication
  1520. should be removed or should be accepted anyway, and similar reasons.
  1521.  
  1522. In addition, duplication databases can be merged using the -M command-line
  1523. option. In order to merge a second database into your main database:
  1524.  
  1525.     ULPDB -CULP.CFG -Msecond.db
  1526.  
  1527. where 'second.db' is the full path and filename for the second duplication
  1528. database to be merged with the main duplication database.  This will allow
  1529. pre-built databases to be constructed for CD-ROM disks for easy implementation.
  1530.  
  1531. Finally, database entries can be purged from the database using the file date
  1532. contained in the database record using the -P command switch:
  1533.  
  1534.     ULPDB -CULP.CFG -P60
  1535.  
  1536. where '60' is the maximum age (in months) for a file to remain in the database.
  1537. Removal is based upon the file date represented by the entry, NOT the date the
  1538. file entry was made into the database; these are not one and the same. In the
  1539. example above, all records for files older than 60 months (5 years) will be
  1540. removed from the database. As a protective measure, ULPDB will not perform a
  1541. purge if the value specified is less than 6 months.
  1542.  
  1543.  
  1544. ┌──────────────────────────┐
  1545. │  11. BBS Ads and ULPADS  │
  1546. └──────────────────────────┘
  1547.  
  1548. The ULP system includes a BBS ad removal feature based on CRC-32 calculation of
  1549. the file contents and other data. In this fashion, ULP can detect a known ad
  1550. file despite the file name and date.
  1551.  
  1552. In order for sysops to be able to 'keep up' with new ads produced by the weenie
  1553. sysops who insert the @!&*#%$ things, I have included a utility called ULPADS
  1554. that can scan a BBS ad file, and update the BBS ads with it's information.
  1555. Don't worry about duplication, as part of the process is to purge duplicate BBS
  1556. ad info. The command-line syntax for the ULPADS.EXE program is simply:
  1557.  
  1558.     ULPADS -Ddatabase.ad -Fbbs.ad
  1559.  
  1560. where 'database.ad' is the full path and filename for the BBS ads database, and
  1561. 'bbs.ad' is the path and filename for the BBS ad file to be added to the ads
  1562. database.
  1563.  
  1564. If you have a subdirectory full of BBS ads, the following batch file provided
  1565. by Ian Singer may be of help:
  1566.  
  1567.     rem DELADS.BAT
  1568.     rem this batch file written by Ian Singer 1 Jul 92 to take all
  1569.     rem the bbs ads in c:\ulp\ad and run them against the database
  1570.     rem in c:\ulp
  1571.     rem
  1572.     for %%f in (c:\ulp\ad\*.*) do ULPADS -Dc:\ulp\ulpads.db -F%%f
  1573.  
  1574. I would greatly appreciate your uploading of any new BBS ad files that you may
  1575. collect over time to my BBS so I can update the master listing that I include
  1576. with the ULP distribution archive. Please refer to the top of this document for
  1577. my BBS number.
  1578.  
  1579. The latest version of my BBS ads database is included in the distribution
  1580. archive. In order to add whatever new BBS ads information that may be
  1581. contained, you can merge the two BBS databases:
  1582.  
  1583.     ULPADS -Dmaster.db -Mother.db
  1584.  
  1585. where 'master.db' is the full path and filename for the master (your) BBS ads
  1586. database, and 'other.db' is the path and filename for the other BBS ads
  1587. datatbase to be merged with the master ads database.
  1588.  
  1589.  
  1590. ┌───────────────┐
  1591. │  12. Support  │
  1592. └───────────────┘
  1593.  
  1594. If you require support for ULP, I can be contacted by any of the following
  1595. means:
  1596.  
  1597.     ∙ Fidonet netmail (node:  1:151/106)
  1598.     ∙ Internet private mail to "stacy.smith@cencore.com"
  1599.     ∙ Fidonet, ILink and Intelec PCBoard and Sysops conferences
  1600.     ∙ My Support conference (#2 on my BBS) which is linked to the Salt Air
  1601.       (PCBoard home system) ULP Support conference, as well as the Intelec
  1602.       and SmartNet networks' ULP Support conferences
  1603.     ∙ The ILink ULP Support conference (separate and distinct, #3 on my BBS).
  1604.     ∙ The RIME ULP Support conference (separate and distinct)
  1605.  
  1606.  
  1607. ┌─────────────────────────┐
  1608. │  13. The Future of ULP  │
  1609. └─────────────────────────┘
  1610.  
  1611. ULP will be supported as long as I'm in the BBSing business (which will be
  1612. quite a while...once it's in your blood, you can never shake it <grin>). The
  1613. ULP system will be rapidly expanding it's features so it will be your first
  1614. choice in BBS upload processors. Some current plans:
  1615.  
  1616.       ∙ Add the ability to preprocess files prior to file checking them;
  1617.         for example, decompress executables that have been PKLite'd.
  1618.       ∙ Support other BBS software directory listing formats.
  1619.  
  1620. If you have any other suggestions, or want other archivers supported, please
  1621. contact me via Email, U.S. snail-mail or on my BBS at the number at the top of
  1622. this document.
  1623.  
  1624. Thanks for giving ULP a try!
  1625.  
  1626.  
  1627. ┌────────────────────────────────┐
  1628. │  Appendix A:  DOS Errorlevels  │
  1629. └────────────────────────────────┘
  1630.  
  1631. The errorlevels returned to DOS by the ULP system programs are consistent
  1632. among all of the programs (primarily with the error conditions); the following
  1633. is a list of the errorlevels than can be returned by the ULP programs, along
  1634. with which programs return the codes:
  1635.  
  1636.     0       Successful execution (ULPTEST, ULPDB, ULPADS)
  1637.     0       Successful execution, archives were processed (ULP)
  1638.     1       Successful execution, nothing to do (ULP)
  1639.     1       Unknown archive format (ULPTEST)
  1640.     2       DOS reserved keyword found in archive (ULPTEST)
  1641.     3       Error unpacking archive (archive integrity) (ULPTEST)
  1642.     4       Error file checking archive files (virus, etc.) (ULPTEST)
  1643.     5       Error duplicate checking archive files (ULPTEST)
  1644.     6       Error packing archive (ULPTEST)
  1645.     7       Age limit exceeded by archive files (ULPTEST)
  1646.     8       Encrypted file found in archive files (ULPTEST)
  1647.     9       Bad GIF file (ULPTEST)
  1648.     10      Unacceptable GIF resolution (ULPTEST)
  1649.     11      GIF compressed with GIFLITE (ULPTEST)
  1650.     12      Unable to create work space (ULPTEST)
  1651.     99      Help screen (executing a program with no or an insufficient number
  1652.             of arguments) (All)
  1653.     100     Could not close all open files (ULP, ULPTEST, ULPDB)
  1654.     101     Unknown command line parameter (All)
  1655.     102     Config file not found (All)
  1656.     103     Invalid configuration file format; use UPDATE.EXE to update (ULP,
  1657.             ULPTEST, ULPDB)
  1658.     104     Excessive number of command line parameters defined for
  1659.             file checker (maximum number of parameters is 13) (ULP, ULPTEST)
  1660.     105     Excessive number of command line parameters defined for archiver
  1661.             (max is 13) (ULP, ULPTEST, ULPDB)
  1662.     106     Excessive number of words defined in archive information line (max
  1663.             is 13) (ULP, ULPTEST)
  1664.     107     No primary archiver defined (ULP)
  1665.     108     Invalid disk buffer size (All)
  1666.     109     Upload directory list file(s) not found (ULP, ULPTEST)
  1667.     110     Unable to allocate heap memory (All)
  1668.     111     Unable to open or lock disk logging file (ULP, ULPTEST, ULPDB)
  1669.     112     Invalid registration code or attempting to run 286 or 386 versions
  1670.             without registering (ULP, ULPTEST, ULPDB)
  1671.     113     Unable to open/lock duplication database file(s) (ULP, ULPTEST,
  1672.             ULPDB)
  1673.     114     Unable to open BBS ads database file (ULP, ULPADS)
  1674.     115     Invalid filename provided by user on command-line (ULP, ULPTEST)
  1675.     116     Invalid path provided by user on command-line (ULP, ULPDB)
  1676.     117     Invalid or no node number (valid values are 1 to 256) (ULPTEST)
  1677.     118     Internal duplication database usage not enabled (configuration
  1678.             file parameter is set to 'N' or 'Z') (ULPDB)
  1679.     120     Invalid or old database format (All)
  1680.     121     Unable to process com port/invalid port parameter (ULPTEST)
  1681.     122     Unable to access PCBOARD.SYS (ULPTEST)
  1682.     123     Duplication database failed validation test (ULPDB)
  1683.     124     ZDCS/ULP interface program failure (ULPTEST)
  1684.     125     Unable to open privileged user list file (ULPTEST)
  1685.     126     Unable to determine comm port information (ULPTEST)
  1686.     200     Undefined error (internal to ULP system program(s))
  1687.  
  1688.  
  1689. ┌────────────────────────────────┐
  1690. │  Appendix B:  Acknowlegements  │
  1691. └────────────────────────────────┘
  1692.  
  1693. The problem of automatically recognizing duplicate files on large bulletin
  1694. board systems, independent of filename, was originally solved by Dr. Frederick
  1695. W. Kantor (founder of Information Mechanics and author of FWKCS(TM)
  1696. Contents_Signature System), who came up with the elegant solution of using both
  1697. the 32_bit CRC and the uncompressed file length together to make a
  1698. "contents_signature" for each file. Dr. Kantor's experimental data has shown a
  1699. typical pairwise error rate of less than one part in ten trillion using this
  1700. technology.
  1701.  
  1702.  
  1703. ┌─────────────────────────────────────┐
  1704. │  Appendix C:  Command Line Summary  │
  1705. └─────────────────────────────────────┘
  1706.  
  1707. ULP.EXE command-line syntax:
  1708.  
  1709.     ULP -Cd:\path\config.ext [-I] [-O] [-Rd:\path\] [-Md:\path\] [-D]
  1710.  
  1711.     -C  complete path and filename of the configuration file.
  1712.     -I  initialize the process data file. (Optional)
  1713.     -O  processes all archives, regardless of duplication or age limits,
  1714.         including previously processed archives with errors. (Optional)
  1715.     -R  retests all archives found in the directory specified for the
  1716.         purpose of re-checking archives for viruses, etc.. (Optional)
  1717.     -M  performs a mass conversion of all archives found in the directory
  1718.         specified to your default archive format. (Optional)
  1719.     -D  disables date stamp retention in mass convert mode. (Optional)
  1720.  
  1721.  
  1722. ULPTEST.EXE command-line syntax:
  1723.  
  1724.     ULPTEST -Cd:\path\cfg.ext -Fd:\path\archive.ext -Mmode [-Dd:\path\desc.ext]
  1725.         [-Pd:\path\] [-N#] [-L] [-B#] [-I#] [-Annn] [-Hmethod] [-X#] [-Gmode]
  1726.  
  1727.     -C  complete path and filename of the configuration file.
  1728.     -F  complete path and filename of the archive file to be tested.
  1729.     -M  processing mode [Upload/Test/Attach].
  1730.     -D  complete path and filename of the upload description file. (Optional)
  1731.     -P  complete path to the BBS starting directory. (Optional)
  1732.     -N  BBS node number executing ULPTEST. (Optional)
  1733.     -L  force local mode without comm I/O. (Optional)
  1734.     -B  COM port computer to modem (DTE) baud rate. (Optional)
  1735.     -I  COM port interrupt number. (Optional)
  1736.     -A  COM port base address (in hex). (Optional)
  1737.     -H  COM port handshaking method [Hardware/Software/Both]. (Optional)
  1738.     -X  FOSSIL port number. (Optional)
  1739.     -G  ANSI graphics toggle [Yes/No]. (Optional)
  1740.  
  1741.  
  1742. ULPDB.EXE command-line syntax:
  1743.  
  1744.     ULPDB -Cd:\path\config.ext [-Ad:\path\] [-U] [-Md:\path\database.ext]
  1745.         [-Id:\path\foreign.ext] [-S] [-P#] [-Vd:\path\archive.ext]
  1746.  
  1747.     -C  complete path and filename of the configuration file.
  1748.     -A  adds files located in the directory specified to the database
  1749.         file. List files supported by prefixing with a @ or !. (Optional)
  1750.     -U  forces unpacking of all archives when adding files. (Optional)
  1751.     -M  complete path and filename of a second database file to be merged
  1752.         with the master database file. (Optional)
  1753.     -I  complete path and filename of the foreign format database file to
  1754.         be imported into the master database file. (Optional)
  1755.     -S  compiles, sorts and indexes the database. (Optional)
  1756.     -F  forces a number of segements during compilation. (Optional)
  1757.     -P  age in months for purging database entries. (Optional)
  1758.     -V  complete path and filename of the archive to be viewed. (Optional)
  1759.  
  1760.  
  1761. ULPSM.EXE command-line syntax:
  1762.  
  1763.     ULPSM -Cd:\path\config.cfg [-Q]
  1764.  
  1765.     -C  complete path and filename of the configuration file.
  1766.     -Q  quiets beep when an error is detected. (Optional)
  1767.  
  1768.  
  1769. ULPADS.EXE command-line syntax:
  1770.  
  1771.     ULPADS -Dd:\path\database.ext [-Fd:\path\bbs.ad] [-Md:\path\database.ext]
  1772.  
  1773.     -D  complete path and filename of the master BBS ads database file.
  1774.     -F  complete path and filename of the ad file to be added to the BBS
  1775.         ads database. (Optional)
  1776.     -M  complete path and filename of a second BBS ad database to be merged
  1777.         with the master ads database. (Optional)
  1778.