home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / APPT121.ZIP / APPT.DOC < prev    next >
Text File  |  1993-08-01  |  36KB  |  881 lines
  1.  
  2.  
  3.                       
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                -----------------------
  11.                    A P P T
  12.                -----------------------
  13.                  Appointment Minder
  14.                 Version  1.21
  15.  
  16.  
  17.  
  18.                       
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.              APPT Program Documentation
  29.                  08/01/1993
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                    James Corpening
  44.                  GymusWhere?
  45.                   828 NW 79 Terrace
  46.               Plantation, FL  33324-1466
  47.  
  48.  
  49.  
  50.            Copyright 1992, 1993 by James Corpening
  51.                  All rights reserved
  52.  
  53.                        
  54.                       
  55.                       
  56.  
  57.                    C O N T E N T S
  58.  
  59. Registration Form........................................................ 3
  60.  
  61. Preliminary Information.................................................. 4
  62.   Quick Set-up
  63.   The Package
  64.   Registration
  65.  
  66. Legalities............................................................... 6
  67.   Copyright Information
  68.   License Information
  69.   Disclaimer
  70.  
  71. Shareware................................................................ 7
  72.  
  73. Introduction............................................................. 8
  74.  
  75. System Requirements...................................................... 9
  76.  
  77. Understanding and Using APPT............................................. 9
  78.   Viewing Window
  79.   Editing Window
  80.   No-Data Window
  81.  
  82. Additional Information...................................................12
  83.   DataFiles
  84.   Configuration
  85.   Errors
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                     
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.                      
  100.  
  101.  
  102.                       
  103.  
  104.                APPT Appointment Minder
  105.            Copyright 1992, 1993 by James Corpening
  106.                  All rights reserved
  107.                
  108.  
  109.  
  110.                     - 2 -
  111.                      
  112.               R E G I S T R A T I O N   F O R M
  113.                
  114.                -----------------------
  115.                    A P P T
  116.                -----------------------
  117.                  Appointment  Minder
  118.                 Version  1.21
  119.                     
  120.  
  121. Name:                   _______________________________
  122.      
  123. Company:                _______________________________
  124.  
  125. Address:                _______________________________
  126.  
  127.             _______________________________
  128.  
  129. City, State,  Zip:      _______________________________
  130.  
  131. Day Phone:              (_____)________________________
  132.  
  133. CompuServe ID:          _______________________________
  134.  
  135. Today's Date:           ____/____/____
  136.  
  137. Where did you acquire APPT?________________________________________________
  138.  
  139. ____________________________  If BBS, Phone:(_____)__________________
  140.  
  141. Number of copies to register ______ x $10.00 per copy = $____________
  142. For a site license or for quantities over 10, contact me for pricing.
  143.  
  144. Please make payment to James Corpening.
  145. Send a check or money order (US Dollars, US Bank) to:
  146.  
  147.     James Corpening
  148.     GymusWhere?
  149.     828 NW 79 Terrace
  150.     Plantation, FL  33324-1466
  151.  
  152. Shortly after you register, you will receive instructions to eliminate 
  153. the shareware notice on your copy of APPT.
  154.  
  155. Thank you for your honesty.  Please recycle and don't litter.
  156.  
  157. Comments are very welcome: __________________________________________________
  158.  
  159. _____________________________________________________________________________
  160.  
  161. _____________________________________________________________________________
  162.  
  163. _____________________________________________________________________________
  164.                    
  165.                     - 3 -
  166.  
  167.         P R E L I M I N A R Y   I N F O R M A T I O N
  168.                 
  169.               ----------Quick Set-up----------
  170.  
  171. This explains how to get APPT Appointment Minder up and running--quickly.  
  172. If you have read the APPTREAD.ME file, you are already in-gear.  Nevertheless,
  173. you should read the remainder of APPT.DOC to fully understand APPT.  
  174.  
  175. Put APPT.COM in your root directory, type APPT and press [Enter].  Assuming
  176. that you've not created the data file APPT.DAT, you will receive an error:
  177.  
  178. ** ERROR **
  179. Please refer to APPT.DOC for clarification of the following:
  180. Error Opening Data File--Cannot find appointments
  181.  
  182. Press any key to exit...
  183.  
  184. Press any key.  Again, type APPT [Enter] and you will meet APPT Appointment 
  185. Minder.  APPT has created an empty data file entitled APPT.DAT.  You have, 
  186. however, no appointments.  Press [F5] to start the APPTEDIT, the internal 
  187. editor.  Now enter today's date in MM-DD format.  Be sure to place the date 
  188. in the first five positions on the line--THIS IS ESSENTIAL.  Go ahead and 
  189. type a bit more after the date.  If you wish to play, enter some text on the 
  190. lines above today's date; this will show you how APPT works.
  191.  
  192. Now save your data file by pressing [F9].  When the checkmark appears beside
  193. [F9], press [Esc] to exit APPTEDIT, then [F10] to exit APPT.  Now you are 
  194. ready to run APPT again and see APPT work.  Have fun.
  195.  
  196.  
  197.                ----------The Package----------
  198.  
  199. APPT Appointment Minder is an easy-to-use appointment reminder program that
  200. retrieves your appointments from a standard text-file, starting with the 
  201. first occurrence of today's date.  APPT is most useful when run from your 
  202. AUTOEXEC.BAT file at system start-up, thereby offering you an almost hands-off
  203. method of maintaining your daily schedule.  The APPT Appointment Minder 
  204. package includes the following files:
  205.  
  206. Filename:        Size:     Date:        Description:
  207.  
  208. APPTREAD.ME      1,380     08/01/93     Quick set-up guide
  209. APPT.COM         6,682     08/01/93     APPT Appointment Minder v1.21
  210. APPT.DOC        36,494     08/01/93     APPT operation manual
  211. APPT.SMP           441     08/01/93     Sample data file
  212. APPT.REG         1,530     08/01/93     APPT Registration Form
  213. APPT-REG.BAT        34     08/01/93     Batch file to print APPT.REG    
  214. APPT-DOC.BAT        34     08/01/93     Batch file to print APPT.DOC
  215. APPTHIST.TXT       863     08/01/93     Upgrade history
  216. CURSOR.COM          11     08/01/93     Replaces cursor after APPT abort
  217. FILE_ID.DIZ        249     08/01/93     Description file
  218. DESC.SDI           249     08/01/93     Description file
  219.                     
  220.                     - 4 -
  221.  
  222. If your package lacks any of these files, you should try to obtain the 
  223. complete package.  If that is not possible, I hope that you have at least
  224. the following:  APPT.COM, APPT.DOC, and APPT.SMP.  Those three files will
  225. suffice in allowing you to productively use APPT.
  226.  
  227.  
  228.                ----------Registration----------
  229.  
  230. Registration of APPT is very easy and inexpensive.  As you receive it, APPT
  231. is completely functional.  The only difference between unregistered and 
  232. registered versions of APPT is the inclusion of shareware information in the 
  233. unregistered version.  After registration, you will receive instructions to 
  234. disable the shareware labeling.
  235.  
  236. Registration is only $10.  
  237.  
  238. Please complete the registration form on Page 3 of this manual (or print 
  239. the registration form as you exit APPT) and send a money order or check 
  240. (US funds, US bank), payable to James Corpening, to:
  241.  
  242.     James Corpening
  243.     GymusWhere?
  244.     828 NW 79 Terrace
  245.     Plantation, FL  33324-1466
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                     
  258.                     
  259.                     
  260.                     
  261.                     
  262.                     
  263.                     
  264.                     
  265.                     
  266.                     
  267.                     
  268.                     
  269.                     
  270.                     
  271.                     
  272.                     
  273.                     
  274.                     
  275.                     - 5 -
  276.  
  277.                  L E G A L I T I E S
  278.  
  279.           ----------Copyright Information----------
  280.  
  281. United States Copyright Law is intended to protect authors from unauthorized 
  282. use of their work.  APPT Appointment Minder is copyrighted by James Corpening 
  283. and GymusWhere?  That means that APPT.COM and APPT.DOC belong to James 
  284. Corpening, and are protected under United States Copyright Law and the 
  285. agreements of the Berne Convention.  You may legally make NO modifications 
  286. to APPT.COM nor to APPT.DOC.  Furthermore, you may use APPT Appointment 
  287. Minder only under the conditions of the following license.
  288.                    
  289.            ----------License Information----------
  290.  
  291. As an end-user, you are granted a license to evaluate APPT Appointment Minder 
  292. for 28 days.  After 28 days, if you decide to continue using APPT, you must 
  293. register your copy.  If, however, you decide that APPT can not serve you well, 
  294. you must discontinue use.  Once registered, you gain the privilege of using 
  295. APPT through version 2.99.  The per-copy registration fee registers only one 
  296. copy of APPT, meaning that you may place and use said copy of APPT on any 
  297. computer as long as it does not simultaneously reside on another computer.  
  298. You must register one copy of APPT for each computer on which APPT will reside.
  299. Registered or unregistered, you may distribute ONLY the complete, unmodified 
  300. shareware package.  This license also allows you to duplicate the APPT package,
  301. as described above, for archival or distribution purposes only.  If you can 
  302. not agree to the conditions set forth in this license, please do not use APPT.  
  303.  
  304. Unregistered use of APPT beyond 28 days violates this license and United 
  305. States Copyright Law [17 USCA Section 102 et seq.], and subjects you 
  306. (individual or company) to severe criminal liability.  
  307.  
  308. Registration fees and distribution fees are distinctly different.  The APPT
  309. package may be sold only by GymusWhere? and James Corpening.  If you paid
  310. someone other than James Corpening or GymusWhere? for APPT Appointment
  311. Minder, you paid for the distribution only--not registration.  Sale of this
  312. software by any other individual or company is illegal.  This software may,
  313. however, be distributed by parties other than GymusWhere? or James Corpening, 
  314. in which case only the complete, unadulterated shareware package may be 
  315. distributed.  If distribution fees are charged for this package, the 
  316. distributor must first procure written consent from James Corpening; 
  317. thereafter, said fees may not exceed five dollars ($5.00), and are limited 
  318. to charges for distribution and/or diskette only.  
  319.  
  320. APPT is a very helpful tool that may be best used in a business environment.
  321. If you wish to discuss registering many copies of APPT, or gaining a site 
  322. license, please feel free to contact me at any one of the addresses below.
  323.                    
  324.                ----------Disclaimer----------
  325.  
  326. APPT Appointment Minder and related files/programs are accompanied by no
  327. warranty, explicit or implicit.  Neither GymusWhere? nor James Corpening
  328.                     
  329.  
  330.                     - 6 -
  331.  
  332. may be held responsible for missed appointments, lost data, lost profits,
  333. or any damages resulting from the use of APPT Appointment Minder and
  334. related files/programs.  Careful effort has been made to produce a quality
  335. product.  Nevertheless, hardware, software, and user variability cannot be
  336. totally accounted for.  Every user should, therefore, thoroughly test this
  337. package with non-important data.  SELLER LIABILITY IS LIMITED TO REFUND OR
  338. PRODUCT-REPLACEMENT.
  339.                   
  340.                   S H A R E W A R E
  341.  
  342. The shareware approach to software marketing is a great concept that, if
  343. adhered to, benefits both endusers and programmers.  Shareware products are
  344. programs of quality, no less than retail-marketed products.  In fact, many 
  345. retail-marketed software products were born as shareware.  The success of 
  346. shareware is dependent on the good nature of its users.  
  347.  
  348. The strategy is simple.  Shareware packages are distributed to the public via 
  349. distribution houses (which charge for the distribution only), by user groups, 
  350. or by electronic routes (e.g., BBSs).  As a user, you are encouraged to use 
  351. these programs on an evaluation basis.  After a period of a few weeks, you can
  352. have a good idea of the usefulness of a package.  If you are satisfied with
  353. the package, and wish to continue using it, you are expected to purchase your 
  354. copy.  If you find that the software does not meet your needs, you are not
  355. expected to purchase it, but you are expected to cease using it.
  356.  
  357. This approach to software evaluation is often referred to as "test-drive,"
  358. and appropriately so.  Evaluating software prior to purchase is tantamount
  359. to test-driving an automobile prior to purchase.  If you like it, you buy it.  
  360. If you decide that the automobile does not fit your needs, you return it.
  361.  
  362. Another fantastic benefit to shareware packages is the price.  Distributing
  363. shareware is less expensive than mass-producing and marketing a product in
  364. the conventional manner.  The overhead is low, and the principle investment
  365. is time (not pretty packaging, advertising, nor paid vacations for the guys
  366. upstairs).  This allows shareware authors to often offer their product at
  367. very attractive prices.  But even if price were not an issue, it is very
  368. convenient to be able to test software prior to purchase.
  369.  
  370. Regardless of the stage of your evaluation, you are encouraged to
  371. distribute the shareware package as you received it.  This gives you an
  372. opportunity to offer your opinions of the software and, if fitting, fulfill
  373. any upload obligations you may have with your BBS.
  374.  
  375. Quite frequently, lack of shareware registration is simply a matter of
  376. procrastination.  A user puts the program(s) on her/his machine and finds
  377. it very useful.  Because the program is installed, however, there is a
  378. tendency to overlook registration.  To prevent this neglect, some shareware
  379. authors release versions that are crippled (not fully functional).  APPT
  380. Appointment Minder is fully functional in its shareware package.  I've
  381. decided to trust you as a user, and I hope that you appreciate such trust.
  382.                     
  383.                     
  384.                     
  385.                     - 7 -
  386.  
  387.                I N T R O D U C T I O N 
  388.  
  389. GREAT!  Another appointment reminder program.  
  390.  
  391. OK, I admit, these things typically are more of a burden than they are
  392. worth.  By the time I turn on my system and run the program, I have had
  393. plenty of time to plan my day from the Post-It Notes that litter my desk. 
  394. What I really need is a (relatively) hands-off approach to planning my day.
  395. Well, here it is.  APPT offers several benefits that make it a better 
  396. appointment minder.  
  397.  
  398. -APPT is intended to be run automatically from your AUTOEXEC.BAT file (you
  399. may, of course, run APPT manually from command line).  Unlike appointment
  400. reminders that need you to tell them what to do, APPT knows what to do.  When
  401. you call APPT, you are shown today's appointments--effortlessly.  There is no
  402. need to navigate through an outdated appointment list.  The only preparation
  403. on your part, then, is to add appointments to your data file (sorry, but
  404. APPT can not log your appointments, but it can help--see below).
  405.  
  406. -APPT doesn't bother you with yesterday's appointments; APPT searches your
  407. data file and retrieves only today's and future appointments.  APPT then
  408. automatically updates your data file by removing past appointments.  These
  409. appointments are moved to a back-up file where they may be accessed with
  410. any text-editor, or read with DOS' TYPE command.  
  411.  
  412. -Because APPT retrieves appointments from a separate data file, the data
  413. file may be updated on any remote terminal, and subsequently transferred to
  414. all linked terminals, including APPT's.  This is ideal in situations in
  415. which somebody else logs your appointments, but you wish to view them with
  416. APPT on your own terminal.
  417.  
  418. -APPT displays one window of appointments, and only one key-press advances
  419. your viewing window.  Another key-press backs-up your viewing window to the
  420. previous data.  This convenience allows you to move easily through your
  421. appointments.
  422.  
  423. -With APPT, one key-press prints appointments from the current window.  A
  424. special Formfeed option signals your printer to feed the remainder of your
  425. print job when appointments do not fill the entire page.  
  426.  
  427. -APPT's help screen is one key-press away from you at any time.  Although
  428. APPT is easy enough that the help screen will be seldom used, it is there
  429. if you need it.
  430.  
  431. -APPT has an internal editor, APPTEDIT, that allows you to easily edit your
  432. appointment file.  Once saved, edits are immediately available in APPT's
  433. viewing window.
  434.  
  435. -APPT is written entirely in assembly language--the next best thing to
  436. "machine talk."  This allows APPT to use little memory, and to be very
  437. small and very fast.
  438.  
  439.  
  440.                     - 8 -
  441.  
  442. -APPT is a very convenient and useful utility.  APPT is also inexpensive, a
  443. bargain.  Although registering your copy of APPT will entitle you to other
  444. benefits, it is quite satisfying to know that you play a major role in
  445. strengthening shareware as a marketing tool.  Besides, paying for
  446. merchandise is truly conventional.
  447.  
  448.             
  449.             
  450.             S Y S T E M   R E Q U I R E M E N T S
  451.  
  452. APPT: 
  453. -Requires DOS version 2.0 or higher.
  454. -Requires at least an 8086-based IBM-compatible computer.
  455. -Requires approximately 6K of conventional RAM for the program proper. 
  456.  APPT establishes buffers to store appointment data and editing data, so 
  457.  the total conventional memory requirement approximates 38K.
  458. -Requires a Color Graphics Adapter (CGA) or better.  APPT will not work
  459.  with a Monochrome Display Adapter (MDA).
  460. -Requires a text-mode display of 80 columns by 25 rows, in either color or
  461.  b/w, to conform to program expectations.  The present version of APPT does
  462.  not check the number of rows/columns of your monitor.  Other video modes
  463.  may work, but the displays will be undefined.  Preferred video modes are 
  464.  #2 (b/w) and #3 (color).
  465.                     
  466.  
  467.       U N D E R S T A N D I N G   &   U S I N G   A P P T
  468.  
  469. Although I find tutorials notoriously tedious, the following is a short
  470. run-through of APPT's operation, mixed with explanation.  APPT is very easy
  471. to use; you can get very comfortable with APPT by just fumbling through it.  
  472. Nevertheless, I am obligated to provide detailed explanation.  I suggest that 
  473. you at least skim this to get the basics, lest you have questions later.
  474.  
  475. Throughout the text you will find references to several files.  APPT refers
  476. to the main program APPT.COM, APPT.DAT is the data file to contain your
  477. appointments, and APPT.BAK is the backup data file format.  APPTEDIT refers
  478. to APPT's internal editor, but it is not a separate file.
  479.  
  480. APPT Appointment Minder does just that--minds your appointments.  APPT is
  481. executed when you issue the command APPT.  APPT displays a logo at the top
  482. of your screen, a menu bar at the bottom of your screen (assuming that your
  483. screen is 25 rows by 80 columns; I'm not convinced that enough people use
  484. 80x50 to make it worthwhile to adjust for such--maybe I'll learn different.), 
  485. and appointments between the logo and menu bar.  The logo includes APPT's 
  486. name and version number, and today's date, as reported by your system, in 
  487. MM-DD format.  The menu bar displays the options available to you, and those
  488. options will change according to where you are in APPT.  
  489.  
  490. Upon start-up, APPT searches for appointments in the data file APPT.DAT;
  491. APPT.DAT should exist before running APPT.  You may use any text-editor or
  492. word-processor to create APPT.DAT; you must, however, place dates on the
  493.  
  494.               
  495.                     - 9 -
  496.  
  497. first five positions on a line, in MM-DD format.  You must also save the
  498. data file in TEXT ONLY format, void of application-specific formatting
  499. (special characters, bold, italics, etc.).  If APPT does not find the
  500. proper data file, APPT will notify you that it can not open the data file,
  501. but it will create an empty APPT.DAT for you to edit.  It is then up to you
  502. to add your appointments to the data file.  
  503.  
  504. If you run APPT without first creating APPT.DAT, and APPT creates the empty
  505. data file, you may then run APPT again to modify the data file with
  506. APPTEDIT.  When you run APPT for this second time, you will receive a No
  507. Appointments Today notice because the data file is empty.  You will also
  508. see that the menu bar displays three (3) command options: 
  509.  
  510.     [F1]  Help              [F5]  Edit              [F10]  Quit.  
  511.  
  512. [F1] and [F10] really need no explanation.  Choosing [F5], however, will
  513. open APPTEDIT.  A note is in order here.  Only in APPTEDIT will a cursor
  514. represent an insertion point.  You should see no cursor if you are not in
  515. APPTEDIT.  If you do see a cursor, that is just a quirk--it will not
  516. represent an insertion point.
  517.  
  518. Once you open APPTEDIT, the menu bar will quickly change to display the
  519. editing options (also, it should turn red) and the cursor will appear.  
  520. APPTEDIT opens in Insert Mode with an underscore cursor.  By pressing the 
  521. Insert key, you switch APPTEDIT to TypeOver Mode, in which APPTEDIT uses a
  522. block cursor.  Because not all editors follow one convention for cursor  
  523. format, the word "TypeOver" will appear in the upper right corner of the 
  524. Logo bar to make it obvious that APPT is in TypeOver mode.  This courtesy, 
  525. however, is available only in registered versions of APPT.  
  526.  
  527. In the upper left corner of the Logo bar, the word Editing will blink.  
  528. You may now enter appointments using generic text-editing commands (text 
  529. keys, [Ins], [Tab], etc.).  When you wish to save your edits, press [F9] and
  530. APPTEDIT will save APPT.DAT to disk.  At this point a checkmark should
  531. appear in the menu bar to the left of [F9].  This signals that the save is
  532. completed (the checkmark will vanish at the next key pressed).
  533.  
  534. When you start APPTEDIT, keep in mind that this editor is designed to work 
  535. only from within APPT, and only on APPT.DAT; it is not a full word-processor
  536. and is included as a convenience for you, the user.  In other words, don't 
  537. expect it to work miracles.  
  538.  
  539. Now exit APPTEDIT by pressing [Esc]; you are now in the viewing window. 
  540. Remember that if you [Esc] from APPTEDIT without pressing [F9], your edits
  541. will not be saved; APPTEDIT does not warn you of unsaved data.  The menu bar
  542. will once again change to display the options available to you.  You can see
  543. that your edits are immediately available.  You will probably use APPT mostly
  544. from this viewing window.  
  545.  
  546. Although the Help Screen is available from any window by toggling [F1], the
  547. explanations are very succinct.  Below are more thorough explanations of
  548. APPT's commands.  
  549.  
  550.                    - 10 -
  551.  
  552.            ----------Viewing-Window Keys----------
  553.  
  554. [PgUp]        Displays the previous window in your data file, assuming that    
  555. you advanced with the [PgDn] Command.
  556.  
  557. [PgDn]        Displays the next window in your data file if the data exceed
  558. 14 lines (14 lines is the size of the data window).  APPT makes room for
  559. 10 totally full (14 rows x 80 columns) windows of data, but allows that 
  560. amount of data to be displayed across (15) windows.
  561.  
  562. [F1] Help     Displays the Quick-Help Screen that briefly explains the
  563. commands available in the menu bar.  Press [F1] again to exit Help.  
  564.  
  565. [F3] Print    Sends the data in the display window to your printer.  The
  566. window data, however, will not fill an entire sheet, and your printer will
  567. not feed the complete sheet until the sheet is full.  This allows you to
  568. advance the data window with [PgDn] and include more than one window on
  569. each sheet.
  570.  
  571. [F5] Edit     Initiates APPT's internal text editor, in which you can edit
  572. APPT.DAT.  This editor is not a full word-processor, so you are limited in
  573. what you can accomplish with it--it is included as a convenience for
  574. creating/modifying your appointment file.  The text editor is explained
  575. more fully elsewhere in this manual.
  576.  
  577. [F7] Formfeed Advances the paper in your printer by one sheet.  When you
  578. have finished sending appointments to your printer, the sheet will most
  579. likely have yet to feed (a laser printer holds the sheet until it is
  580. completely full, a dot-matrix printer will feed only as much as has
  581. printed).  You should then complete the print job by pressing the formfeed
  582. key, thereby advancing the paper.  Because the window displays 14 lines of
  583. data, and because APPT uses two lines per sheet for a header, you probably
  584. can send 4 windows of appointments onto one sheet of paper (14 x 4 + 2 = 58
  585. lines) before having to advance the sheet.  
  586.  
  587. [F10] Quit    Exits APPT and returns you to DOS.
  588.  
  589. [Alt][R]      Refreshes the screen if corrupted.  In the event that DOS
  590. invades the screen (e.g., the infamous Abort, Retry, Ignore, Fail?), you
  591. may clean the display by holding the [Alt] key depressed and then pressing
  592. the [R] key (case is inconsequential).  For example, APPT will not trap
  593. printer-related errors; that task is left to DOS.  If you press [F3] or
  594. [F7] when your printer is not on-line or not powered on, DOS' print-error
  595. message will invade the APPT display (probably in the lower left corner). 
  596. You may then correct the printer situation, press r (retry), and then
  597. [Alt][R] to refresh the screen.  This service is purely for appearance; if
  598. DOS does send a message to the screen, APPT should continue to function 
  599. correctly.
  600.  
  601.  
  602.                    
  603.                    
  604.                    
  605.                    - 11 -
  606.  
  607.            ----------Editing-Window Keys----------
  608.  
  609. [PgUp/Dn]     Move the editing cursor up/down one window.
  610.  
  611. [F1]          Displays the Help Screen.
  612.  
  613. [F9]          Saves your edits to disk.  A checkmark will appear to the
  614. left of the [F9] to signal the completed save.  This checkmark will vanish
  615. at the next key-press.
  616.  
  617. [Home],[End]  Move the cursor to the start or end, respectively, of the
  618. present line.
  619.  
  620. [Esc]         Exits APPTEDIT and returns you to the viewing window.  You
  621. must be sure to save your most recent edits--APPT will not warn you of
  622. unsaved changes to your data file.
  623.  
  624. Edit Keys     Standard editing keys include text characters, tab, backspace, 
  625. enter, delete, insert, cursor arrows.
  626.  
  627.  
  628.            ----------No-Data-Window Keys----------
  629.  
  630. These keys, [F1], [F5], [F10], are described above.
  631.  
  632.  
  633.  
  634.           A D D I T I O N A L   I N F O R M A T I O N
  635.  
  636. Some of the following information is redundant, but helps elucidate
  637. additional characteristics of APPT.
  638.  
  639. As mentioned above, when APPT is working, you may see no cursor.  The
  640. cursor will re-appear, however, when you exit APPT.  APPT will not trap
  641. printer-related errors; that task is left to DOS.  If DOS does trap such an
  642. error, and if you choose to abort rather than retry the print, APPT will
  643. not be able to return the cursor to screen.  Rather than expect you to then
  644. recall APPT or re-boot your computer to retrieve your cursor, I have
  645. included a small file entitled CURSOR.COM to easily bring back your cursor.
  646.  
  647. When the help screen is displayed, pressing any key other than [Esc] has no
  648. effect.  Generally, the same applies to the appointment screen.  There is,
  649. however, an exception.  Pressing an unassigned function key (F1-12) or
  650. auxilliary keys (e.g., arrows) will return a beep.  This may be quite 
  651. annoying, but given the nature of the print option (specifically when used 
  652. with laser printers), it may not be readily obvious that your data made it to 
  653. the printer.  The alerting beep informs you when you press an unassigned key.
  654.  
  655. If you do not set APPT's environment variable (see the CONFIGURATION section 
  656. of this manual), APPT.DAT must reside in the same subdirectory as APPT.COM.  
  657. In such a case, if APPT creates the data file, you will find APPT.DAT within
  658.  
  659.                       
  660.                    - 12 -
  661.  
  662. the same subdirectory.  If you DO set the APPT variable and APPT creates
  663. APPT.DAT, you will find APPT.DAT in the defined subdirectory.
  664.  
  665.                ----------Data Files----------
  666.  
  667. Although strict, there is some variability in the date format that APPT will
  668. correctly recognize.  For example, each of the following formats will work:
  669.  
  670.          MM-DD(-YYYY)           MM.DD(.YYYY)
  671.          MM/DD(/YYYY)           MM DD( YYYY)
  672.  
  673. Essentially, you may separate MM and DD with any character.  MM, however,
  674. must occupy the first and second positions on the line, and DD must occupy
  675. the fourth and fifth positions.  MM must be FAR LEFT--no space between the
  676. left margin and the date!  THIS IS VERY IMPORTANT.  Anything after DD is
  677. entirely optional; APPT evaluates only the first five characters on each
  678. line.  The file APPT.SMP is included with this package as a sample data
  679. file for your reference.  
  680.  
  681. This strategy to text-searching may appear awkward.  I considered just
  682. performing a string search that would allow the date to be anywhere on a
  683. line.  This, however, would mean that _any_ dates logged in the text would
  684. be fair game to APPT.  For example, consider the following entry:
  685.  
  686.     11/23   Phone Baker regarding 11/26 lunch.
  687.  
  688. That would work well on 11/23, but assuming that APPT was not used between 
  689. the 23rd and the 26th, the first line to be displayed on 11/26 would be:
  690.  
  691.     11/26 lunch.
  692.  
  693. In this case, you may be happy with the brief reminder (if you could remember
  694. Baker).  I felt, however, that the potential for confusion was too great, so 
  695. I opted for the present strategy.  
  696.  
  697. If APPT finds today's date in your data file, it will display appointments
  698. starting with the first instance of today's date, including all
  699. appointments that follow.  APPT will NOT display past appointments (unless
  700. they are listed after today's date).  Also, it will NOT display ANY
  701. appointments if it does not find today's date in APPT.DAT (i.e., APPT.DAT
  702. may contain 100 appointments for tomorrow, but if it contains none for
  703. today you will receive a notice of no appointments).  So, if you wish to be
  704. shown tomorrow's appointments today, include a line with today's date.
  705.  
  706. APPT is a convenient utility, but is simple-minded.  APPT searches your data
  707. file for today's date, discarding old data.  Once APPT finds today's date,
  708. it does no more searching.  Depending on how many appointments I have on a
  709. given day, I find that constructing my data file so that only one day's
  710. appointments occupy each window allows a less cluttered display and allows
  711. me to print only one date's appointments.  Remember, however, that APPT
  712. only grants you access to 15 windows of data.  Constructing a data file that 
  713.  
  714.                    
  715.                    - 13 -
  716.      
  717. is smaller than 11,200 bytes, but that extends beyond 15 windows will mean 
  718. that you have access to only the first 15 windows.  I strongly suggest that 
  719. you avoid files larger than 11,200 bytes.  
  720.  
  721. Every time that APPT finds today's date in APPT.DAT, the data file will be
  722. renamed APPT.BAK.  A new APPT.DAT will then be created containing today's
  723. and future appointments.  This avoids showing you old appointments, yet
  724. allows you opportunity to recall old appointments by viewing APPT.BAK with
  725. another text-editor or with DOS' TYPE command, but ONLY until you reexecute
  726. APPT.  If there are no appointments for the day, the files will not be
  727. changed.  Also, using APPTEDIT to save data will only update APPT.DAT,
  728. APPT.BAK will be unchanged.
  729.  
  730.              ----------Configuration----------
  731.  
  732. If you wish to run APPT at system start-up, you may include the command
  733. APPT.COM in your AUTOEXEC.BAT file (before interfacing utilities such as
  734. Microsoft Windows or menu programs).  To keep APPT easy, you should follow
  735. one of three options: 
  736. 1.  Place the APPT files in your root directory.
  737. 2.  Place the APPT files in a subdirectory and call APPT either from a batch 
  738.     file, the path and name of which you should add to your AUTOEXEC.BAT 
  739.     file, or by using the change directory (cd\...) command in your 
  740.     AUTOEXEC.BAT file.  In the case of a batch file other than AUTOEXEC,
  741.     please use the entire APPT.COM when calling APPT, or name your batch
  742.     file something other than APPT.BAT.  Consult your DOS manual for 
  743.     instructions on creating batch files.  
  744. 3.  Set the APPT environment variable and a path to APPT.DAT's subdirectory 
  745.     in your AUTOEXEC.BAT file.  The environment variable allows APPT to 
  746.     find the data files and the path allows DOS to find APPT.  For example,
  747.     the lines (without comments) in your AUTOEXEC.BAT file should be
  748.     
  749.             SET APPT=C:\subdir1     (to set the variable)
  750.             PATH C:\subdir2;        (to set the path)
  751.     
  752.     with NO BACKSLASH (\) at the end.  The "subdir#" represents the      
  753.     path(s) of your choice(s) (e.g., C:\UTILITY\APPT).  APPT's environment
  754.     path is limited to 63 characters including backslashes.  Character 
  755.     case is irrelevant.  Note that you may house APPT in a different 
  756.     subdirectory than the data files.
  757.  
  758. If your system does not keep time while power is off (i.e., you enter
  759. date/time at every start-up), the APPT command must be listed in your
  760. AUTOEXEC.BAT file after the TIME and DATE commands so that APPT will read
  761. the correct date from the system.  Even if you do not run APPT at start-up,
  762. you are obligated to at least enter the correct date if you wish to use APPT.
  763.  
  764. APPT.DAT may be assigned the System, Hidden, &/or Archive attributes, but
  765. not the Read-only attribute.  If you alter APPT.DAT's attributes, however,
  766. the new attributes will be valid only until you execute APPT.  When APPT
  767. modifies the data file (see above), it assigns read/write attributes.  
  768.     
  769.  
  770.                    - 14 -
  771.  
  772.              ----------Errors----------
  773.  
  774. There are seven (7) possible program-trapped errors that you could encounter
  775. while running APPT.  The generic error message reads:
  776.  
  777. ** ERROR **
  778. Please refer to APPT.DOC for clarification of the following:
  779.  
  780. and is followed by one of the errors below.
  781.  
  782. Incorrect DOS Version--APPT requires DOS 2.0 or higher.  
  783.      Some of APPT's interactions with DOS were not possible with earlier 
  784.      versions of DOS.
  785.                    
  786. Error Opening Data File--Cannot find appointments.  
  787.      This occurs if APPT does not find the data file APPT.DAT for any of 
  788.      the following reasons:  
  789.       
  790.      -APPT.DAT does not exist on your disk.  
  791.      
  792.      -APPT.DAT exists, but APPT's environment variable is not present and 
  793.         APPT.DAT resides in a directory other than the one in which 
  794.         APPT.COM resides.  
  795.  
  796.      -The data file is named something other than APPT.DAT.
  797.  
  798.      Whichever the case, APPT will create the empty data file APPT.DAT, 
  799.      to which you should then add your appointments.  This error will also 
  800.      occur if the data file has been assigned a READ-ONLY attribute.  In 
  801.      this case, you must remove the READ-ONLY attribute with DOS' ATTRIB 
  802.      command (ATTRIB -R APPT.DAT).  If APPT returns an error under this 
  803.      condition, it will not create an empty data file as explained above.
  804.  
  805. Error Reading Data File--Check data file integrity.
  806.      This error should occur rarely, if ever; probably only if either file 
  807.      is damaged.  In such a case, your first approach should be to 
  808.      reconstruct your data file (first, try renaming APPT.BAK).  
  809.      
  810. Incompatible Video Adapter--APPT requires CGA or better.  
  811.      APPT will not run with a Monochrome Display Adapter (MDA).  Acceptable
  812.      adapters include CGA, EGA, MCGA, and VGA.
  813.  
  814. Error Writing Data File--File may not be saved.
  815.      This is an error that I've not seen occur, but decided to trap just the
  816.      same.  Again, this should only occur if either file is damaged.
  817.  
  818. Error finding APPT.COM--Move to APPT's subdirectory.
  819.      You will receive this error if you attempt to register APPT from outside
  820.      the directory in which APPT resides.  Registration must be done from
  821.      within that subdirectory, regardless of an environment variable.
  822.  
  823.  
  824.                 
  825.                 - 15 -
  826.  
  827. Registration Failed--Please confirm Registration Code, attending to case.
  828.      This is the error message for unsuccessful registration attempts from
  829.      within APPT's subdirectory.  If you are confident that APPT is returning
  830.      this message in error (i.e., you have accurately followed registration 
  831.      directions), PLEASE contact me.
  832.  
  833. APPT has never met DesqView.  If you wish to let them play together, I'd 
  834. appreciate feedback.  Otherwise, it may be best to keep them apart.
  835.  
  836. I am interested in improving APPT Appointment Minder.  The best way to do so
  837. is via user input.  I encourage you to offer feedback on APPT and this 
  838. document regardless of the stage of your evaluation or registered use.  I 
  839. very much look forward to such input.  
  840.  
  841. I hope that APPT serves you well.  I am sorry, but phone support is presently
  842. unavailable for APPT.  You may contact me at any of the addresses below.  I
  843. expect to have a new USPS address by the end of 1993, so you may contact me
  844. via CompuServe for an update.  I will, however, continue to receive mail for
  845. some time at the address below.
  846.  
  847. CompuServe:     71172,266
  848.  
  849. InterNet:       71172.266@compuserve.com
  850.  
  851. USPS:           James Corpening
  852.         GymusWhere?
  853.         828 NW 79 Terrace
  854.         Plantation, FL  33324-1466
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.           
  867.  
  868.  
  869.  
  870.  
  871.  
  872.                  
  873.                        
  874. IBM is a trademark of International Business Machines 
  875. DesqView is a trademark of Quarterdeck Office Systems
  876. Microsoft Windows is a trademark of Microsoft Corporation
  877.                    
  878.  
  879.                    
  880.                    - 16 -
  881.