home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / ba5_pm11.zip / INSTALL.TXT < prev    next >
Text File  |  1996-10-02  |  8KB  |  148 lines
  1. =====================================================================
  2.                         INSTALLING THIS PROGRAM
  3. =====================================================================
  4. NOTE: This version of the OS/2 Presentation Manager Automated Episode 
  5. Guide uses "external" disk-based data files for each of the episodes 
  6. it displays on your screen. 
  7.  
  8. Therefore, it MUST be installed correctly in order for the executable 
  9. program to find the episode data. An incorrectly installed program will 
  10. result in error messages when you try to view any of the episode data in 
  11. the program. 
  12.  
  13. Follow these simple (but mandatory) steps...
  14.                         
  15. (1) Unarchive the original .ZIP file into the directory that you want
  16.     to *PERMANENTLY* store the Automated EpGuide. Presumably, you have 
  17.     already done this since you are reading the help file or readme. 
  18.     
  19.     NOTE: YOU SHOULD USE THE OS/2 UNZIP.EXE TO UNARCHIVE THE .ZIP FILE! 
  20.     UNZIP IS "EA" (Extended Attributes) AWARE! 
  21.     
  22.     UNZIP.EXE ALSO DEFAULTS TO RECREATING THE DIRECTORIES STORED IN THE 
  23.     .ZIP FILE! KEEPING THE DIRECTORIES STORED IN THE .ZIP IS CRUCIAL! IF 
  24.     THE AUTOMATED EPGUIDE CAN'T FIND THE EPISODE DATA SUB-DIRECTORY, IT 
  25.     ***WILL*** ***NOT*** ***WORK*** ***CORRECTLY***! 
  26.     
  27.     No if's, and's or but's. So, if you don't have the OS/2 UNZIP.EXE,
  28.     go to any decent OS/2 BBS or FTP site and download it immediately!
  29.     You'll be glad you did! (DOS's PKZIP "may" be able to handle the
  30.     sub-directories, but it will nuke any EA's stored in the archive!)
  31.  
  32. (2) If you used UNZIP.EXE, a sub-directory will be created and all of
  33.     the episode data files will be copied to this new sub-directory.    
  34.     
  35.     Like I mentioned above, this part of the installation is CRUCIAL!
  36.     I hard-coded the sub-directory's path into the program executable.
  37.  
  38.     If the Automated EpGuide program can't find this sub-directory, you
  39.     will get a File Error dialog which tells you which data file the
  40.     program was trying to load. See elsewhere in this document for
  41.     details on File Errors. If you *ARE* getting these errors, go back 
  42.     to the top of this section and follow the instructions.    
  43.  
  44. (3) Once you have UNZIP'ed the Automated EpGuide .ZIP file into a
  45.     permanent directory, run the REXX .CMD script named AEG_INST.CMD.
  46.     This script will create an OS/2 program object on your desktop.
  47.  
  48.     After the program object is created, you can rename it or move it
  49.     anywhere you want to (into a folder, onto the LaunchPad, etc.) 
  50.     
  51. (4) Double click on the Automated EpGuide icon to run the program. 
  52.     For more details on using the Automated EpGuide, check out the
  53.     Online Help (hit F1 while the A.E.G. is running), the Offline
  54.     Help (use OS/2's VIEW with the .INF file) or read the README.TXT
  55.     file which is a plain ASCII text file version of the .HLP and .INF
  56.     help files...
  57.  
  58. =====================================================================
  59.                            FILE READ ERRORS    
  60. =====================================================================
  61. If you did everything in the INSTALLING THIS PROGRAM section correctly,
  62. you shouldn't get any File Read errors. 
  63.  
  64. But, there are some circumstances that may cause the Automated EpGuide
  65. to give you a File Read error dialog...
  66.  
  67. For example, if you ever develop an error on your hard drive that 
  68. interferes with the A.E.G.'s data files, you may get a "FILE READ" error.
  69.  
  70. Other ways of getting these "FILE READ" errors are caused by HUMAN error:
  71.  
  72. (1) You accidentally DELETED one or more of the EP###.DAT files; 
  73. (2) You accidentally DELETED the OS/2 PM Automated EpGuide's episode 
  74.     data file directory; 
  75. (3) You accidentally RENAMED the OS/2 PM Automated EpGuide's episode data 
  76.     file directory or one or more of the EP###.DAT files therein; 
  77. (4) You MOVED the OS/2 PM Automated EpGuide .EXE program to a directory 
  78.     other than the one that you originally installed the program.
  79.  
  80. If you are getting "FILE READ" error messages when trying to view the 
  81. episode data, you may have to re-install the OS/2 PM Automated EpGuide. 
  82. Re-read the section entitled INSTALLING THIS PROGRAM for more details...
  83.  
  84. =====================================================================
  85.                            Error Messages
  86. =====================================================================
  87. If there is some sort of trouble with the disk-based episode data files, 
  88. you will get a "FILE READ" error message. The dialog box will tell you
  89. the name of the sub-directory and file that the A.E.G. program is trying
  90. to load.
  91.  
  92. After you hit the OK button, you will get the default "empty" episode 
  93. data dialog. Since the program couldn't find the disk based data files 
  94. (filenames: EP###.DAT where ### is the episode's number), it uses the 
  95. default error message in the episode data dialog. 
  96.  
  97. If you are getting the above errors after running the Automated EpGuide, 
  98. it is because the program cannot find the episode data files. 
  99.  
  100. I hope you kept the original OS/2 PM Automated EpGuide .ZIP archive because 
  101. you may have to re-install the program to make sure everything is in the 
  102. correct location. 
  103.  
  104. Another alternative is to use a recent backup of your system (a tape backup, 
  105. for example) and restore the files that were originally copied to your hard
  106. drive from the Automated EpGuide .ZIP file. 
  107.  
  108. If you don't have a recent/working tape backup, I suggest that you 
  109. delete the Automated EpGuide directory and start over from scratch. 
  110. This will assure that all files are where they need to be. Go back
  111. to the section entitled INSTALLING THIS PROGRAM for more details.
  112.  
  113. =========================================================================
  114.                        About The Data Files
  115. =========================================================================
  116. Users of the new versions of the Automated EpGuide may wonder why I "hard 
  117. coded" the pathname of the episode data files into the program's executable. 
  118. Mainly for convenience, but also, so as to not clutter the A.E.G. directory 
  119. with dozens and dozens of obnoxious little data files. 
  120.  
  121. The average TV show featured in the Automated Episode Guide programs has 
  122. anywhere from 40 or so episodes (the lower bound, representing approximately 
  123. two or three seasons -- Babylon 5 or the X-Files, for example) on up to 150 
  124. or more (the upper bound, representing seven or eight seasons -- the Simpsons
  125. or MST3K). 
  126.  
  127. Each episode is stored in a small data file corresponding to that episode's 
  128. "number". Install the new version of the MST3K or Simpsons A.E.G. and you got
  129. yourself 150 data files needed by EACH OF THE A.E.G. .EXE files! 
  130.  
  131. OKAY!!! I'LL ADMIT IT!!! I'm an anal retentive control freak! I just can't 
  132. stand to see 150+ little bitty data files floating around in the same 
  133. directory as the rest of the "required" files needed for the A.E.G.'s 
  134. execution. Heaven forbid that some poor, unsuspecting computer novice tries 
  135. to install an A.E.G. in the root directory of his/her/it's hard drive. 
  136. Yikes, I'm getting dizzy just thinking about it!
  137.  
  138. Seriously, the main reason was for convenience. I envisioned some mega-A.E.G.
  139. user who has every Automated EpGuide that I've ever released. In this
  140. fantasy, er, scenario...the person has of course registered all of these 
  141. programs... <<<Subliminal Hint!>>> 
  142.  
  143. By hard coding sub-directories into the program, this poor, troubled 
  144. loaner...uh, user can stash all of the .EXE and .HLP files in one "AEG" 
  145. directory, with all of the bazillion and three data files stored neatly 
  146. in their own little sub-directories.
  147.  
  148.