home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / pmate.zip / PMATE.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-06-17  |  17KB  |  434 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PMATE Version 1.02 ΓòÉΓòÉΓòÉ
  3.  
  4. PMATE is an automation tool which is intended to help remove the boring, 
  5. repetitive tasks from the test activity. 
  6.  
  7. PMATE builds upon previous IBM Record/Replay tools, together with a number of 
  8. new ideas, to become a next-generation macro recorder and testing productivity 
  9. tool. 
  10.  
  11. The command reference file, pmate.inf, provided with the package explains how 
  12. to install and use PMATE. We recommend that you study this file first, by 
  13. selecting Help->Reference from the PMATE menu. 
  14.  
  15. Functional Overview 
  16.  
  17. o To record and playback to/from a readable, editable text file (instead of an 
  18.   unreadable, uneditable binary file). 
  19. o Support for easily recreating the conditions of the recorded test. (PMATE 
  20.   Records and restores window positions and sizes) 
  21. o To provide maximum recorded information while minimizing the storage 
  22.   requirements. 
  23.  
  24.    - Filtering out unnecessary mouse movements 
  25.    - Saving bitmap AREAS, not just the entire screen, and saving them in 
  26.      compressed form. 
  27.    - Saving areas of the screen in CRC form 
  28.    - Providing before and after views of bitmap areas side-by-side on-screen. 
  29.  
  30. o To provide an unobtrusive record / playback mechanism, featuring a powerful 
  31.   set of menu items without the need to remember a variety of hot keys, or 
  32.   having a PM application's window obscuring a major portion of the screen. 
  33. o To support being invoked from a REXX script (e.g. from within existing stress 
  34.   tests) or from a command file. 
  35. o To provide error logging plus an error return code capability to allow 
  36.   branching decisions within a REXX or command file. 
  37. o To allow the user to incorporate comments into the recorded text file. 
  38. o To make testcase scripts easily modifiable as the system under test evolves 
  39.   and changes. 
  40.  
  41. Refer to Help Index for more complete details. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 2. File Menu ΓòÉΓòÉΓòÉ
  45.  
  46. The File menu contains commands that you use to create, open, save, and print 
  47. data files. In addition, it also contains the command that you use to exit the 
  48. Sample application. The following commands appear in the File menu. 
  49.  
  50. New            Creates a new untitled file 
  51.  
  52. Open           Opens an existing file 
  53.  
  54. Save           Saves any changes to current file 
  55.  
  56. Save As        Saves the current file using a new name 
  57.  
  58. Print          Prints a file 
  59.  
  60. Page Setup     Displays various page-design options 
  61.  
  62. Print Setup    Helps you set up your printer for use with the Sample 
  63.                application 
  64.  
  65. Exit           Quits the Sample application 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 3. New ΓòÉΓòÉΓòÉ
  69.  
  70.  You can create a new file in the Sample application window by using the New 
  71. command. To create a new file, do the following. 
  72.  
  73. o Select the File menu and choose the New command. 
  74.  
  75.  The word "untitled" appears in the title bar of the new file. 
  76.  
  77.  
  78. ΓòÉΓòÉΓòÉ 4. Open ΓòÉΓòÉΓòÉ
  79.  
  80. You can open a file that exists on any drive or in any directory by using the 
  81. Open command. To open a file, do the following. 
  82.  
  83. o Select the File menu and choose the Open command. 
  84.  
  85. A dialog box appears, showing you a list of files in the current directory. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 5. Save ΓòÉΓòÉΓòÉ
  89.  
  90. You use the Save command to save changes you've made to your file. To save 
  91. changes to the current file, do the following. 
  92.  
  93. o Select the File menu and choose the Save command. 
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 6. Save As ΓòÉΓòÉΓòÉ
  97.  
  98. You use the Save As command to name and save a new file. 
  99.  
  100. Follow these steps to save a new file. 
  101.  
  102. o Select the File menu and choose the Save As command. 
  103.  
  104. A dialog box appears, prompting you for a new filename. 
  105.  
  106.  
  107. ΓòÉΓòÉΓòÉ 7. Print ΓòÉΓòÉΓòÉ
  108.  
  109. You use the Print command to print a Sample application file. 
  110.  
  111. Follow these steps to print a file. 
  112.  
  113. o Select the File menu and choose the Print command. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 8. PageSetup ΓòÉΓòÉΓòÉ
  117.  
  118. You use the Page Setup command to format the page layout used when a file is 
  119. printed.  Such formats include. 
  120.  
  121.  1. Paper margins. 
  122.  
  123.  2. Maximum paper margins. 
  124.  
  125.  3. Header and footer text. 
  126.  
  127. Follow these steps to select the page setup for a file. 
  128.  
  129. o Select the File menu and choose the Page Setup command. 
  130.  
  131.  
  132. ΓòÉΓòÉΓòÉ 9. PrintSetup ΓòÉΓòÉΓòÉ
  133.  
  134. You use the Print Setup command to set options that control how a file is 
  135. printed.  Such options include. 
  136.  
  137.  1. Specifying which pages to print. 
  138.  
  139.  2. Number of copies to print. 
  140.  
  141. Follow these steps to select print options for a file. 
  142.  
  143. o Select the File menu and choose the Print Setup command. 
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 10. Exit ΓòÉΓòÉΓòÉ
  147.  
  148. You quit the Sample application by using the Exit command. To quit the Sample 
  149. application, do the following. 
  150.  
  151. o Select the File menu and choose the Exit command. 
  152.  
  153.  
  154. ΓòÉΓòÉΓòÉ 11. Edit Menu ΓòÉΓòÉΓòÉ
  155.  
  156. Selections under the Edit menu allow for manipulation of text displayed in the 
  157. main edit window.  Functions are provided to access the clipboard, undo the 
  158. last edit and cut/move blocks of text. 
  159.  
  160. Warning: Changes may be lost. If there have been any modifications to the 
  161. script displayed in the edit window, they must be saved before playback. 
  162.  
  163.  
  164. ΓòÉΓòÉΓòÉ 12. Undo ΓòÉΓòÉΓòÉ
  165.  
  166.  Undo will cancel the last change made in the edit window. 
  167.  
  168. Warning: Changes may be lost. If there have been any modifications to the 
  169. script displayed in the edit window, they must be saved before playback. 
  170.  
  171.  
  172. ΓòÉΓòÉΓòÉ 13. Cut ΓòÉΓòÉΓòÉ
  173.  
  174.  Use Cut to remove the marked area to the clipboard.  Text in the marked region 
  175. is removed from the file. 
  176.  
  177. Warning: Changes may be lost. If there have been any modifications to the 
  178. script displayed in the edit window, they must be saved before playback. 
  179.  
  180. Related functions 
  181.  
  182. o Copy 
  183. o Paste 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 14. Copy ΓòÉΓòÉΓòÉ
  187.  
  188.  Use Copy to copy the marked region of text to the clipboard. Text is not 
  189. deleted from the marked region. 
  190.  
  191. Warning: Changes may be lost. If there have been any modifications to the 
  192. script displayed in the edit window, they must be saved before playback. 
  193.  
  194. Related functions 
  195.  
  196. o Cut 
  197. o Paste 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 15. Paste ΓòÉΓòÉΓòÉ
  201.  
  202.  Use Paste to insert text from the clipboard into the current file after the 
  203. cursor position.  Text from the clipboard is processed as a stream of 
  204. characters, possibly containing embedded line breaks, rather than a series of 
  205. lines. 
  206.  
  207. Warning: Changes may be lost. If there have been any modifications to the 
  208. script displayed in the edit window, they must be saved before playback. 
  209.  
  210. Related functions 
  211.  
  212. o Cut 
  213. o Copy 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 16. Clear ΓòÉΓòÉΓòÉ
  217.  
  218.  Use Clear to delete the marked region from the edit window. Data in the mark 
  219. region is not moved to the clipboard. Use of Undo prior to any further changes 
  220. will recover from an erroneous clear operation. 
  221.  
  222. Warning: Changes may be lost. If there have been any modifications to the 
  223. script displayed in the edit window, they must be saved before playback. 
  224.  
  225.  
  226. ΓòÉΓòÉΓòÉ 17. Select all ΓòÉΓòÉΓòÉ
  227.  
  228.  Use Select all to mark the entire MLE in the edit window. 
  229.  
  230.  After using Select all, one may use any of the following edit controls on the 
  231. marked region 
  232.  
  233. o Copy 
  234. o Cut 
  235. o Paste 
  236.  
  237.  
  238. ΓòÉΓòÉΓòÉ 18. Mark ΓòÉΓòÉΓòÉ
  239.  
  240. A region of text is marked by placing the mouse pointer at the start of the 
  241. desired region, then press and hold the left mouse button.  Drag the mouse 
  242. pointer to the end of the desired region, while continuing to hold the left 
  243. mouse button down.  Release the left mouse button when the region has been 
  244. highlighted. 
  245.  
  246.  
  247. ΓòÉΓòÉΓòÉ 19. Help Menu ΓòÉΓòÉΓòÉ
  248.  
  249. Use the Help menu for assistance on PMATE, or the online help facility.  The 
  250. following commands appear in the Help menu. 
  251.  
  252. Help index     Index to PMATE help 
  253.  
  254. General help   PMATE overview 
  255.  
  256. Using help     Help for the online help system 
  257.  
  258. Keys help      Available keys within PMATE 
  259.  
  260. Reference      On-Line reference manual 
  261.  
  262. Product Information Displays PMATE version information 
  263.  
  264.  
  265. ΓòÉΓòÉΓòÉ 20. Using help ΓòÉΓòÉΓòÉ
  266.  
  267.  Use the Using help for assistance using the online help system. 
  268.  
  269.  
  270. ΓòÉΓòÉΓòÉ 21. General help ΓòÉΓòÉΓòÉ
  271.  
  272. Use General help for a overview of PMATE this is sometimes called the extended 
  273. help. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ 22. Keys help ΓòÉΓòÉΓòÉ
  277.  
  278. Key definitions - 
  279.  
  280. Key            Description 
  281. Alt + Bkspc    Undo the last edit operation. 
  282. Shift + Del    Remove the marked region to the clipboard. 
  283. Ctrl + Ins     Make a duplicate of the marked region in the clipboard. 
  284. Shift + Ins    Add data from the clipboard after the cursor. 
  285. Del            Remove the marked region. 
  286.                Creates a marked region. of the entire MLE. 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 23. Help index ΓòÉΓòÉΓòÉ
  290.  
  291. Use Help index to display an alphabetic list of references to the help topics 
  292. of this program. 
  293.  
  294. Note -         To see the text of all index entries, maximize the Index window. 
  295.  
  296. You can select an index entry to display the help topic that is related to that 
  297. index entry. 
  298.  
  299.  
  300. ΓòÉΓòÉΓòÉ 24. Reference ΓòÉΓòÉΓòÉ
  301.  
  302. Use this menu item to bring up a view of PMATE.INF. This help file is a 
  303. comprehensive on-line manual of PMATE. 
  304.  
  305.  
  306. ΓòÉΓòÉΓòÉ 25. Product Information ΓòÉΓòÉΓòÉ
  307.  
  308. Press this choice to show a panel with pmate's copyright, its version and full 
  309. name. 
  310.  
  311.  
  312. ΓòÉΓòÉΓòÉ 26. Options Menu ΓòÉΓòÉΓòÉ
  313.  
  314. Use the Options menu to set the current font or to save / restore the CFG 
  315. profile file.  The following are the currently available PMATE options. 
  316.  
  317. Fonts          Select a font from the Font Dialog 
  318.  
  319. Settings       Select pmate settings from the Settings Dialog 
  320.  
  321. Save           Save the current profile 
  322.  
  323. Restore        Restore the profile from disk 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 27. Fonts ΓòÉΓòÉΓòÉ
  327.  
  328.  Select this option to bring up the standard Font dialog.  If this is the font 
  329. you will allways use you may select Options->Save to store this font in the 
  330. PMATE.CFG file. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 28. Settings ΓòÉΓòÉΓòÉ
  334.  
  335.  Select this option to bring up the settings dialog.  If these are the settings 
  336. you will allways use you may select Options->Save to store these settings in 
  337. the PMATE.CFG file. 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 29. Save ΓòÉΓòÉΓòÉ
  341.  
  342. This menu option saves the current PMATE.CFG profile information.  Which 
  343. currently includes font, settings information, PMATE window position, and PMATE 
  344. window size. 
  345.  
  346. After you have saved the CFG file you may re-read the profile by selecting the 
  347. menu item Options->Restore. 
  348.  
  349.  
  350. ΓòÉΓòÉΓòÉ 30. Restore ΓòÉΓòÉΓòÉ
  351.  
  352. This menu option restores the saved PMATE.CFG profile which was stored in the 
  353. PMATE.CFG file. 
  354.  
  355. See the menu item Options->Save for more information. 
  356.  
  357.  
  358. ΓòÉΓòÉΓòÉ 31. Actions Menu ΓòÉΓòÉΓòÉ
  359.  
  360. Use the Actions menu to begin recording or playing back a PMATE script file. 
  361. The following are the currently available PMATE actions. 
  362.  
  363. Record                Record a script file 
  364.  
  365. Playback              Playback a script file 
  366.  
  367. Playback segment(s)   Playback a script file using selected segments from the 
  368.                       script. 
  369.  
  370.  
  371. ΓòÉΓòÉΓòÉ 32. Record ΓòÉΓòÉΓòÉ
  372.  
  373. After you have a script file open you may begin a recording session. If you do 
  374. not have a script file name in the PMATE titlebar, PMATE will automatically 
  375. record to the file "UNTITLED".  If you have done this you can perform a Save As 
  376. or obviously copy the file from the prompt. 
  377.  
  378. For a detailed description of how the record / playback mechanism works and 
  379. what new features have been added see all of the following, PMATE_RD.ME, 
  380. PMATE.DOC, PMATE.INF (Help->Reference). 
  381.  
  382.  
  383. ΓòÉΓòÉΓòÉ 33. Playback ΓòÉΓòÉΓòÉ
  384.  
  385. After you have a script file open you may begin a playback session. You must 
  386. have a script file name in the PMATE titlebar. 
  387.  
  388. Note you may playback the script in automatic mode as well as interactive mode. 
  389. Also you can define a log file to store the results of the script. To see a 
  390. full list of PMATE command line options type PMATE /H from the command line. 
  391.  
  392. For a detailed description of how the record / playback mechanism works and 
  393. what new features have been added see all of the following, PMATE_RD.ME, 
  394. PMATE.DOC, PMATE.INF (Help->Reference). 
  395.  
  396.  
  397. ΓòÉΓòÉΓòÉ 34. Playback segment(s) ΓòÉΓòÉΓòÉ
  398.  
  399. After you have a script file open you may begin a playback session. You must 
  400. have a script file name in the PMATE titlebar. 
  401.  
  402. If you have used Segments during record, PMATE will record a Segment_Label in 
  403. the script.  When this is done the user has the option to execute specific 
  404. segments of a script during playback. 
  405.  
  406. PMATE returns the number of errors which have occured during playback.  A user 
  407. can use this return value, together with segmented playback, to provide logical 
  408. constructs in REXX, Batch, C etc. 
  409.  
  410. Note you may playback the script in automatic mode as well as interactive mode. 
  411. Also you can define a log file to store the results of the script. To see a 
  412. full list of PMATE command line options type PMATE /H from the command line. 
  413.  
  414. For a detailed description of how the record / playback mechanism works and 
  415. what new features have been added see all of the following, PMATE_RD.ME, 
  416. PMATE.DOC, PMATE.INF (Help->Reference). 
  417.  
  418.  
  419. ΓòÉΓòÉΓòÉ 35. About Box Dialog ΓòÉΓòÉΓòÉ
  420.  
  421. This dialog displays product information, such as version number and copyright 
  422. notice. 
  423.  
  424.  
  425. ΓòÉΓòÉΓòÉ 36. Ok ΓòÉΓòÉΓòÉ
  426.  
  427. The Ok button closes the Product information dialog box. 
  428.  
  429.  
  430. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  431.  
  432. A shared, temporary storage area for data.  Data in the clipboard is available 
  433. to other programs.  Only one set of data may exist in the clipboard at any 
  434. time.