home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR4 / PB23.ZIP / PLAYBACK.DOC < prev    next >
Text File  |  1993-07-02  |  32KB  |  615 lines

  1.  
  2. **** Welcome to Playback!  Version 2.2  10/16/92 ****
  3.  
  4. Think about it.  How many times do you use your computer to do the same 
  5. task over and over again?  Maybe it's logging on to a bulletin board, 
  6. backing up your hard disk, uploading files to the home office, printing a 
  7. letter, etc..  Wouldn't it be nice if you could just turn on a recorder, 
  8. record the complete task and then play it back with one keystroke 
  9. whenever you needed to do that task again?  Enter Playback. 
  10.  
  11. Playback differs greatly from most macro programs in that Playback 
  12. replays your keystrokes at the same rate you typed them in.  For example
  13. if you type in a program name and then wait for the program to load, 
  14. Playback will too.  You can launch these recorded keystrokes (keyfiles we 
  15. call them) with the touch of a hot key, or turn them into stand-alone 
  16. programs.  As an example of the later, let's say you record a sequence to 
  17. log on to Prodigy, get your stock quotes, save them to a file, exit 
  18. Prodigy, import the file into your spreadsheet, and then print out the 
  19. results.  You could save this task into a stand alone program call 
  20. "GETSTOCK" and then you would just enter "GETSTOCK" at the DOS prompt 
  21. when you wanted to replay this task.  You can even have Playback replay 
  22. this task at some later time, completely unattended.  If you want you can 
  23. group several keyfiles together in a batch file.  And if you want, you 
  24. can start and stop your recordings from within a batch file, without user 
  25. initiation.  You can also assign your keyfiles to different "hot keys".
  26.  
  27. In addition, you can use the included Menu program to playback your 
  28. keystrokes using a point and select menu.  The menu program also lets you 
  29. view the contents of your keyfiles, delete them, change their playback 
  30. speed, add explanatory notes to them, rename them, and launch them at 
  31. some later time. 
  32.  
  33. OK, that last paragraph gave you a brief overview of what Playback does, 
  34. but how would you use it?  I hesitate here because I'm sure I've just 
  35. scratched the surface on ways it can be used, and I don't want to 
  36. discourage you from finding your own applications.
  37.  
  38. Menu program:  Use Playback to record the keystrokes to start each of 
  39. your applications.  Then use the Menu program to Launch them.  
  40.  
  41. Batch files:  I use Playback to record "batch" files.  Why?  I just start 
  42. recording the keystrokes using Playback and then save them to file.  Next 
  43. time I run the Menu program all the keystrokes sequences I saved are 
  44. turned into keyfiles, and I just use the Menu program to rename them to 
  45. whatever I want.  No editing, nothing.  Just record and save.  And I can 
  46. do so much more than normal batch files. 
  47.  
  48. Desktop publishing:  I not only use the Menu program to launch my desktop 
  49. publisher, but if I'm working on a large project I know I'll be doing for 
  50. a while, I create a keyfile that loads the file I want and then goes to 
  51. the page I want.  In addition, when it comes time to print, I'm given a 
  52. whole slew of options that I must select every time I print a page.  
  53. Since my responses are always the same I just record the keystrokes and 
  54. then play them back using the Playback "hot key". 
  55.  
  56. E-Mail:  Use Playback to create a keyfile of the keystrokes to load your 
  57. modem program, load an E-Mail macro, run it, and exit the program.  If 
  58. you want, you can instruct Playback to run this sequence automatically at 
  59. a certain time so your E-Mail is waiting when you get to the office.  One 
  60. of my registered users uses Playback to grab his stock quotes, manipulate 
  61. them, insert them into his spreadsheet, and print the results.  All with 
  62. one keypress. 
  63.  
  64. Keystroke expander:  If I have occasion to replay the same set of 
  65. keystrokes over and over I just record them and then use the "hot key" 
  66. whenever I want to replay them. 
  67.  
  68. Fun:  Try creating a keyfile of yourself writing a letter and then launch 
  69. it at some later time when you're not there but someone else may be 
  70. watching.  It's eerie seeing a computer going about the business of 
  71. writing and editing a letter with no one at the keyboard.
  72.  
  73. Demos:  I have customers who have used Playback to create self-running 
  74. demos.  Nothing like a real time demo, with no one at the keyboard!
  75.  
  76. Monitoring:  Since you can start recordings from a batch file, without 
  77. user initiation, you can use Playback to monitor how people are using 
  78. your computer.  If you can duplicate the initial conditions, you can 
  79. watch as what they did is played backed exactly as it happened. 
  80.  
  81. Basically Playback eliminates repetitive tasks.  Isn't that what 
  82. computers were meant to do in the first place? 
  83.  
  84. === How Much? ===
  85.  
  86. Playback (tm) is copyrighted 1990-92 by RSE Incorporated.  It is user-
  87. supported shareware.  This means you're given this copy in order to 
  88. evaluate it.  If after a 21 day evaluation period you decide to continue 
  89. using it, you must become a registered user by sending the registration 
  90. fee of $35 +$1 shipping (add $1 for 3.5 disk, $5 overseas) to: 
  91.  
  92. Playback Registration │  MC or Visa customers:      │  Modem-It! to:
  93. 1157 57th Drive SE    │  Call or FAX (206) 939-4105 │  (206) 939-2312
  94. Auburn, WA 98002      │  Compuserve: 72371,1557     │  Product ID: PB
  95.  
  96. (Modem-It! (tm) is a free program that lets you use your modem to easily 
  97. place orders 24 hours a day with any participating merchant.  Look for it 
  98. on any bulletin board.) 
  99.  
  100. You are encouraged to freely distribute copies of the PB??.EXE file as 
  101. long as you don't charge anything for the copies.  DO NOT distribute the 
  102. individual, extracted, files; only PB??.EXE. 
  103.  
  104. As a registered user you'll receive these additional benefits: 
  105.  
  106. 1.  No more annoying messages asking you to register.
  107. 2.  Latest version of Playback, PLUS a "decoder" to convert all future 
  108.     versions of Playback to registered versions.
  109. 3.  The latest shareware versions of our other products, including 
  110.     FileNotes, PC-Directory, Remind Me!, Nabbit, BriteLine and more.
  111. 4.  Technical support 
  112. 5.  A sincere "Thank you" for supporting our efforts.
  113.  
  114. Those using Playback in a commercial or educational environment must 
  115. register.  Site licenses are available, as well as quantity discounts.  
  116.  
  117. An Instruction Manual containing printed documentation for all twelve of 
  118. our shareware products (including Playback) is available for an extra $5. 
  119.  
  120. === Let's Get Started ===
  121.  
  122. *  Make sure you've created a new subdirectory for Playback.  It's 
  123. important that the Playback files be the only files in the subdirectory! 
  124.  
  125. *  Go to the subdirectory where the Playback files are located and enter 
  126. "init" at the DOS prompt.  Among other things, the "init" program gives 
  127. you the option to include this subdirectory (where the Playback files 
  128. are) in the PATH statement in your AUTOEXEC.BAT file.  Your original 
  129. "AUTOEXEC.BAT" file will be saved as "AUTOEXEC.OLD".  Init also tells 
  130. Playback where your Keyfiles should be saved and the Menu program where 
  131. to look for Keyfiles.  If you don't want Init to modify your AUTOEXEC.BAT 
  132. file just press N when it asks you. 
  133.  
  134. *  After running Init, reboot your computer so the changes in your 
  135. AUTOEXEC.BAT file take affect. 
  136.  
  137. *** IMPORTANT ***
  138.  
  139. You MUST run the INIT program or Playback won't work correctly.  It 
  140. should only be run once.  DON'T run it every time you use Playback. 
  141.  
  142. One more time - To install Playback:
  143.  
  144. - Create a new subdirectory for Playback.  Move to the new subdir.
  145.  
  146. - Extract the Playback files inside the new subdirectory.  The 
  147.   Playback files should be the ONLY files in the subdirectory. 
  148.  
  149. - Run the initialization program by entering "init" at the DOS 
  150.   prompt. 
  151.  
  152. - Reboot your computer
  153.  
  154. Playback consists of two separate programs, the Playback program which 
  155. captures and plays back the keystroke sequences, and the Menu program 
  156. which we briefly discussed earlier. 
  157.  
  158. === The Playback Program ===
  159.  
  160. Playback (PB.COM) is a small TSR (Terminate and Stay Resident) program.  
  161. You load it once at the beginning of a session and it stays hidden until 
  162. you press one of its "hot keys".  Then it goes to work.  When you're done 
  163. with it, your original program continues as though nothing had happened. 
  164.  
  165. PB.COM only takes up about 3K of memory, plus whatever you allocate for 
  166. the keystroke buffer (more on that later).  
  167.  
  168. To load Playback into memory enter "pb" at the DOS prompt.  If you'd like 
  169. Playback automatically loaded whenever you turn on your computer then put 
  170. the phrase "PB" in your "AUTOEXEC.BAT" file on a separate line AFTER the 
  171. "PATH ..." statement. 
  172.  
  173. When you load Playback into memory a few words appear telling you the 
  174. "hot keys" that Playback uses.  (All the rest of the info encourages you 
  175. to register.  When you do, this info will no longer appear.)  Playback 
  176. has 3 hot keys: one to start and stop recording keystrokes, one to 
  177. playback the keystrokes, and one to save the keystrokes into a file.  
  178. Although the default values are Ctrl-R (press the Ctrl and R keys at the 
  179. same time) to record, Ctrl-P to Playback, and Ctrl-S to save, you can 
  180. change these using the Menu program. 
  181.  
  182. == Recording ==
  183.  
  184. When you press the Record "hot key" (Ctrl-R by default) you will hear an 
  185. ascending series of beeps.  This signals that Playback is now recording 
  186. your keystrokes.  When you've finished recording you press the Record 
  187. "hot key" again.  This time you'll hear a descending series of beeps 
  188. letting you know that the recording is complete. 
  189.  
  190. If you try to record more keystrokes than the keystroke buffer can hold, 
  191. Playback will automatically terminate the recording when the buffer gets 
  192. full.  You can increase the size of the keystroke buffer by using the 
  193. Menu program. 
  194.  
  195. == Print Screen ==
  196.  
  197. To execute a print screen function within your keyfiles use the character 
  198. Alt-254 (enter 254 on the numeric keypad while holding down the Alt key). 
  199.  
  200. == Saving ==
  201.  
  202. If you want to turn the recorded keystrokes into a keyfile then you 
  203. press the Save "hot key" (Ctrl-S by default).  When you press the Save 
  204. "hot key" the recording will be stopped (if you haven't stopped it 
  205. already) and the keystrokes will be saved in a file.  The next time the 
  206. Menu program is run it will turn the keystrokes in this file into 
  207. keyfile.
  208.  
  209. == Playback ==
  210.  
  211. When you press the Playback "hot key" (Ctrl-P by default) the keystrokes 
  212. in the keystroke buffer will be replayed just as you entered them, with 
  213. the same delay between keystrokes. 
  214.  
  215. By the way, you can cancel the playback of keystrokes by pressing the 
  216. Escape key.  This holds true no matter how the playback is initiated. 
  217.  
  218. You can also pause during a playback by pressing the space bar.  
  219. When you want the playback to resume you just press any key. 
  220.  
  221. Exercise:  If you haven't already loaded Playback into memory do so now 
  222. by entering "pb" at the DOS prompt.  Record a keystroke sequence (start 
  223. by pressing Ctrl-R).  Save it (by pressing Ctrl-S).  Play it back (by 
  224. pressing Ctrl-P).  Do this with several different keystroke sequences.  It 
  225. doesn't matter what you record, we're just getting familiar with the way 
  226. things work. 
  227.  
  228. == On/Off ==
  229.  
  230. There may be times when Playback's hot keys are the same ones you need to 
  231. use within an application.  You can turn Playback Off or On by pressing 
  232. the Off/On hot key which is Ctrl-O by default.  It is a toggle: press it 
  233. once and Playback becomes inactive, press it again and Playback becomes 
  234. active again.
  235.  
  236. == Un-installing Playback ==
  237.  
  238. If you'd like to remove Playback from memory then enter "pb/u" at the DOS 
  239. prompt.  However, remember that you must un-install TSR's in the reverse 
  240. order from which they were loaded.  If you don't it's possible your 
  241. computer will "lock up" and require a re-boot.
  242.  
  243.  
  244. === The Menu Program (PBMENU.COM) ===
  245.  
  246. To run the Menu program enter "PBMENU" at the DOS prompt.  The first thing 
  247. the Menu program does is look to see if you have saved any keystroke 
  248. sequences since the last time the program was used.  If you have, then 
  249. they will be converted into Keyfiles.  These Keyfiles will be given a 
  250. name.  The first will be "-B", the second "-C", and so on. 
  251.  
  252. * Run the Menu program at this time by entering "PBMENU" at the DOS prompt.  
  253. You can enter "PBMENU" at any DOS prompt, at any time, and the Menu program 
  254. will appear.  You don't have to be in the Playback subdirectory to run 
  255. the Menu program. 
  256.  
  257. The list to the left of the screen is a list of all the Keyfiles you've 
  258. created.  Select the one you want by using the up, down, home, end, PgUp 
  259. or PgDn cursor keys. 
  260.  
  261. To the right of the screen are three areas.  The top area displays the 
  262. keystroke sequence of the hi-lited Keyfile.  Normal ASCII characters are 
  263. hi-lited.  Shift states (the state of the Insert, Scroll Lock, and Caps 
  264. Lock keys) are enclosed within [ ] and are displayed only when they 
  265. change.  All others keystrokes are displayed within < >.  For example, 
  266. <enter> means the enter key has been pressed, <bs> means the backspace 
  267. key, <Ins> means the Insert key, etc.. 
  268.  
  269. The middle area on the right contains two values: the Playback speed and 
  270. the Launch Time. 
  271.  
  272. Playback speed:  You can playback your keystroke sequences in one of 
  273. three ways.  "Normal" (the default value) means that it's played back at 
  274. the exact speed it was recorded.  "Turbo" means that it's played back at 
  275. max speed.  The middle value "Boost" is a combination of the two.  When 
  276. you select "Boost" a delay between keystrokes of more than 1.5 seconds 
  277. (this value can be adjusted) is retained.   Delays less than 1.5 seconds 
  278. are ignored and the keystrokes are played back at 18 characters a second.  
  279. This option is very useful for situations where you want to eliminate 
  280. insignificant pauses (typing delays for example) but want to retain the 
  281. important delays.
  282.  
  283. Which speed should you use?  Well try "Turbo" first.  If that doesn't 
  284. work then "Boost" probably will.  If "Boost" doesn't work then select 
  285. "Normal".  To change a Keyfile's Playback speed: hi-lite the desired 
  286. Keyfile and press the left or right cursor keys until the desired speed 
  287. is hi-lited.  
  288.  
  289. Launch (not lunch) time:  This is the time you want the program to be 
  290. launched at.  We'll talk about this later when we discuss launches. 
  291.  
  292. The bottom of the right side of the screen is the "Note" area.  You can 
  293. leave notes of up to 160 characters on the contents and purpose of each 
  294. of your Keyfiles.  Those using "PC-Directory" or "FileNotes" will 
  295. recognize these notes as being the same as the filenotes you're used 
  296. to. 
  297.  
  298. === Menu Options ===
  299.  
  300. The top line of the screen displays a menu of your options.  You just 
  301. press the hi-lited key to exercise that particular function.  
  302.  
  303. * Escape:     Pressing the Escape key exits the Menu program. 
  304.  
  305. * Store:      Pressing S for "Store" exits the Menu program and puts the 
  306.     hi-lited Keyfile into Playback's keystroke buffer.  To playback the 
  307.     keystrokes just press the Playback "hot key" (Ctrl-P by default). 
  308.  
  309. * Edit:       When I first released Playback I didn't put a keyfile 
  310.     editor in it.  I thought it would be easier just to record a new 
  311.     keyfile rather than trying to edit an existing one.  Since Playback 
  312.     keeps track of shift states, scan codes, and delays, in addition to 
  313.     the ASCII values, editing a keyfile is an extremely complex task. 
  314.  
  315.     It wasn't long before I started getting requests from customers for 
  316.     an editor.  As a result, I created a simple overstrike editor for 
  317.     Playback that lets you change the ASCII values, and the delays of 
  318.     keystrokes in the file.  You can't add or delete keystrokes, and you 
  319.     can't edit the shift states (Ctrl, Alt, Shift).  In addition you 
  320.     can't change non-ASCII keystrokes like pressing the F1 key, insert 
  321.     key, delete key, etc..  It's just for changing the ASCII values and 
  322.     the delays. 
  323.  
  324.     An example:  You create a keyfile that gathers up data from different 
  325.     sources and then transfers this data somewhere else.  Part of the 
  326.     transfer process involves inputting today's date.  It's a big keyfile 
  327.     and you don't want to re-record it every day just because you have to 
  328.     change the date.  In this case using the editor would make a lot of 
  329.     sense. 
  330.  
  331.     To use the editor, highlight the desired file and then press E for 
  332.     edit.  The file will be listed on the screen.  Characters that you 
  333.     can edit will appear as they are, those you can't edit will appear as 
  334.     small dots.  You can use the cursor keys and the Tab, Home and End 
  335.     keys to position the cursor at the value you want to change.  Press 
  336.     the desired key.  The value will change from the old to the new and 
  337.     the cursor will move to the next value.  You may edit as many 
  338.     characters as you wish. 
  339.  
  340.     Editing keystroke delays is much the same.  The delay that will 
  341.     occur between the previous keystroke and the keystroke the cursor is 
  342.     at each is displayed in the lower right corner of the screen.  Press 
  343.     F10 to increase the delay or F9 to decrease it.  (Although not 
  344.     displayed on the Edit screen, F7 and F8 also let you change the delay 
  345.     but in 1 second steps rather than in steps of 1/18th of a second.) 
  346.  
  347.     At any time during the edit process you can press the Esc key to 
  348.     return to the Menu program without saving any changes you may have 
  349.     made.  If you want to incorporate the changes into the keyfile then 
  350.     press F1.  If you want to create a new keyfile with another name then 
  351.     press F2. 
  352.  
  353. * Configure:  Pressing C for Configure brings up another screen of 
  354.     information.  All of the items you can change will be listed to the 
  355.     left of the screen along with their current values.  To change a 
  356.     particular item: 
  357.  
  358.     -  Use the up and down arrow keys to select the item you want to 
  359.        change.  
  360.     -  Press the left or right arrow keys to change the value of the 
  361.        selected item.  
  362.  
  363.     To change a "hot key" you need to select the shift state (Ctrl, Alt, or 
  364.     Ctrl and Alt) and then select a key.  For example to change the Playback 
  365.     "hot key" to Ctrl-D you would first select "Playback Shift State", press 
  366.     the right arrow key until "Ctrl" appeared, then press the down arrow to 
  367.     select "Playback Key", press the right arrow (to indicate you want to 
  368.     change it) and then press the desired key: D.  Clear as mud?  Try it and 
  369.     it'll all make sense. 
  370.  
  371.     Some of the items need explaining:
  372.  
  373.     Color Monitor?  If you have a color monitor then select "Yes".  This just 
  374.     affects whether the Menu program displays in color. 
  375.  
  376.     Flickering?  If when the cursor is on the "Flickering?" line your monitor 
  377.     begins to flicker then select "Yes" else select "No". 
  378.  
  379.     Buffer Size:   Change this value to change how many keystrokes the 
  380.     keystroke buffer holds.  Remember that each keystroke adds 5 bytes to the 
  381.     amount of memory Playback uses.  For example, if you select 200 
  382.     keystrokes, then Playback will take up about 4K of memory, 3K for the 
  383.     program and 1K (200*5) for the keystroke buffer.  The max is 3000 
  384.     keystokes.  If you have a task greater than 3000 keystrokes break it 
  385.     up into smaller keyfiles.
  386.  
  387.     Boost Threshold:  Remember how Boost works?  Any delays above a certain 
  388.     threshold are acted on, any below the threshold are ignored.  This value 
  389.     sets that threshold.  I've found that a threshold of 1.5 seconds works 
  390.     well.  You may want to lower or raise it depending on how fast you type 
  391.     and the type of applications Playback is activating.  Experiment. 
  392.  
  393.     Default Playback Speed:  Playback normally defaults to the normal 
  394.     playback speed, i.e. the keyfiles play back at the exact speed they were 
  395.     recorded.  You can change this value to boost, or turbo, if you want.  
  396.     This only affects newly created keyfiles.  Remember, this is just the 
  397.     default, you can still change the playback speed of each individual 
  398.     keyfile by using the Menu program.
  399.  
  400.     Press Escape when you've made all your changes.  The Menu program will 
  401.     re-appear. 
  402.  
  403.     If Playback is in memory (and it should be when you use the Menu program) 
  404.     then you'll have to reboot the computer and reload Playback to notice 
  405.     changes made to the Hot Keys, Buffer Size, and Boost Threshold. 
  406.  
  407. * Rename: you'll obviously want to rename your Keyfiles to something 
  408.     other than the default names the Menu program gives them.  Just hi-
  409.     lite the desired file and press R for Rename. 
  410.  
  411. * Launch: when you press L for "Launch" another menu will drop down 
  412.     giving you three options:  Launch Now, Launch Later, Launch Time. 
  413.  
  414.     If you press N to "Launch <N>ow"  the Menu program ends and the hi-
  415.     lited Keyfile runs immediately. 
  416.  
  417.     Pressing L for "Launch <L>ater" selects the hi-lited file to be 
  418.     launched at a later time: the time specified on the right middle of 
  419.     the screen under "Launch Time".  Select <L>ater Launch only if the 
  420.     Launch Time value for the hi-lited file is the time you want the 
  421.     keyfile to be launched at.  If the time isn't correct the use the 
  422.     next option "Launch <T>ime" to effect the delayed launch.
  423.  
  424.     You can only select one file for Later Launch.  The file selected for 
  425.     a later launch is marked with a "*" to the left of its name.  If you 
  426.     want to un-select a file that you've already selected for a Later 
  427.     Launch simply select it again and the mark will disappear. 
  428.  
  429.     When you exit the Menu program, an alarm is set so that at the launch 
  430.     time the keystrokes in the keyfile selected for later launch (the one 
  431.     with the "*") get loaded into Playback and get played back just as if 
  432.     you'd pressed the Playback hot key.  For example, if you leave your 
  433.     computer on at night you could have Playback launch a Keyfile to 
  434.     retrieve your E-Mail right before you get to work in the morning, so 
  435.     it's waiting for you when you arrive. 
  436.     
  437.     The third option is to press T to select "Launch <T>ime".  This lets 
  438.     you adjust the Launch Time of the hi-lited file.  When you've 
  439.     finished adjusting the launch time then press Return and the keyfile 
  440.     will be marked for later launch with a "*".  Just exit the Menu 
  441.     program by pressing Escape and the file will be launched at the time 
  442.     you just set. 
  443.  
  444.     == NOTE ==  Obviously, launching a file normally, or as a delayed 
  445.     launch, won't do anything if Playback isn't loaded into memory. 
  446.  
  447. * Insert_Note:  Pressing the Insert key lets you leave a 160 character 
  448.     note on the contents or purpose of the hi-lited Keyfile.  Type in 
  449.     your note and press Enter. 
  450.  
  451.     Pressing Escape lets you escape without changing the note.  Entering 
  452.     a note only one character in length deletes the note. 
  453.  
  454. * Delete:  Press the Delete key to delete the hi-lited Keyfile. 
  455.  
  456. === Keyfile Operation ===
  457.  
  458. As we've discussed several times, you can have your keyfiles playback 
  459. just by entering their name at the DOS prompt.  However, there are a 
  460. couple of other options you can also execute from the DOS prompt by 
  461. adding command line options to the keyfiles name. 
  462.  
  463. Storing a keyfile:  If you just want to load the keyfile into Playback 
  464. so you can activate it later using the Playback hot key, then use the 
  465. command line option "/s" where "s" stands for store.  As an example 
  466. entering "test /s" at the DOS prompt would load the "test" keyfile into 
  467. Playback, but not replay it until you press the Playback hot key.  
  468.  
  469. Delayed Launches:  You can have a specific keyfile launched at some later 
  470. time by using the command line option "/hhmm" where "hhmm" is a 4 digit 
  471. number with the first two digits specifying the hour (in 24 hour military 
  472. time) and the last two digits representing the minutes.  The 4 digit 
  473. number MUST be exactly four digits long or things will get messed up.  
  474. DON'T seperate the hours and minutes by a colon, or anything else.  As 
  475. an example entering "test /0330" would load the keyfile "test" into 
  476. Playback and replay it at 3:30am.  Likewise "test /1750" would playback 
  477. the "test" keyfile at 5:50pm. 
  478.  
  479. Running Keyfiles from within a batch file:
  480.  
  481. Normally, you can only run a keyfile from a batch file if it is the last 
  482. item in the batch file.  Why?  Because all a keyfile does is load its 
  483. keystrokes into Playback and initiate a replay.  The keyfile program then 
  484. quits and Playback goes about its business of stuffing in keystrokes 
  485. totally in the background.  So what happens if you run a keyfile from a 
  486. batch file anywhere but as the last item?  The keyfile will load its 
  487. keystokes into Playback, initiate the Playback, and then end.  The rest 
  488. of the batch file will continue to execute even tho the playback of the 
  489. keystrokes has just started.
  490.  
  491. However, due to popular demand, I've created a batch file command line 
  492. option that lets you use keyfiles anywhere in a batch file.  You can 
  493. even put several of them in a batch file if you want, or call one keyfile 
  494. from inside another.  To do this just append the keyfile name with the 
  495. "/B" command line option when you specify it in the batch file.  For 
  496. example, the "test" keyfile would become "test /b".  There is a 
  497. limitation though:  The keyfile must exit at the DOS prompt.  In other 
  498. words, whatever task you have the keyfile performing, it must return to 
  499. the DOS prompt when it's finished.  In addition, you don't need to use 
  500. the "/B" option if you're using the store or delayed launch command line 
  501. options because the Playback of keystrokes in this case isn't immediate.
  502.  
  503.  
  504. Starting (and stopping) a recording from within a batch file:
  505.  
  506. Instead of using the hot keys to start and stop a recording, you can do 
  507. it from within a batch file by using "pb /r" to start the recording and 
  508. "pb /s" to stop the recording.  Playback disables its hot keys when a 
  509. recording is initiated this way so you must use "pb /s" to stop the 
  510. recording.  In addition, since you don't know how many keystrokes the 
  511. user may enter, you'll probably want to use the "Configure" portion of 
  512. the Menu program to greatly increase the keyboard buffer size. 
  513.  
  514. This feature can be a real boon for those of you looking to see how users 
  515. react to a new piece of software.  You can create a batch file to start 
  516. the program that uses "pb /r" to initiate a recording, then loads the 
  517. software, and finishes with "pb /s".  You'll then have a keyfile of 
  518. everthing the user did as he/she tried the software.
  519.  
  520. === Assigning Keyfiles to "Hot-Keys" ===
  521.  
  522. You can assign your keyfiles to different hot-keys.  That way when you 
  523. want to playback a particular keyfile you just press the hot-key you 
  524. assigned it to.  This is how you would assign the keyfile "GETMAIL" to 
  525. the hot-key: Alt-Ctrl-Z 
  526.  
  527.     PB :AC-Z GETMAIL
  528.  
  529. The format is a colon followed by the hot key abbreviation which uses C 
  530. for Ctrl, A for Alt, L for Left Shift, and R for Right shift, then a dash 
  531. followed by the combination key which must be A-Z.  Then you put a space 
  532. and follow it with the name of the keyfile.  For example to assign the 
  533. "TEST" keyfile to Alt-T you would enter: "PB :A-T TEST" 
  534.  
  535. You can have up to 10 keyfiles assigned to hot-keys.  You can list the 
  536. hot-keys and their associated keyfiles by entering "PB :".  If you have 
  537. multiple keyfiles that you assign to hot-keys on a regular basis you may 
  538. want to use a batch file (or a keyfile) to do the assigning for you. 
  539.  
  540. === Problems? ===
  541.  
  542. "When I run PBMENU I get an 'Aborting - No files' message."  The Menu 
  543. program can't find any Keyfiles, or information to make Keyfiles.  This 
  544. can happen for two reasons.  The obvious is that you haven't saved any 
  545. keystroke sequences.  Remember, to create a Keyfile you need to record 
  546. the keystroke sequence and then press the Save hot key. 
  547.  
  548. The second reason is that you didn't install Playback correctly.  More 
  549. than likely you didn't run the initialization program.  Delete all the 
  550. Playback files, return your autoexec.bat file to the way it was and 
  551. reinstall again according to the instructions given earlier.  If Playback 
  552. is not installed correctly, things won't work right. 
  553.  
  554. "Playback doesn't capture my mouse moves."  You're right, Playback only 
  555. captures keystrokes.  But most mouse programs have keyboard commands as 
  556. well.  Use them. 
  557.  
  558. "Playback signaled the end of the recording session (descending series of 
  559. beeps) before I instructed it to."  You attempted to record more 
  560. keystrokes than the keystroke buffer can hold.  Use the Menu program to 
  561. increase the size of the keystroke buffer, un-install Playback using "PB 
  562. /U", reload Playback, and try again. 
  563.  
  564. "Some of my keystrokes weren't captured."  It's possible for programs to 
  565. intercept keystrokes and not pass the information on to the rest of us.  
  566. As a result there are situations where we can't get the information we 
  567. need. These situations are very rare.  The only place I've seen them is 
  568. in the activation of TSR programs and games.  What they do is intercept 
  569. the information coming from the keyboard, act on it, and then fool the 
  570. computer into thinking there never was a key pressed (much like what 
  571. happens when you press one of Playback's hot keys). 
  572.  
  573. In addition, some programs take complete control over the computer, in 
  574. many cases ignoring previous TSR programs.  Microsoft Windows does this.  
  575. For information on using Playback within MS Windows consult the file 
  576. "WINDOWS.TXT" on your Playback disk. 
  577.  
  578. "While trying to activate a function in one of my applications I end up 
  579. activating Playback instead."  The function you're trying to use in your 
  580. application uses the same key sequence as one of Playback's hot keys.  To 
  581. eliminate the conflict use the configuration function in the Menu program 
  582. to change Playback's hot keys to something that won't interfere with your 
  583. other applications, or use Playback's On/Off hot key to turn off 
  584. Playback. 
  585.  
  586. "When I try to run PBMENU the program locks up or starts generating 'divide 
  587. overflow' error messages."  Chances are you've got a .COM file in the 
  588. Playback subdirectory that isn't one of the Playback files or a Keyfile.  
  589. Remember, there shouldn't be any .COM files in the Playback subdirectory 
  590. (other than the keyfiles) except AL.COM, PB.COM and PBMENU.COM.
  591.  
  592. === Technical Assistance ===
  593.  
  594. Call 1-206-939-4105 for technical assistance, or leave a message on 
  595. Compuserve at 72371,1557.  Please have your registration number handy. 
  596.  
  597. === Distributing your Keyfiles ===
  598.  
  599. You can freely distribute the keyfiles you create using Playback to 
  600. others.  Of course they won't run unless the end user also has Playback.  
  601.  
  602. However, we do have a program that converts your keyfiles to autonomous 
  603. keyfiles that don't require Playback to execute.  For a $495 license fee 
  604. we will supply you with the conversion program, a registered copy of 
  605. Playback, and a license that grants you unlimited distribution rights for 
  606. all of your converted keyfiles.  Contact Scott Chaney at (206) 939-4105. 
  607.  
  608. === So long ====
  609.  
  610. That's it folks.  Hope you find Playback worthy of your support.  
  611. Why don't you give our other programs a spin as well?  
  612.  
  613. Take care. 
  614.  
  615.