home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / sir_v1b.zip / sir.INF (.txt) < prev    next >
OS/2 Help File  |  1996-03-11  |  20KB  |  431 lines
  1.  
  2. ΓòÉΓòÉΓòÉ <hidden> Filenames used by SIR! ΓòÉΓòÉΓòÉ
  3.  
  4. Sir.EXE 
  5. Folder_Image_Of_The_Day.Bmp 
  6. Backdrop_Of_The_Day.Bmp 
  7. OS2LOGO 
  8. SIR.configuration 
  9. Mon.Cmd, Tue.cmd, Wed.cmd, Thu.cmd, Fri.cmd, Sat.cmd and Sun.cmd. 
  10.  
  11.  
  12. ΓòÉΓòÉΓòÉ <hidden> The Author ΓòÉΓòÉΓòÉ
  13.  
  14. Me be Jan-Helge Bergesen and this program be much for just the fun of it!. 
  15.  
  16. My appologies for the very, very, very NOT good installation, but I AM stupid! 
  17.  
  18. Click Here For Licence 
  19.  
  20.  
  21. ΓòÉΓòÉΓòÉ 1. About ΓòÉΓòÉΓòÉ
  22.  
  23.  
  24. (Should I Run) 
  25. By Jan-Helge Bergesen 1996 
  26.  
  27. SIR! is a small program that contains sub modules that perform various tasks. 
  28. The idea is to have it run as a CALL in CONFIG.SYS, so even though it is 
  29. possible to run anytime this doc assumes that it is run as a CALL. 
  30.  
  31. The program relies on a number of system variables in its function, and will 
  32. not function without them. 
  33.  
  34. Current sub-modules: 
  35.  
  36.                     Module Name              Description 
  37.                     bmp_chgr                 Changes the folder background at 
  38.                                              random 
  39.                     bdrop_chgr               Changes the desktop backdrop at 
  40.                                              random 
  41.                     lgo_chgr                 Changes the boot logo at boot-time 
  42.                                              at random 
  43.                     xtrn_proc                Runs an OS/2 command file at 
  44.                                              boot-time 
  45.                     KillTemp                 Cleans the temporary directory (if 
  46.                                              any) 
  47.  
  48.  
  49. ΓòÉΓòÉΓòÉ 2. Required Files ΓòÉΓòÉΓòÉ
  50.  
  51. The following files should be somewhere: 
  52.  
  53.                     File                          Description 
  54.                     Sir.EXE                       The program itself (Either 
  55.                                                   HPFS or FAT) 
  56.                     SirFuncs.DLL                  The shared DLL (Both HPFS or 
  57.                                                   FAT, *MUST* reside in the 
  58.                                                   LIBPATH) 
  59.                     SIR.INF                       The documentation in IPFC 
  60.                                                   format (should be in the 
  61.                                                   BOOKSHELF path) 
  62.                     Install.Cmd                   Installation Rexx script 
  63.                                                   (needs rexx installed) 
  64.                     KtmpPM.EXE                    The PM stand alone version of 
  65.                                                   KillTemp module in 
  66.                                                   SirFuncs.DLL 
  67.                     kt.Exe                        The VIO stand alone version 
  68.                                                   of the PM version of the 
  69.                                                   module in SirFuncs.DLL 
  70.                     Revision.Log                  Guess┬╖.┬╖ 
  71.                     SIR.CFG/Sir.Configuration     The configuration file 
  72.                                                   created by SIR 
  73.  
  74.  
  75. ΓòÉΓòÉΓòÉ 3. Modules ΓòÉΓòÉΓòÉ
  76.  
  77. Please make a selection in the contents tree. 
  78. This page intentionally blank. 
  79.  
  80.  
  81. ΓòÉΓòÉΓòÉ 3.1. bmp_chgr: Folder background changer ΓòÉΓòÉΓòÉ
  82.  
  83. This modules switches the active folder bitmap when activated. 
  84. It uses the variable BMP_SRC_DIR and selects and image at random of the *.BMP 
  85. files it finds there. 
  86. The selected bitmap is then copied into the directory pointed to by 
  87. BMP_DEST_DIR, and is renamed to Folder_Image_Of_The_Day.BMP 
  88.  
  89. It requires the following system variables: 
  90.  
  91.                     BMP_SRC_DIR 
  92.                     BMP_DEST_DIR 
  93.  
  94.   Observe!
  95.  These variables must NOT point to the same location. 
  96.  This because bmp_chgr selects a random file in BMP_SRC_DIR, which means it is 
  97.  possible the destination can be selected as a source. 
  98.  This will lead to errors. 
  99.  
  100.  
  101. ΓòÉΓòÉΓòÉ 3.2. bdrop_chgr: Desktop picture changer ΓòÉΓòÉΓòÉ
  102.  
  103. This module swicthes the active desktop backdrop when activated. 
  104. It copies the randomly selected bitmap from the directory pointed to by 
  105. BDROP_SRC_DIR into the destination directory pointed to by BDROP_DEST_DIR with 
  106. the name Backdrop_Of_The_Day. 
  107.  
  108. It requires the foloowing system variables to be set: 
  109.  
  110.  BDROP_SRC_DIR 
  111.  
  112.  BDROP_DEST_DIR 
  113.  
  114.   Observe!
  115.  These variables must NOT point to the same location. 
  116.  This because bmp_chgr selects a random file in BDROP_SRC_DIR. This means there 
  117.  is a slight chance the destination also can be the source. 
  118.  This will lead to errors. 
  119.  
  120.  
  121.  
  122.  However BDROP_SRC_DIR can be the same as BMP_SRC_DIR. 
  123.  
  124.  
  125. ΓòÉΓòÉΓòÉ 3.3. lgo_chgr: Bootpicture changer ΓòÉΓòÉΓòÉ
  126.  
  127. This module switches the picture displayed at boot time when activated. 
  128. It selects a *.LGO file at random from the directory pointed to by LOGO_SRC_DIR 
  129. It then removes any attributes on the file [boot drive]:\OS2LOGO and copies the 
  130. selected file into it. 
  131.  
  132. Note:  lgo_chgr assumes you've booted from the same drives as your OS2SYS.INI 
  133. is located. 
  134. That is, the drive letter is grabbed from the statement SET 
  135. SYSTEM_INI=(whatever) in CONFIG.SYS. 
  136.  
  137. System variables required for module: 
  138.  
  139.  LOGO_SRC_DIR. 
  140.  
  141.  Also supplied in the archives are a selection of *.LGO files as I found them 
  142.  on the Hobbes CD-ROM. I've enclosed the files as they came (I think). 
  143.  
  144.  
  145. ΓòÉΓòÉΓòÉ 3.4. xtrn_proc: External command file execution ΓòÉΓòÉΓòÉ
  146.  
  147. This module runs a command file asociated with the name of the day. 
  148. I.e. on a Thursday,  Thu.Cmd would be run. 
  149. These files *MUST* reside in the default directory. If the module is activated 
  150. and the required file is missing, an error will be issued, 
  151.  
  152. Note:  These files must not be Rexx/2 scripts, if so the module will fail. 
  153. This is because Rexx isn't started at this time of boot time. 
  154.  
  155.  
  156. ΓòÉΓòÉΓòÉ 3.5. KillTemp: Clean up temporary directory ΓòÉΓòÉΓòÉ
  157.  
  158. This module cleans up the directory pointed to by TMP or TEMP system variables. 
  159. KillTemp prefers the name TEMP. 
  160. If this is not found TMP is sought after is this isn't available either, 
  161. KillTemp fails. 
  162.  
  163. When cleaning up KillTemp remove all files and subdirectories regardless of 
  164. attributes set. If you should happen delete something of importance, files are 
  165. recoverable if DELDIR variable is set. 
  166. This tells OS/2 to keep the most recently deleted files 
  167.  
  168. At present this module runs wether you want it or not, thus making the 
  169. temporary directory somehow act like a RAM disk. 
  170.  
  171. (See also KillTemp PM) 
  172.  
  173. The reason for both TMP and TEMP being checked for, is the fact that 
  174. applications don't seem to agree on what to use...%-) 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 4. Command line options ΓòÉΓòÉΓòÉ
  178.  
  179. The only argument accepted is "setup". 
  180.  
  181. This is used for configuring and re-configuring SIR!. Changes are saved in 
  182. "SIR.configuration" in the location pointed to by SIR_CFG or the default 
  183. directory if missing. 
  184.  
  185. The format of the file is as follows: 
  186. One header(22 byte) + one 4-bit bitfield for each weekday. The bifield is 
  187. written as normal char's. 
  188. The bitfield looks like this: 
  189.  
  190. struct do_what{
  191.        unsigned X_BMP : 1;
  192.        unsigned X_BDROP: 1;
  193.        unsigned X_LOGO: 1;
  194.        unsigned X_XTRN: 1;
  195.        };
  196.  
  197.  
  198. ΓòÉΓòÉΓòÉ 5. Setting up ΓòÉΓòÉΓòÉ
  199.  
  200. After running 'INSTALL.EXE', you should have an updated CONFIG.SYS and an extra 
  201. folder on you desktop. (Please chech) 
  202. The folder contains two objects: 
  203.  
  204.                     Object name:             What it does: 
  205.                     Sir! Setup               Runs SIR.EXE with the parameter 
  206.                                              setup. 
  207.                     ReadMe                   This is the WPProgram object for 
  208.                                              this doc 
  209.  
  210.  
  211.   Your CONFIG.SYS should contain the system variables needed, and a CALL for 
  212.  SIR.EXE. 
  213.  After setting the variables (i.e. re-booting), you must set up the Workplace 
  214.  with the bitmap names created by SIR!. 
  215.  
  216.  When configuring SIR!, use the command line option 'setup' by typing: 
  217.  
  218.   [C:\]sir setup[enter]
  219.  
  220.  This will take you through the configuration steps of each weekday. 
  221.  
  222.  
  223. ΓòÉΓòÉΓòÉ 5.1. System Variables ΓòÉΓòÉΓòÉ
  224.  
  225. SIR! requires some system variables to be set. 
  226.  
  227. System variables can be set globally or locally. 
  228. You can do this by editing your CONFIG.SYS to set them globally, or just set 
  229. them at the command prompt to set them locally. 
  230. It is recommended to set them in CONFIG.SYS since you will not have any manual 
  231. control of the environment at boot time when SIR! is supposed to run. 
  232. Setting variables in CONFIG.SYS requires a reboot, as CONFIG.SYS only is read 
  233. at boot. 
  234. Please refer to OS/2's online information for more help on this topic. 
  235.  
  236. The following are the required system variables. Whitout them SIR! will no 
  237. work: 
  238.  
  239.  BMP_SRC_DIR 
  240.  BMP_DEST_DIR 
  241.  BDROP_SRC_DIR 
  242.  BDROP_DEST_DIR 
  243.  LOGO_SRC_DIR 
  244.  
  245.  In addition SIR_CFG, may be set to point to SIR.configuration, if not found 
  246.  SIR! will create and maintain this file in its default directory. 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ 5.2. Setting up the window schemes ΓòÉΓòÉΓòÉ
  250.  
  251. As mentioned I haven't studied the OS/2 API, so you just have to set up a 
  252. window scheme manually. 
  253. However first you'll have to run SIR! once after the variables have been set. 
  254. This so that the files has been created. 
  255. This is how it's done (more or less, my sustem speaks Norwegian see..): 
  256.  
  257.            1. Open she System Folder : 
  258.  
  259.            2. Open the Setup Folder : 
  260.  
  261.            3. Open the Window Scheme object : 
  262.  
  263.            4. Double click on a object of your choice. 
  264.  
  265.            5. Drop down the list box on the right of the window. 
  266.  
  267.            6. Select desktop bacground. 
  268.  
  269.            7. Push the edit button. 
  270.  
  271.            8. Search for the bitmap (Backdrop.BMP / Backdrop_Of_The_Day.BMP) 
  272.  
  273.            9. Close the dialog. 
  274.  
  275.           10. Select folderbackground. 
  276.  
  277.           11. Push the edit button. 
  278.  
  279.           12. Search for the bitmap (Folder.Bmp/Folder_Image_Of_The_Day.BMP). 
  280.  
  281.           13. Close the dialog. 
  282.  
  283.           14. Hold down the 'ALT' key and drag the scheme into the Workplace 
  284.               and drop it. 
  285.  
  286.  And that should be it. If it didn't work, remember I am NOT to blame ;-)= 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 6. KillTemp PM ΓòÉΓòÉΓòÉ
  290.  
  291. KillTemp PM is an (almost) stand alone program derived from SIR! 
  292.  
  293. Imagine you've been downloading lost of stuff, unzipped it, tested it, and 
  294. determined it to be crap. Usually this calls for some filemanager to be started 
  295. and a lot of deleting... 
  296.  
  297. NO MORE!! 
  298.  
  299. KillTemp PM would reside on your Launch Pad and at one click, clean up the 
  300. entire temp directory. KillTemp PM, as KillTemp module of SIR!, removes 
  301. everything regardless of attribute set. However files are recoverable, if 
  302. you've set the DELDIR vaiable in CONFIG.SYS. 
  303. There's really not much more to say about it, other than this too requires 
  304. "SirFuncs.DLL"(v1.14+) to be present in your LIBPATH. 
  305.  
  306.  
  307. ΓòÉΓòÉΓòÉ 7. kt.Exe ΓòÉΓòÉΓòÉ
  308.  
  309. kt.Exe is the VIO version of KillTemp PM. 
  310. Other than it's a VIO program, its a complete duplicate of KillTemp PM 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 8. License ΓòÉΓòÉΓòÉ
  314.  
  315.                        This program is Freeware. Enjoy it.
  316.  
  317.                                    SIR! LICENSE
  318.  
  319.       SIR! not public domain software. It is FREEWARE and is provided AS IS.
  320.               I MAKE NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
  321.                  INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF
  322.             MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  323.  
  324.              All users are granted an unlimited license to copy SIR
  325.                              for the use of others.
  326.  
  327.              No fee, charge or other compensation may be accepted or
  328.                             requested by any person.
  329.  
  330.                  SIR! may be distributed in conjunction with any
  331.                       other product to your hearts desire.
  332.  
  333.         Operators of electronic bulletin board systems (Sysops) may post
  334.              SIR! for downloading by their users only as long as the
  335.                             above conditions are met.
  336.  
  337.           Distributors of public domain or user supported software may
  338.                  distribute copies of SIR! subject to the above
  339.                                    conditions.
  340.  
  341.  
  342.                    This means: IT'S ENIRELY FREE WHATSOEVER!!
  343.  
  344.  
  345. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  346.  
  347. Point to the directory containing your *.LGO files. 
  348. Variable set in CONFIG.SYS (globally) or in the relevant session (locally). 
  349.  
  350. Example: 
  351.  
  352. SET LGOG_SRC_DIR=C:\OS2\LOGOS
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  356.  
  357. Points to the directory containing your bitmap selection. 
  358. Variable set in CONFIG.SYS (globally) or in the relevant session (locally). 
  359.  
  360. Example: 
  361.  
  362. SET BMP_SRC_DIR=C:\OS2\BITMAP
  363.  
  364.  
  365. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  366.  
  367. Points to the directory you want the active bitmap contained. 
  368. Variable set in CONFIG.SYS (globally) or in the relevant session (locally). 
  369.  
  370. Example: 
  371.  
  372. SET BMP_DEST_DIR=C:\INIT
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  376.  
  377. Points to the dircetory containing your selected backdrops. 
  378. Variable set in CONFIG.SYS (globally) or in the relevant session (locally). 
  379.  
  380. Example: 
  381.  
  382. SET BDROP_SRC_DIR=C:\OS2\BITMAP\BACKDROP
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  386.  
  387. Points to the directory where your want the backdrop contained. 
  388. Variable set in CONFIG.SYS (globally) or in the relevant session (locally). 
  389.  
  390. Example: 
  391.  
  392. SET BDROP_DEST_DIR=C:\INIT
  393.  
  394.  
  395. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  396.  
  397. This is a file used by OS/2 at startup. 
  398. If this file would is corrupted in anyway, OS/2 will not boot. 
  399. In this case you will have to boot from installation disks and copy the default 
  400. file over to the harddisk. 
  401.  
  402.  
  403. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  404.  
  405. This variable points to SIR.configuration's location and should be set in 
  406. CONFIG.SYS (globally). 
  407. If not found SIR! looks in the current directory, if it isn't found there 
  408. either SIR! prompts you to answer if it should be created. 
  409.  
  410. Example: 
  411.  
  412. SET SIR_CFG=C:\INIT
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  416.  
  417. Used to start a process when CONFIG.SYS is read. 
  418. Unlike START, CALL waits for the process's termination. 
  419.  
  420. Usage 
  421.  
  422. CALL=[DRIVE][PATH][PROGRAM][ARGS]
  423. When using SIR!: 
  424.  
  425. CALL=C:\bin\sir.exe
  426.  
  427.  
  428. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  429.  
  430. Note:  These command files cannot be Rexx/2 scripts as rexx isn't started at 
  431. the time SIR! normally executes.