home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / hello.zip / README.TXT < prev   
Text File  |  1996-04-02  |  4KB  |  79 lines
  1. This archive contains the PC DOS 7 and OS/2 Warp versions of a simple 
  2. personal reminder program.  The JCCALJUL, JCDOM, JCDOW, JCEASTER, 
  3. JCJULCAL, JCLEPYER and JCSORT programs are identical for OS/2 Warp and
  4. PC DOS 7.  Only the file extension was changed from .CMD to .BAT.  The
  5. HELLO program itself has one change and that is in the section that
  6. actually outputs the information.  The OS/2 Warp version uses IBM's
  7. freeware VREXX extensions (look for a file called VREXX2.ZIP in all the
  8. popular BBS's and FTP sites) in order to pop up a message box with the
  9. information.  The PC DOS 7 version uses PC DOS' included drawing
  10. functions to draw a blue box in a white field with the reminder
  11. information.
  12.  
  13. HELLO.DAT is the flat file database for this program.  Put it in the root
  14. directory of your C: drive.  If you'd like to place this file someplace 
  15. else, modify the HELLO program accordingly.
  16.  
  17. JCCALJUL.* is an external REXX function that converts Gregorian date 
  18. format (mm/dd/yy or mm/dd/yyyy) to Julian Date format (yyddd or 
  19. yyyyddd). Julian date format is an easier format with which to perform
  20. date calculations.
  21.  
  22. JCDOM.* is an external REXX function that calculates the exact calendar 
  23. date of a relative day within a month (for example, the third Monday in 
  24. October).  Output is in extended Gregorian (mm/dd/yyyy) format.
  25.  
  26. JCDOW.* is an external REXX function that calculate the relative day of 
  27. the week.  Input is a Julian date, output is a number from 1 - 7, with 
  28. 1=Sunday, 7=Saturday.
  29.  
  30. JCEASTER.* is an external REXX function that will calculate the Julian 
  31. date (yyyyddd) for Easter in any given year.  This is called by the 
  32. HELLO.* program for calculating all of the Lenten holidays.  EASTER.* in
  33. turn calls JCCALJUL.*.  If no argument is passed, it'll determine the 
  34. Julian date for Easter for the current year.
  35.  
  36. HELLO.* is the main program.  It will display an appropriate greeting on
  37. the screen, followed by reminders of upcoming red-letter dates.  You can
  38. add or remove red letter dates by editing HELLO.DAT (see above).
  39.  
  40. JCJULCAL.* Is the opposite of JCCALJUL.*  It will convert a Julian Date
  41. (yyddd or yyyyddd) to Gregorian format (mm/dd/yy or mm/dd/yyyy).
  42.  
  43. JCLEPYER.* is an external REXX function that determines whether or not 
  44. a specified year is a Leap year.  If no argument is passed, it'll make 
  45. that determination for the current year.  Upon return to the caller, it 
  46. will pass a value of "1" if it is a leap year, "0" if not.
  47.  
  48. JCSORT.* is an external REXX subroutine that will sort all items in the 
  49. REXX stack.  The first item to be read should contain the number of 
  50. elements in the stack.  Upon return to the caller, all items in the 
  51. stack will be sorted in ascending sequence.
  52.  
  53. To install these programs, copy the appropriate versions to a directory 
  54. in your PATH.  Put HELLO.DAT in the root directory of your C: drive. 
  55. Under PC DOS 7, you may want to place a CALL to HELLO.BAT to give you 
  56. your reminders at every boot.  The same may be accomplished under OS/2 
  57. Warp by placing a program object for HELLO.CMD in your StartUp folder. 
  58. Again, please note that in order to use the OS/2 Warp version, you must 
  59. first install the VREXX extensions (or you can try editing the source 
  60. code to simply do a "Say" instruction for each line, but I like the 
  61. pop-up box better).  
  62.  
  63. OS/2 Warp users can also get a daily reminder (if their machines are 
  64. left on 24 hrs a day, as most OS/2 users are wont to do... why not? 
  65. Unlike Windows/DOS, OS/2 doesn't require rebooting three or four times a
  66. day, and it's typical to leave an OS/2 machine running all day) by using
  67. the "Appointments" object in the IBM Works folder and scheduling a 
  68. program launch every day at a specific time.  See the IBM Works on-line 
  69. documentation and help files for information on how to accomplish this.
  70.  
  71. These programs are released to the public domain.  You are free to 
  72. distribute and modify them in any way you see fit.  I make no claims or 
  73. guarantees of any kind that they will work for you on your machine.  I 
  74. can only guarantee that they work for ME on MY machines.  Your mileage 
  75. may vary.
  76.  
  77. If you like to contact the author (Jaime Cruz) you may do so at 
  78. 72267.1372@compuserve.com, or jcruz@ibm.net.  Enjoy!
  79.