home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / PMASST.ZIP / PMAHELP.PMH < prev    next >
Text File  |  1991-05-07  |  75KB  |  1,770 lines
  1. {head:  2929}
  2. {index:Index:  3002:  1154}
  3. {index:Introduction:  4156:  2164}
  4. {index:Using Help:  6320:  1572}
  5. {index:Demonstration:  7892:   576}
  6. {index:-------General Topics----------:  8468:   377}
  7. {index:Contacting Utilis:  8845:   508}
  8. {indexalias:Creating Macros:Macro Create command}
  9. {index:Display:  9484:  2720}
  10. {indexalias:Desktop Arrangement:Macro Build Desktop Arrangement command}
  11. {indexalias:Editing Macro Settings:Macro Settings command}
  12. {indexalias:Editing the Macro List:Edit commands}
  13. {index:Executing Macros: 12471:   861}
  14. {indexalias:Exiting PM Assistant:File Exit command}
  15. {index:Keyboard: 13466:  4073}
  16. {indexalias:Keyboard Macros: Keyboard Input macro}
  17. {index:Merging Files: 17672:   530}
  18. {index:Mouse: 18202:   708}
  19. {indexalias:Mouse Macros: Mouse & Keyboard Input macro}
  20. {indexalias:Moving Windows: Position Window macro}
  21. {indexalias:Password Protection:Control Password command}
  22. {indexalias:Process Priorities:Control Process Priority command}
  23. {indexalias:Saving Macros:File Save command}
  24. {indexalias:Screen Saver:Control Screen Saver command}
  25. {indexalias:Speed Button:Control Speed Button command}
  26. {indexalias:Starting Programs: Start Program macro}
  27. {indexalias:Technical Support: Contacting Utilis}
  28. {index:-------Commands---------------: 19567:   291}
  29. {index:File Open command: 19858:  1395}
  30. {index:File Save command: 21253:   905}
  31. {index:File Save As command: 22158:   603}
  32. {index:File New command: 22761:   518}
  33. {index:File Print command: 23279:   532}
  34. {index:File Exit command: 23811:   682}
  35. {index:File About command: 24493:   510}
  36. {index:Edit commands: 25003:  3035}
  37. {index:Macro Settings command: 28038:  2009}
  38. {index:Macro Create command: 30047:   567}
  39. {index: Start Program macro: 30614:  2871}
  40. {index: Position Window macro: 33485:  3722}
  41. {index: Mouse & Keyboard Input macro: 37207:  3310}
  42. {index: Keyboard Input macro: 40517:  2186}
  43. {index: Customize Menu macro: 42703:  3763}
  44. {index: Compound macro: 46466:  1313}
  45. {index: Group macro: 47779:   895}
  46. {index:Macro Build Desktop Arrangement command: 48674:  1014}
  47. {index:Macro Build Start Programs Group command: 49688:  1301}
  48. {index:Macro Execute command: 50989:  1954}
  49. {index:Macro Disable command: 52943:   994}
  50. {index:Macro Disable All command: 53937:  1062}
  51. {index:Macro Options command: 54999:  4295}
  52. {index:View Expand command: 59294:   829}
  53. {index:View Expand All command: 60123:   975}
  54. {index:View Find Macro command: 61098:  1781}
  55. {index:View Find Next command: 62879:   619}
  56. {index:View Status/Help Line command: 63498:   511}
  57. {index:View Memory Stats command: 64009:   896}
  58. {index:Control Process Priority command: 64905:  2863}
  59. {index:Control Invoke commands: 67768:  1097}
  60. {index:Control Password command: 68865:  2219}
  61. {index:Control Screen Saver command: 71084:  2069}
  62. {index:Control Speed Button command: 73153:  1424}
  63. {index:Supply parameters box: 74577:   464}
  64. {comment: PM Assistant help file.  Copyright (C) 1990 Utilis Inc. }\
  65. \
  66. {sect:Index}\
  67. {bclr:bhelp}\
  68. {showindex}\
  69. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  70. Using The Index
  71. {n,pt:10,fclr:fhelp,col:60}\
  72. Select a help topic from the list box with the up and down arrow keys
  73. or by clicking on the topic.  To display the topic in the help window
  74. type
  75. {font:sys,pt:12,fclr:fstd}Enter{font:helv,pt:10,fclr:fhelp}
  76. or double click on the topic name.
  77.  
  78. {n}{n}The Index is broken into three sections:
  79. {n,col:40}1.{col:70,lmgn:70}Introductory Topics.  This section contains the Index,
  80. Introduction, and Using Help (this topic) topics.
  81. {n,col:40}2.{col:70}General Topics.  This section contains general topics
  82. listed in alphabetical order.
  83. {n,col:40}3.{col:70}Commands.  This section lists the commands in the order
  84. they are arranged in PM Assistant's menus.
  85.  
  86. {n,lmgn:20}{n}A topic may be referred to by more than one index entry.
  87.  
  88. {n}{n}You can dismiss the index window by choosing
  89. {font:sys,pt:12,fclr:fstd}Close{font:helv,pt:10,fclr:fhelp}
  90. from it's system menu or typing
  91. {font:sys,pt:12,fclr:fstd}Esc{font:helv,pt:10,fclr:fhelp}.
  92.  
  93. {comment: --------------- Introduction --------------------------------}
  94.  
  95. {sect:Introduction}\
  96. {bclr:bhelp}\
  97. {lmgn:20,rmgn:20,font:helv,pt:14}Introducing:{n}
  98. {pt:24,fclr:fstd,col:100,font:TmsRmn}PM Assistant
  99. {n,pt:10,font:Helv,fclr:fhelp,col:60}\
  100. PM Assistant is an OS/2 Presentation Manager automation and
  101. customization utility.  With it you can automate repetitive tasks and
  102. customize how you work with OS/2 Presentation Manager.
  103.  
  104. {n}{n}You use PM Assistant by creating, editing and running
  105. macros.  There are seven types of macros, each of which performs
  106. a different Presentation Manager task:
  107.  
  108. {wrap:off,pt:10,lmgn:70}
  109. {n,col:40}1.{col:70,fclr:fstd}Start Program {fclr:fhelp}macro
  110. {n,col:40}2.{col:70,fclr:fstd}Position Window {fclr:fhelp}macro
  111. {n,col:40}3.{col:70,fclr:fstd}Mouse & Keyboard Input {fclr:fhelp}macro
  112. {n,col:40}4.{col:70,fclr:fstd}Keyboard Input {fclr:fhelp}macro
  113. {n,col:40}5.{col:70,fclr:fstd}Compound Macro {fclr:fhelp}macro
  114. {n,col:40}6.{col:70,fclr:fstd}Group Macro {fclr:fhelp}macro
  115. {n,col:40}7.{col:70,fclr:fstd}Customize Menu {fclr:fhelp}macro
  116. {n,wrap:on,pt:10,lmgn:20}
  117.  
  118. {n}Macros can be assigned Hot-keys.  Whenever the hot-key is typed the
  119. associated macro is executed.  Hot-keys are recognized
  120. when Presentation Manager is in the foreground, or when any full-screen
  121. started by PM Assistant is in the foreground.
  122.  
  123. {n}{n}With PM Assistant you can set, view, and change the OS/2 process
  124. priority of any program started with PM Assistant.
  125.  
  126. {n}{n}PM Assistant also comes with Screen Saver and Password Protection
  127. features.  Screen Saver will blank the screen after a certain period
  128. of inactivity to prevent image burn-in on you monitor.  Password
  129. Protection can be configured to require a password after a certain period
  130. of inactivity.  Having such a password will prevent unauthorized access to
  131. your computer & data.
  132.  
  133. {n}{n}An automated demonstration of PM Assistant can be run by executing
  134. the demo.cmd file which is installed with the PM Assistant program files
  135. (usually put in c:\\pmasst).  The demonstration serves as a good introduction
  136. to creating and manipulating PM Assistant macros.
  137.  
  138.  
  139. {comment:-------------------------- Using help --------------------------}
  140. {sect:Using Help}\
  141. {bclr:bhelp}\
  142. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  143. Using Help
  144. {n,pt:10,fclr:fhelp,col:60}\
  145. The PM Assistant help system displays information about the
  146. PM Assistant program.
  147.  
  148. {n}{n}You can choose a topic to be displayed from
  149. the Help Index. Use the
  150. {font:sys,pt:12,fclr:fstd}Index{font:helv,pt:10,fclr:fhelp}
  151. menu command at the top of this help window to display the index.
  152.  
  153. {n}{n}The Index is broken into three sections:
  154. {n,col:40}1.{col:70,lmgn:70}Introductory Topics.  This section contains the Index,
  155. Introduction, Using Help (this topic) and Demonstration topics.
  156. {n,col:40}2.{col:70}General Topics.  This section contains general topics
  157. listed in alphabetical order.
  158. {n,col:40}3.{col:70}Commands.  This section lists the commands in the order
  159. they are arranged in PM Assistant's menus.
  160.  
  161. {n,lmgn:20}{n}You can browse the help topics by choosing the
  162. {font:sys,pt:12,fclr:fstd}Next{font:helv,pt:10,fclr:fhelp} and
  163. {font:sys,pt:12,fclr:fstd}Prev{font:helv,pt:10,fclr:fhelp} menu commands
  164. at the top of this help window.
  165.  
  166. {n}{n}If you
  167. choose the
  168. {font:sys,pt:12,fclr:fstd}help{font:helv,pt:10,fclr:fhelp} button
  169. in a PM Assistant dialog box, the topic associated
  170. with that dialog box will be displayed directly.
  171.  
  172. {n}{n}Type
  173. {font:sys,pt:12,fclr:fstd}Esc{font:helv,pt:10,fclr:fhelp} or choose the
  174. {font:sys,pt:12,fclr:fstd}Exit{font:helv,pt:10,fclr:fhelp}
  175. menu command at the top of this help window to exit this help window.
  176.  
  177.  
  178. {comment:-------------------------- Demonstration --------------------------}
  179. {sect:Demonstration}\
  180. {bclr:bhelp}\
  181. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  182. Demonstration
  183. {n,pt:10,fclr:fhelp,col:60}\
  184. PM Assistant comes with an automated demonstration which shows how to use
  185. PM Assistant.
  186.  
  187. {n}{n}You can start the demonstration by exiting PM Assistant and executing
  188. {font:sys,pt:12,fclr:fstd}demo.cmd{font:helv,pt:10,fclr:fhelp}
  189. from the directory where you installed PM Assistant (usually
  190. {font:sys,pt:12,fclr:fstd}C:\\PMASST{font:helv,pt:10,fclr:fhelp}).
  191.  
  192.  
  193. {comment: --------------- General Topics ------------------------------------}
  194. {sect:-------General Topics----------}\
  195. {bclr:bhelp}\
  196. {showindex}\
  197. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  198. General Topics
  199. {n,pt:10,fclr:fhelp,col:60}\
  200. This section of the index contains help on general topics listed in
  201. alphabetical order.  Choose a topic to view from the index.
  202.  
  203.  
  204. {comment:-------------------------- Contacting Utilis ------------------------}
  205. {sect:Contacting Utilis}\
  206. {bclr:bhelp}\
  207. {lmgn:20,rmgn:20,font:TmsRmn,style:italic,pt:24,fclr:fstd}\
  208. Utilis
  209. {pt:12,style:normal}Advanced Tools Now
  210. {n,pt:12,font:Helv}P.O. Box 15905
  211. {n}Seattle, Washington  98115-0905
  212.  
  213. {n}{n}General inquiries and technical support:  {style:bold}(206) 467-4025
  214. {n,style:normal}Orders: {style:bold}1-800-745-7757
  215.  
  216. {n,style:normal}{n}Utilis is dedicated to providing advanced tools for advanced
  217. operating environments.  We welcome all comments and suggestions.
  218.  
  219.  
  220.  
  221. {indexalias:Creating Macros:Macro Create command}
  222.  
  223. {comment: --------------- Display ---------------------------------------}
  224.  
  225. {sect:Display}\
  226. {bclr:bhelp}\
  227. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  228. The PM Assistant Display
  229. {n,pt:10,fclr:fhelp,col:60}\
  230. There are two regions in the PM Assistant
  231. display:  the macro list display, and the Status/Help line.
  232.  
  233. The macro list display region displays the macros currently loaded in PM
  234. Assistant, one macro per line.  If no macros are currently loaded, the
  235. macro list display region displays
  236. {font:sys,pt:12,fclr:fstd}No Macros{font:helv,pt:10,fclr:fhelp}.
  237. Each macro line is divided into four fields:
  238. {n,wrap:off,font:sys,pt:12,fclr:red,col:70}\
  239. Hot-key    {fclr:fstd}Abr    Name    Comment
  240.  
  241. {n,wrap:on}{n,font:sys,pt:12,fclr:red}Hot-key    \
  242. {font:helv,pt:10,fclr:fhelp}The hot-key associated with the macro.  Typing
  243. the hot-key executes the macro.
  244.  
  245. {n}{n,font:sys,pt:12,fclr:fstd}Abr    \
  246. {font:helv,pt:10,fclr:fhelp}An abbreviation for the macro type.  The
  247. abbreviations are:
  248. {n,font:sys,pt:12,fclr:fstd,lmgn:50}SP {font:helv,pt:10,col:120}\
  249. Start Program {fclr:fhelp}macro
  250.  
  251. {n,font:sys,pt:12,fclr:fstd}PW {font:helv,pt:10,col:120}\
  252. Position Window {fclr:fhelp}macro
  253.  
  254. {n,font:sys,pt:12,fclr:fstd}MK {font:helv,pt:10,col:120}\
  255. Mouse & Keyboard Input {fclr:fhelp}macro
  256.  
  257. {n,font:sys,pt:12,fclr:fstd}CO {font:helv,pt:10,col:120}\
  258. Compound {fclr:fhelp}macro
  259.  
  260. {n,font:sys,pt:12,fclr:fstd}GR {font:helv,pt:10,col:120}\
  261. Group {fclr:fhelp}macro
  262.  
  263. {n,font:sys,pt:12,fclr:fstd}CM {font:helv,pt:10,col:120}\
  264. Customize Menu {fclr:fhelp}macro
  265.  
  266. {n}{n,font:sys,pt:12,fclr:fstd,lmgn:20}Name    \
  267. {font:helv,pt:10,fclr:fhelp}The macro's name.
  268.  
  269. {n}{n,font:sys,pt:12,fclr:fstd}Comment    \
  270. {font:helv,pt:10,fclr:fhelp}The macro's comment.
  271.  
  272. {n}{n}The hot-key and name field widths can be set with the
  273. {font:sys,pt:12,fclr:fstd}Macro Options{font:helv,pt:10,fclr:fhelp}
  274. command.
  275.  
  276. {n}{n}Macros in the body of {fclr:fstd}Compound{fclr:fhelp} or
  277. {fclr:fstd}Group{fclr:fhelp} macros are indented and delineated by
  278. lines.  The display of macros within the body of a
  279. {fclr:fstd}Compound{fclr:fhelp} or {fclr:fstd}Group{fclr:fhelp} macro
  280. can be expanded or collapsed with the
  281. {font:sys,pt:12,fclr:fstd}View Expand{font:helv,pt:10,fclr:fhelp}
  282. command or by clicking
  283. on the {fclr:fstd}(+){fclr:fhelp} or {fclr:fstd}(-){fclr:fhelp}
  284. symbol displayed in front of the macro's name.
  285.  
  286. {n}{n}The Help/Status line usually displays PM Assistant's status.  When
  287. executing a macro or reading a file, the Help/Status line reports that.
  288. When PM Assistant is idle the Status/Help line displays
  289. {font:sys,pt:12,fclr:fstd}Ready{font:helv,pt:10,fclr:fhelp}.
  290.  
  291. {n}{n}While traversing PM Assistant's menus, the Help/Status line displays
  292. description of the selected menu command.
  293.  
  294. {indexalias:Desktop Arrangement:Macro Build Desktop Arrangement command}
  295. {indexalias:Editing Macro Settings:Macro Settings command}
  296. {indexalias:Editing the Macro List:Edit commands}
  297.  
  298.  
  299. {comment: --------------- Executing Macros --------------------------------}
  300. {sect:Executing Macros}\
  301. {bclr:bhelp}\
  302. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  303. Executing Macros
  304. {n,pt:10,fclr:fhelp,col:60}\
  305. There are four ways to execute a macro:
  306. {n,lmgn:70}
  307. {n,col:40}1.{col:70}Type the hot-key associated with the macro.
  308. {n,col:40}2.{col:70}Double-click on the macro in the PM Assistant macro list
  309. display.
  310. {n,col:40}3.{col:70}Select the macro in the PM Assistant macro list by
  311. scrolling through the macro list with the up and down arrow keys.
  312. Then type
  313. {font:sys,pt:12,fclr:fstd}Enter{font:helv,pt:10,fclr:fhelp}
  314. to execute the selected macro.
  315. {n,col:40}4.{col:70}Select the macro as in 3. and choose the
  316. {font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
  317. menu command.  This will activate a dialog box which gives more control
  318. over executing the macro.  See the Macro Execute command help topic.
  319.  
  320. {indexalias:Exiting PM Assistant:File Exit command}
  321.  
  322.  
  323. {comment: --------------- Keyboard ---------------------------------------}
  324. {sect:Keyboard}\
  325. {bclr:bhelp}\
  326. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  327. Keyboard
  328. {n,pt:10,fclr:fhelp,col:60}\
  329. Menu command accelerator keys are displayed in the Status/Help
  330. line when a menu command is selected.
  331.  
  332. {n}{n}PM Assistant recognizes the following keystrokes:
  333.  
  334. {lmgn:20,n}{n,font:sys,pt:12,fclr:fstd}F1
  335. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Help
  336. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Enter
  337. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Execute the selected macro.
  338.  
  339. {lmgn:20,n}{n,font:sys,pt:12,fclr:fstd}PgUp
  340. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll the macro list back one page.
  341. {lmgn:20,n,font:sys,pt:12,fclr:fstd}PgDn
  342. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll the macro list forward one page.
  343. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Home
  344. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the beginning of the macro list.
  345. {lmgn:20,n,font:sys,pt:12,fclr:fstd}End
  346. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the end of the macro list.
  347. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Up
  348. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Move the macro selection up one macro.
  349. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Down
  350. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Move the macro selection down one macro.
  351. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Left
  352. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Select the first displayed macro.
  353. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Right
  354. {col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the selected macro.
  355.  
  356. {n}
  357. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Shft+Del
  358. {col:130,lmgn:130}Edit Cut{font:helv,pt:10,fclr:fhelp} command
  359. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Shft+Ins
  360. {col:130,lmgn:130}Edit Paste{font:helv,pt:10,fclr:fhelp} command
  361. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+Ins
  362. {col:130,lmgn:130}Edit Insert{font:helv,pt:10,fclr:fhelp} command
  363. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Del
  364. {col:130,lmgn:130}Edit Delete{font:helv,pt:10,fclr:fhelp} command
  365. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Alt+Bksp
  366. {col:130,lmgn:130}Edit Undo{font:helv,pt:10,fclr:fhelp} command
  367.  
  368. {n}{lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+o
  369. {col:110,lmgn:110}File Open{font:helv,pt:10,fclr:fhelp} command
  370. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+s
  371. {col:110,lmgn:110}File Save{font:helv,pt:10,fclr:fhelp} command
  372. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+e
  373. {col:110,lmgn:110}Macro Settings{font:helv,pt:10,fclr:fhelp} command
  374. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+u
  375. {col:110,lmgn:110}Macro Build Desktop Arrangement{font:helv,pt:10,fclr:fhelp} command
  376. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+d
  377. {col:110,lmgn:110}Macro Disable{font:helv,pt:10,fclr:fhelp} command
  378. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+i
  379. {col:110,lmgn:110}Macro Disable All{font:helv,pt:10,fclr:fhelp} command
  380. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+t
  381. {col:110,lmgn:110}Macro Options{font:helv,pt:10,fclr:fhelp} command
  382. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+x
  383. {col:110,lmgn:110}View Expand{font:helv,pt:10,fclr:fhelp} command
  384. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+a
  385. {col:110,lmgn:110}View Expand All{font:helv,pt:10,fclr:fhelp} command
  386. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+f
  387. {col:110,lmgn:110}View Find Macro{font:helv,pt:10,fclr:fhelp} command
  388. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+n
  389. {col:110,lmgn:110}View Find Next{font:helv,pt:10,fclr:fhelp} command
  390. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+y
  391. {col:110,lmgn:110}Control Process Priority{font:helv,pt:10,fclr:fhelp} command
  392. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+b
  393. {col:110,lmgn:110}Control Invoke Both{font:helv,pt:10,fclr:fhelp} command
  394. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+r
  395. {col:110,lmgn:110}Control Invoke Screen Saver{font:helv,pt:10,fclr:fhelp} command
  396. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+p
  397. {col:110,lmgn:110}Control Invoke Password Protection{font:helv,pt:10,fclr:fhelp} command
  398. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+w
  399. {col:110,lmgn:110}Control Password{font:helv,pt:10,fclr:fhelp} command
  400. {lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+v
  401. {col:110,lmgn:110}Control Screen Saver{font:helv,pt:10,fclr:fhelp} command
  402.  
  403.  
  404. {indexalias:Keyboard Macros: Keyboard Input macro}
  405.  
  406.  
  407. {comment: --------------- Merging Files ----------------------------------}
  408. {sect:Merging Files}\
  409. {bclr:bhelp}\
  410. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  411. Merging Files
  412. {n,pt:10,fclr:fhelp,col:60}\
  413. To merge macro files, choose the
  414. {font:sys,pt:12,fclr:fstd}File Open{font:helv,pt:10,fclr:fhelp}
  415. menu command and click the
  416. {fclr:fstd,font:sys,pt:12}Insert{fclr:fhelp,font:helv,pt:10}
  417. radio button.  The macros from the chosen file will be inserted into
  418. the current macro list, thus effectively merging the files.
  419.  
  420.  
  421. {comment: --------------- Mouse ------------------------------------------}
  422. {sect:Mouse}\
  423. {bclr:bhelp}\
  424. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  425. Mouse
  426. {n,pt:10,fclr:fhelp,col:60}\
  427. PM Assistant recognizes the following mouse actions:
  428.  
  429. {n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Left button
  430. {n,lmgn:70,font:helv,pt:10,fclr:fhelp}Selects the macro under the
  431. mouse pointer.
  432.  
  433. {n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Double-click Left button
  434. {n,lmgn:70,font:helv,pt:10,fclr:fhelp}Executes the macro under the
  435. mouse pointer.
  436.  
  437. {n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Right button
  438. {n,lmgn:70,font:helv,pt:10,fclr:fhelp}Macro Settings command applied to
  439. the macro under the mouse pointer.
  440.  
  441.  
  442. {comment:----------------- Some Index Aliases ----------------------------}
  443.  
  444. {indexalias:Mouse Macros: Mouse & Keyboard Input macro}
  445. {indexalias:Moving Windows: Position Window macro}
  446. {indexalias:Password Protection:Control Password command}
  447. {indexalias:Process Priorities:Control Process Priority command}
  448. {indexalias:Saving Macros:File Save command}
  449. {indexalias:Screen Saver:Control Screen Saver command}
  450. {indexalias:Speed Button:Control Speed Button command}
  451.  
  452.  
  453. {comment:----------------- Some Index Aliases ----------------------------}
  454. {indexalias:Starting Programs: Start Program macro}
  455. {indexalias:Technical Support: Contacting Utilis}
  456.  
  457.  
  458.  
  459. {comment: --------------- Commands ------------------------------------}
  460. {sect:-------Commands---------------}\
  461. {bclr:bhelp}\
  462. {showindex}\
  463. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  464. Commands
  465. {n,pt:10,fclr:fhelp,col:60}\
  466. Choose the command to view help about from the index.
  467.  
  468.  
  469. {comment:-------------------------- File Open ----------------------------}
  470. {sect:File Open command}\
  471. {bclr:bhelp}\
  472. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  473. File Open command
  474. {n,pt:10,fclr:fhelp,col:60}\
  475. The
  476. {font:sys,pt:12,fclr:fstd}File Open{font:helv,pt:10,fclr:fhelp}
  477. command loads macro from a file.
  478.  
  479. {n}{n}Enter the filename into the topmost
  480. {font:sys,pt:12}Filename:{font:helv,pt:10} edit box,
  481. or chose a filename using the {font:sys,pt:12}Directories:{font:helv,pt:10}
  482. and {font:sys,pt:12}Files:{font:helv,pt:10} list boxes.
  483.  
  484. {n}{n}Checking the
  485. {fclr:fstd,font:sys,pt:12}Replace{fclr:fhelp,font:helv,pt:10}
  486. radio button causes the current
  487. list of macros to be replaced by the new list of macros.
  488.  
  489. {n}{n}Checking the
  490. {fclr:fstd,font:sys,pt:12}Insert{fclr:fhelp,font:helv,pt:10}
  491. radio button causes the new
  492. list of macros to be inserted into the current list of macros just after
  493. the currently selected macro.  This effectively merges the two lists of macros.
  494.  
  495. {n}{n}Checking the
  496. {fclr:fstd,font:sys,pt:12}File is read only{fclr:fhelp,font:helv,pt:10}
  497. check box disables
  498. the File Save menu command preventing you from accidentally modifying the
  499. file.
  500.  
  501. {n}{n}Double clicking on a filename in the
  502. {font:sys,pt:12}Files:{font:helv,pt:10}
  503. list box or clicking the {font:sys,pt:12}Load{font:helv,pt:10}
  504. button causes the indicated file to be loaded.
  505.  
  506.  
  507. {comment:-------------------------- File Save ----------------------------}
  508. {sect:File Save command}\
  509. {bclr:bhelp}\
  510. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  511. File Save command
  512. {n,pt:10,fclr:fhelp,col:60}\
  513. The 
  514. {font:sys,pt:12,fclr:fstd}File Save{font:helv,pt:10,fclr:fhelp}
  515. command saves the macro list to the current file.
  516. The filename of the current file is displayed in the
  517. {font:sys,pt:12,fclr:fstd}File Save 'filename'{font:helv,pt:10,fclr:fhelp}
  518. menu item.  If there is no current file you will be prompted for a filename.
  519.  
  520. {n}{n}If you have made changes to the current list of macros and exit
  521. PM Assistant, PM Assistant will ask if you'd like to save the changes before
  522. exiting.
  523.  
  524. {n}{n}When you choose the 
  525. {font:sys,pt:12,fclr:fstd}File{font:helv,pt:10,fclr:fhelp}
  526. menu command, the Help/Status
  527. line displays whether or not the current macro list has been modified.
  528.  
  529.  
  530. {comment:-------------------------- File Save As ----------------------------}
  531. {sect:File Save As command}\
  532. {bclr:bhelp}\
  533. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  534. File Save As command
  535. {n,pt:10,fclr:fhelp,col:60}\
  536. The
  537. {font:sys,pt:12,fclr:fstd}File Save As{font:helv,pt:10,fclr:fhelp}
  538. command saves the macro list to a specified file.  The
  539. default extension for a file containing PM Assistant macros is .pma.
  540.  
  541. {n}{n}Enter the filename into the
  542. {font:sys,pt:12}Filename:{font:helv,pt:10} edit box.
  543.  
  544. {n}{n}If the entered file exists, you will be asked to confirm
  545. overwriting that file.
  546.  
  547.  
  548. {comment:-------------------------- File New ----------------------------}
  549. {sect:File New command}\
  550. {bclr:bhelp}\
  551. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  552. File New command
  553. {n,pt:10,fclr:fhelp,col:60}\
  554. The
  555. {font:sys,pt:12,fclr:fstd}File New{font:helv,pt:10,fclr:fhelp}
  556. command discards the current list of macros in
  557. preparation for creating new macros.
  558.  
  559. {n}{n}If the current list of macros has not been saved to a file
  560. you will be asked whether you first want to save the current list of macros.
  561.  
  562.  
  563. {comment:-------------------------- File Print ----------------------------}
  564. {sect:File Print command}\
  565. {bclr:bhelp}\
  566. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  567. File Print command
  568. {n,pt:10,fclr:fhelp,col:60}\
  569. The
  570. {font:sys,pt:12,fclr:fstd}File Print{font:helv,pt:10,fclr:fhelp}
  571. command prints a textual listing of the macros to
  572. a file.
  573.  
  574. {n}{n}Enter the filename into the
  575. {font:sys,pt:12}Filename:{font:helv,pt:10} edit box.
  576.  
  577. {n}{n}If the entered file exists, you will be asked to confirm
  578. overwriting that file.
  579.  
  580.  
  581. {comment:-------------------------- File Exit ----------------------------}
  582. {sect:File Exit command}\
  583. {bclr:bhelp}\
  584. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  585. File Exit command
  586. {n,pt:10,fclr:fhelp,col:60}\
  587. The
  588. {font:sys,pt:12,fclr:fstd}File Exit{font:helv,pt:10,fclr:fhelp}
  589. command exits PM Assistant.
  590.  
  591. {n}{n}If programs you have started with PM Assistant are still running,
  592. you will be asked if you want to terminate those programs.  You cannot
  593. exit PM Assistant and leave programs started by PM Assistant running.
  594.  
  595. {n}{n}If the current list of macros has not been saved to a file
  596. you will be asked whether you first want to save the current list of macros.
  597.  
  598.  
  599. {comment:-------------------------- File About ----------------------------}
  600. {sect:File About command}\
  601. {bclr:bhelp}\
  602. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  603. File About command
  604. {n,pt:10,fclr:fhelp,col:60}\
  605. The
  606. {font:sys,pt:12,fclr:fstd}File About{font:helv,pt:10,fclr:fhelp}
  607. command displays information about PM Assistant
  608. including the version number.
  609.  
  610. {n}{n}While the{font:sys,pt:12} About {font:helv,pt:10}dialog
  611. box is displayed the PM Assistant logo is displayed in the main window.
  612.  
  613.  
  614.  
  615. {comment:-------------------------- Edit commands -----------------------}
  616. {sect:Edit commands}\
  617. {bclr:bhelp}\
  618. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  619. Edit commands
  620. {n,pt:10,fclr:fhelp,col:60}\
  621. The
  622. {fclr:fstd}Edit{fclr:fhelp}
  623. commands let you edit the macro list - rearranging, duplicating, or
  624. discarding macros.  Macros are moved to and from the macro clipboard.  The
  625. name of the macro on the macro clipboard appears at the bottom of the
  626. {fclr:fstd}Edit{fclr:fhelp}
  627. menu.
  628.  
  629. {n}{n}When macros are inserted from the clipboard they are inserted
  630. {style:italic}after  {style:normal}the currently selected macro.  If the
  631. currently selected macro is a
  632. {fclr:fstd}Compound{fclr:fhelp} or
  633. {fclr:fstd}Group{fclr:fhelp} macro, macros are inserted
  634. {style:italic}into  {style:normal}the body if the
  635. {fclr:fstd}Compound{fclr:fhelp} or
  636. {fclr:fstd}Group{fclr:fhelp} macro's body is expanded (see the View
  637. Expand command).
  638.  
  639. {n}{n}When a {fclr:fstd}Compound{fclr:fhelp} or
  640. {fclr:fstd}Group{fclr:fhelp} macros is moved with the
  641. {fclr:fstd}Edit{fclr:fhelp}
  642. commands, the macro and the macros comprising it's body are moved as one.
  643.  
  644. {n}{n}The macro clipboard is not the same as the PM clipboard and
  645. macros cannot be cut or pasted to other PM programs.
  646.  
  647. {n}{n,font:helv,pt:14,fclr:fstd}
  648. Edit Cut command
  649. {n,pt:10,fclr:fhelp,col:80}
  650. The
  651. {font:sys,pt:12,fclr:fstd}Edit Cut{font:helv,pt:10,fclr:fhelp}
  652. command cuts the currently selected macro from the macro list
  653. and places it on the macro clipboard.  If the macro clipboard already
  654. contains a macro, you will asked if you wish to discard that macro.
  655.  
  656. {n}{n,font:helv,pt:14,fclr:fstd}
  657. Edit Paste command
  658. {n,pt:10,fclr:fhelp,col:80}
  659. The
  660. {font:sys,pt:12,fclr:fstd}Edit Paste{font:helv,pt:10,fclr:fhelp}
  661. command pastes the macro from the macro clipboard into the
  662. macro list.
  663.  
  664. {n}{n,font:helv,pt:14,fclr:fstd}
  665. Edit Copy command
  666. {n,pt:10,fclr:fhelp,col:80}
  667. The
  668. {font:sys,pt:12,fclr:fstd}Edit Copy{font:helv,pt:10,fclr:fhelp}
  669. command copies the currently selected macro from the macro list
  670. and places it on the macro clipboard.  Since macro names should generally
  671. be kept unique, the name of the copy on the clipboard is "incremented" - a
  672. 2 is added to the end, or if the macro ends in a number that number is
  673. incremented.
  674.  
  675. {n}{n,font:helv,pt:14,fclr:fstd}
  676. Edit Delete command
  677. {n,pt:10,fclr:fhelp,col:80}
  678. The
  679. {font:sys,pt:12,fclr:fstd}Edit Delete{font:helv,pt:10,fclr:fhelp}
  680. command deletes the currently selected macro from the macro
  681. list.  The deleted macro can be recovered with the
  682. {font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
  683. command.
  684.  
  685. {n}{n,font:helv,pt:14,fclr:fstd}
  686. Edit Undo command
  687. {n,pt:10,fclr:fhelp,col:80}
  688. The
  689. {font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
  690. command undoes that last edit operation.  You can undo only
  691. one edit operation - choosing the 
  692. {font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
  693. command a second time redoes the original edit operation.
  694.  
  695.  
  696. {comment:-------------------------- Macro Settings--------------------------}
  697. {sect:Macro Settings command}\
  698. {bclr:bhelp}\
  699. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  700. Macro Settings command
  701. {n,pt:10,fclr:fhelp,col:60}\
  702. The
  703. {font:sys,pt:12,fclr:fstd}Macro Settings{font:helv,pt:10,fclr:fhelp}
  704. command allows you to edit the settings associated with
  705. the currently selected macro.  You can also edit a macro's settings by
  706. clicking the right mouse button on it in the macro list display.
  707.  
  708. {n}{n}All types of macros have the following settings:
  709.  
  710. {n}{n,font:sys,pt:12}Name: {font:helv,pt:10,col:140}The name of the macro.
  711.  
  712. {n}{n,font:sys,pt:12}Comment: {font:helv,pt:10,col:140}A comment describing
  713. the macro.
  714.  
  715. {n}{n,font:sys,pt:12}Hot-key: {font:helv,pt:10,col:140}The Hot-key associated
  716. with the macro.  This is a key sequence, which, when typed from anywhere in
  717. OS/2 invokes the macro.  Type the key sequence as you would when using the
  718. hot-key.  For example, to enter the F5 key as a hot-key, hit the F5 key
  719. itself -- you need not spell out 'F' '5'.  While entering a hot-key typing a
  720. backspace is the same as clicking the
  721. {font:sys,pt:12,fclr:fstd}Clear hot-key {font:helv,pt:10,fclr:fhelp}button,
  722. it clears the entire hot-key sequence.  Hot-keys can be any number of
  723. keystrokes long.
  724.  
  725. {n}{n}These settings are displayed for each macro in the macro list window.
  726. Each type of macro, except for
  727. {fclr:fstd}Compound{fclr:fhelp} or
  728. {fclr:fstd}Group{fclr:fhelp} macros,
  729. has additional settings specific to that type of macro.
  730. To view or change these additional settings click the
  731. {font:sys,pt:12,fclr:fstd}Settings... {font:helv,pt:10,fclr:fhelp}button.
  732.  
  733. {n}{n}To accept the settings and return to the main PM Assistant window click
  734. the
  735. {font:sys,pt:12,fclr:fstd}Done {font:helv,pt:10,fclr:fhelp}button.
  736.  
  737. {n}{n}To preserve the original settings and return to the main PM
  738. Assistant window click the
  739. {font:sys,pt:12,fclr:fstd}Cancel {font:helv,pt:10,fclr:fhelp}button.
  740.  
  741.  
  742. {comment:-------------------------- Macro Create --------------------------}
  743. {sect:Macro Create command}\
  744. {bclr:bhelp}\
  745. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  746. Macro Create command
  747. {n,pt:10,fclr:fhelp,col:60}\
  748. The
  749. {font:sys,pt:12,fclr:fstd}Macro Create{font:helv,pt:10,fclr:fhelp}
  750. command creates a new macro (see also Macro Build for another way
  751. to create macros).
  752.  
  753. {n}{n}A submenu will appear with the
  754. seven types of macros you can create.
  755.  
  756. {n}{n}The new macro will be inserted into the macro list just after the
  757. currently selected macro.
  758.  
  759.  
  760. {comment:-------------------------- Start Program macro --------------------}
  761. {sect: Start Program macro}\
  762. {bclr:bhelp}\
  763. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  764. Start Program macro
  765. {n,pt:10,fclr:fhelp,col:60}\
  766. A {fclr:fstd}Start Program{fclr:fhelp} type of macro starts a program
  767. similarly to the Start Programs application.
  768. A {fclr:fstd}Start Program{fclr:fhelp} macro has the following settings:
  769.  
  770. {n}{n,font:sys,pt:12}Command line:   {font:helv,pt:10}\
  771. The command line for the program to start.
  772.  
  773. {n}{n,font:sys,pt:12}Initial directory:   {font:helv,pt:10}\
  774. The directory in which the program is to be started.  This would
  775. typically be a directory containing the program's data files.
  776.  
  777. {n}{n,font:sys,pt:12}Program run method   {font:helv,pt:10}\
  778. After the command line is entered and the focus advanced to another field
  779. (i.e. hit tab) a default
  780. program run method is selected based on
  781. the program specified.  You can choose the run method if the program is
  782. character based and can run in a window under PM or a full screen, or if
  783. PM Assistant cannot determine a default run method.
  784. The program run methods are:
  785.  
  786. {n,font:sys,pt:12,col:40,fclr:fstd}Program is a PM program.    \
  787. {font:helv,pt:10,fclr:fhelp,lmgn:60}\
  788. Program is a windowing Presentation Manager program such as
  789. PM Assistant.
  790.  
  791. {n,font:sys,pt:12,col:40,fclr:fstd}Run program in a PM text window.    \
  792. {font:helv,pt:10,fclr:fhelp}\
  793. Program is a character based OS/2 program and is to run in a text window
  794. (A text window looks like an OS/2 windowed command prompt).
  795.  
  796. {n,font:sys,pt:12,col:40,fclr:fstd}Run program in a full-screen.    \
  797. {font:helv,pt:10,fclr:fhelp}\
  798. Program is a character based OS/2 program and is to run in a full-screen
  799. (A full screen looks like an OS/2 full-screen command prompt).
  800.  
  801. {font:sys,pt:12,n,lmgn:20}{n}Initial process priority    \
  802. {font:helv,pt:10}If
  803. {font:sys,pt:12,fclr:fstd}Set initial process priority:
  804. {font:helv,pt:10,fclr:fhelp}is checked, PM Assistant sets the programs OS/2
  805. process priority to the given value each time the program is started.  See
  806. the help screen for the Control Process Priority command for a discussion of
  807. OS/2 process priorities. (????)
  808.  
  809. {font:sys,pt:12,n}{n}Macro specifying initial position:    \
  810. {font:helv,pt:10}Can contain the name of a
  811. {fclr:fstd}Position Window{fclr:fhelp} type of macro which
  812. gives the position the program is to be started in.
  813.  
  814. {font:sys,pt:12,fclr:fstd,n}{n}Wait for program to end before continuing:    \
  815. {font:helv,pt:10,fclr:fhelp}If checked causes PM Assistant to suspend macro
  816. execution until the program ends.  Useful when the macro is a part of a
  817. compound macro.
  818.  
  819. {n}{n}See also the Macro Build Start Programs Group command help topic
  820. for how to import program information directly from the
  821. Presentation Manager Start Programs application.
  822.  
  823.  
  824. {comment:-------------------------- Position Window macro -------------------}
  825. {sect: Position Window macro}\
  826. {bclr:bhelp}\
  827. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  828. Position Window macro
  829. {n,pt:10,fclr:fhelp,col:60}\
  830. A {fclr:fstd}Position Window{fclr:fhelp} type of macro can move, re-size,
  831. minimize, maximize, or bring to the foreground any program.
  832.  
  833. {n}{n}Before
  834. creating a {fclr:fstd}Position Window{fclr:fhelp} macro the program to
  835. position should be running and in the desired position.  You indicate the
  836. program to position by clicking the
  837. {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
  838. button, then point and click on the program to position.
  839.  
  840. {n}{n}A {fclr:fstd}Position Window{fclr:fhelp} macro has the following
  841. settings:
  842.  
  843. {font:sys,pt:12,fclr:fstd,n}{n}Size window:    \
  844. {font:helv,pt:10,fclr:fhelp}If checked the macro
  845. re-sizes the indicated program to the indicated size.
  846.  
  847. {font:sys,pt:12,fclr:fstd,n}{n}Move window:    \
  848. {font:helv,pt:10,fclr:fhelp}If checked the macro
  849. moves the indicated program to the indicated position.
  850.  
  851. {font:sys,pt:12,fclr:fstd,n}{n}Give window the input focus:    \
  852. {font:helv,pt:10,fclr:fhelp}\
  853. If checked the macro gives the indicated program the input focus (brings
  854. it to the foreground).
  855.  
  856. {font:sys,pt:12,fclr:fstd,n}{n}Restore window:    \
  857. {font:helv,pt:10,fclr:fhelp}\
  858. If checked the macro restores the indicated program from a maximized or
  859. minimized state.
  860.  
  861. {font:sys,pt:12,fclr:fstd,n}{n}Minimize window:    \
  862. {font:helv,pt:10,fclr:fhelp}\
  863. If checked the macro minimizes the indicated program.
  864.  
  865. {font:sys,pt:12,fclr:fstd,n}{n}Maximize window:    \
  866. {font:helv,pt:10,fclr:fhelp}\
  867. If checked the macro maximizes the indicated program.
  868.  
  869. {font:sys,pt:12,n}{n}If window does not exist    \
  870. {font:helv,pt:10}These settings control what PM Assistant does if the
  871. indicated program to position does not exist when the macro is executed.
  872.  
  873. {n,font:sys,pt:12,col:40,fclr:fstd}First wait . . . seconds    \
  874. {font:helv,pt:10,fclr:fhelp,lmgn:60}If checked PM Assistant waits the
  875. specified number of seconds for the program window to appear.  This is
  876. useful when a {fclr:fstd}Start Program{fclr:fhelp} macro refers to this
  877. macro and the started program takes a while to draw it's window.
  878.  
  879. {n,font:sys,pt:12,col:40,fclr:fstd}Start program with macro:    \
  880. {font:helv,pt:10,fclr:fhelp}PM Assistant executes the named macro.  The
  881. named macro should then start the program.
  882.  
  883. {n,font:sys,pt:12,col:40,fclr:fstd}Give a warning.    \
  884. {font:helv,pt:10,fclr:fhelp}PM Assistant displays a message box explaining
  885. that the indicated window does not exist.
  886.  
  887. {n,font:sys,pt:12,col:40,fclr:fstd}Continue without warning.    \
  888. {font:helv,pt:10,fclr:fhelp}PM Assistant continues without taking any
  889. action.
  890.  
  891. {font:sys,pt:12,n,lmgn:20}{n}Window to position:    \
  892. {font:helv,pt:10}These settings control which window the macro positions.
  893.  
  894. {n,font:sys,pt:12,col:40,fclr:fstd}Indicated window:    \
  895. {font:helv,pt:10,fclr:fhelp,lmgn:60}The macro positions the window pointed
  896. to when the {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
  897. button procedure is followed.
  898.  
  899. {n,font:sys,pt:12,col:40,fclr:fstd}Foreground window:    \
  900. {font:helv,pt:10,fclr:fhelp}The macro positions whatever window is in the
  901. foreground at the time the macro is run.
  902.  
  903. {n,lmgn:20}{n}You can indicate a full-screen by pointing to the
  904. icon representing the full-screen.  This way you can create a macro
  905. which brings a full-screen to the foreground.
  906.  
  907. {n}{n}See also the Macro Build Desktop Arrangement command for how to
  908. build a set of {fclr:fstd}Position Window{fclr:fhelp} macros corresponding
  909. to all current window positions.
  910.  
  911.  
  912. {comment:-------------------------- Mouse & Keyboard Input macro -----------}
  913. {sect: Mouse & Keyboard Input macro}\
  914. {bclr:bhelp}\
  915. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  916. Mouse & Keyboard Input macro
  917. {n,pt:10,fclr:fhelp,col:60}\
  918. A {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} type of macro
  919. records mouse movements and keyboard input which is then played back when
  920. the macro is executed.  Beware that for the mouse movements to have the
  921. same effect when played back the windows on the PM desktop must be
  922. arranged in the same positions they were when the macro was recorded.  For
  923. this reason {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macros are
  924. often combined with {fclr:fstd}Position Window{fclr:fhelp} macros in a
  925. {fclr:fstd}Compound{fclr:fhelp} macro.  See information on the Macro
  926. Build Desktop Arrangement command for how to easily build a
  927. {fclr:fstd}Compound{fclr:fhelp} macro which arranges the entire PM desktop.
  928.  
  929. {n}{n}A {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro has the
  930. following settings:
  931.  
  932. {font:sys,pt:12,n}{n}Playback rate:    \
  933. {font:helv,pt:10}This edit box gives a numerical measure of how
  934. fast to play back the macro.  A value of
  935. {font:sys,pt:12,fclr:fstd}1{font:helv,pt:10,fclr:fhelp} plays
  936. it back at the same speed it was recorded, a value of
  937. {font:sys,pt:12,fclr:fstd}3{font:helv,pt:10,fclr:fhelp}
  938. plays it back at 3 times the speed it was
  939. recorded.  You can enter any floating point number or use the scroll bar to
  940. quickly set the value.  A value of
  941. {font:sys,pt:12,fclr:fstd}Max{font:helv,pt:10,fclr:fhelp} as set
  942. with the scroll bar replays the macro at the maximum speed the computer can
  943. attain.
  944.  
  945. {font:sys,pt:12,fclr:fstd,n}{n}Discard button-up mouse movements    \
  946. {font:helv,pt:10,fclr:fhelp}If checked the usually-unnecessary button-up
  947. mouse movements
  948. are not recorded as part of the macro.  This saves memory and makes the
  949. {font:sys,pt:12,fclr:fstd}Max{font:helv,pt:10,fclr:fhelp}
  950. playback rate faster, but the mouse
  951. pointer will jump about (from button-click to button-click) when the macro
  952. is executed.
  953.  
  954. {font:sys,pt:12,fclr:fstd,n}{n}Confirm window receiving button clicks    \
  955. {font:helv,pt:10,fclr:fhelp}If checked PM Assistant checks that the correct window
  956. is under the mouse pointer for each button click when the macro is executed.
  957. This prevents "runaway" macros when something goes wrong during the playback.
  958.  
  959. {n}{n}Push the {font:sys,pt:12,fclr:fstd}Record{font:helv,pt:10,fclr:fhelp}
  960. button to begin recording the mouse & keyboard Input.  A dialogue box titled
  961. {font:sys,pt:12,fclr:fstd}Recording  'macroname'{font:helv,pt:10,fclr:fhelp}
  962. will appear at the lower left of the screen.  To stop recording click the
  963. {font:sys,pt:12,fclr:fstd}Stop{font:helv,pt:10,fclr:fhelp} button in that
  964. dialog box or type Ctrl+C.  You can insert pauses into the recording by
  965. clicking on the
  966. {font:sys,pt:12,fclr:fstd}Pause{font:helv,pt:10,fclr:fhelp} button in that
  967. dialog box.  Such pauses can allow the user to take a particular action
  968. when appropriate.  A prompt which is displayed during the pause can be entered
  969. into the edit field of that dialog box.  After such a pause click the
  970. {font:sys,pt:12,fclr:fstd}Resume{font:helv,pt:10,fclr:fhelp} button to
  971. resume recording the mouse & keyboard Input.
  972.  
  973.  
  974. {comment:-------------------------- Keyboard Input macro --------------------}
  975. {sect: Keyboard Input macro}\
  976. {bclr:bhelp}\
  977. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  978. Keyboard Input macro
  979. {n,pt:10,fclr:fhelp,col:60}\
  980. A {fclr:fstd}Keyboard Input{fclr:fhelp} type of macro can record keystrokes
  981. and play them back to any PM program window or any full-screen.
  982. {n}{n}A {fclr:fstd}Keyboard Input{fclr:fhelp} macro has the
  983. following settings:
  984.  
  985. {font:sys,pt:12,n}{n}Keystrokes:    \
  986. {font:helv,pt:10}Enter the keystrokes to be played in this edit field.
  987. This edit field behaves similarly to the
  988. {font:sys,pt:12}Hot-key:{font:helv,pt:10} edit field of the Macro Information
  989. dialog box in that it displays a textual representation for every keystroke,
  990. even those which are non-printing keystrokes such as control-key combinations
  991. or a space.
  992.  
  993. {n}{n}While entering the keystrokes typing a
  994. backspace is the same as clicking the
  995. {font:sys,pt:12,fclr:fstd} Clear keystrokes {font:helv,pt:10,fclr:fhelp}button,
  996. it clears the entire Keystrokes sequence.  See the Control Options command
  997. help screen for information on how to record keystrokes containing a backspace.
  998.  
  999. {font:sys,pt:12,n}{n}Play keystrokes to:    \
  1000. {font:helv,pt:10}These settings allow you to specify the window which receives
  1001. the keystrokes.
  1002. {n,font:sys,pt:12,col:40,fclr:fstd}Indicated window:    \
  1003. {font:helv,pt:10,fclr:fhelp,lmgn:60}The macro plays the keystrokes to
  1004. the window pointed
  1005. to when the {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
  1006. button procedure is followed.
  1007. The {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
  1008. button procedure is identical to that used to indicate a window for a
  1009. {fclr:fstd}Position Window{fclr:fhelp} type of macro.
  1010.  
  1011. {n,font:sys,pt:12,col:40,fclr:fstd}Foreground window:    \
  1012. {font:helv,pt:10,fclr:fhelp}The macro plays the keystrokes to whatever window
  1013. is in the foreground at the time the macro is run.
  1014.  
  1015. {n,lmgn:20}{n}You can indicate a full-screen by pointing to the
  1016. icon representing the full-screen.  This way you can create a macro
  1017. to play keystrokes to an OS/2 character oriented program running in a
  1018. full-screen.
  1019.  
  1020.  
  1021. {comment:-------------------------- Customize Menu macro --------------------}
  1022. {sect: Customize Menu macro}\
  1023. {bclr:bhelp}\
  1024. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1025. Customize Menu macro
  1026. {n,pt:10,fclr:fhelp,col:60}\
  1027. A {fclr:fstd}Customize Menu{fclr:fhelp} type of macro can customize any PM
  1028. program's menus.  You can rearrange, change the text, or change the
  1029. accelerator keys of any menu commands.
  1030.  
  1031. {n}{n,pt:12,fclr:fstd,style:bold}\
  1032. Choose Menu Item Procedure
  1033. {n,pt:10,fclr:fhelp,style:normall,col:60}\
  1034. When creating a
  1035. {fclr:fstd}Customize Menu{fclr:fhelp} macro, you must choose a menu item
  1036. for the macro to operate on.  The choose menu item procedure consists of:
  1037. {n}1.{lmgn:50,col:50}Push the {fclr:fstd,font:sys}Choose{fclr:fhelp,font:helv}
  1038. button.  This will minimize PM Assistant and present you with the Choose Menu
  1039. Item dialog box.
  1040. {n,col:20}2.{col:50}Choose a menu command from any program just as if you were
  1041. going to execute it.  The menu command will {style:bold}not{style:normal} be
  1042. executed.  PM Assistant will return with the
  1043. {font:sys}Chosen menu:{font:helv} field filled in with
  1044. the name of the menu item you choose.
  1045.  
  1046. {lmgn:20,n}{n,pt:12,fclr:fstd,style:bold}\
  1047. Rearranging Menu Items
  1048. {n,pt:10,fclr:fhelp,style:normal,col:60}\
  1049. Rearranging menu items requires more than one
  1050. {fclr:fstd}CM{fclr:fhelp} macro and makes use of the Menu clipboard.
  1051. For example, to move a menu item from a sub-menu to the menu bar requires two
  1052. {fclr:fstd}CM{fclr:fhelp} macros.
  1053.  
  1054. {n}{n}The first {fclr:fstd}CM{fclr:fhelp} macro cuts the menu item from the
  1055. sub-menu and places it on the Menu clipboard.  When creating this macro
  1056. Choose the menu item to be moved using the Choose Menu Item procedure (see
  1057. above), and select the {font:sys,fclr:fstd}Cut menu item to menu clipboard
  1058. {font:helv,fclr:fhelp}option in the Customize Menu dialog box.
  1059.  
  1060. {n}{n}The second {fclr:fstd}CM{fclr:fhelp} macro pastes the menu item from the
  1061. Menu clipboard onto the menu bar.  For this macro
  1062. Choose the menu item to paste the menu item {style:italic} after {style:normal}
  1063. using the Choose Menu Item procedure (see
  1064. above).  Select the {font:sys,fclr:fstd}Paste menu item from menu clipboard
  1065. {font:helv,fclr:fhelp}option in the Customize Menu dialog box.  Note: To
  1066. choose a sub-menu rather than a menu item, display the sub-menu by clicking on
  1067. it, then dismiss the sub-menu with the
  1068. {fclr:fstd,font:sys}Esc{fclr:fhelp,font:helv} key and click
  1069. {fclr:fstd,font:sys}OK{fclr:fhelp,font:helv} in the Choose Menu Item
  1070. dialog box.
  1071.  
  1072. {n}{n,pt:12,fclr:fstd,style:bold}\
  1073. Changing A Menu Item's Text
  1074. {n,pt:10,fclr:fhelp,style:normal,col:60}\
  1075. Choose the menu item to change
  1076. using the Choose Menu Item procedure (see
  1077. above).  Select the {font:sys,fclr:fstd}Set menu text\
  1078. {font:helv,fclr:fhelp} option in the Customize Menu dialog box.
  1079. Type the new text into the edit box.  Putting a tilde
  1080. ({font:sys,fclr:fstd} ~ {font:helv,fclr:fhelp}) in the text turns
  1081. the letter following the tilde into an underlined direct-access letter.
  1082.  
  1083. {n}{n,pt:12,fclr:fstd,style:bold}\
  1084. Changing A Menu Item's Accelerator Key
  1085. {n,pt:10,fclr:fhelp,style:normal,col:60}\
  1086. You can give a menu item an accelerator key to make executing the menu command
  1087. more convenient.
  1088. Choose the menu item to change
  1089. using the Choose Menu Item procedure (see
  1090. above).  Select the {font:sys,fclr:fstd}Set accelerator key\
  1091. {font:helv,fclr:fhelp} option in the Customize Menu dialog box.
  1092. Enter the accelerator key into the edit box.  Enter the accelerator key just
  1093. as you would when invoking the menu command.  For example, to enter the
  1094. {font:sys,fclr:fstd}F3{font:helv,fclr:fhelp} key type the
  1095. {font:sys,fclr:fstd}F3{font:helv,fclr:fhelp} key rather than typing an 'F'
  1096. and a '3'.
  1097.  
  1098.  
  1099. {comment:-------------------------- Compound macro --------------------}
  1100. {sect: Compound macro}\
  1101. {bclr:bhelp}\
  1102. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1103. Compound macro
  1104. {n,pt:10,fclr:fhelp,col:60}\
  1105. A {fclr:fstd}Compound{fclr:fhelp} type of macro is used to combine several
  1106. macros.  When the {fclr:fstd}Compound{fclr:fhelp}
  1107. macro is executed the contained macros are
  1108. executed sequentially.
  1109.  
  1110. {n}{n}A {fclr:fstd}Compound{fclr:fhelp} macro is displayed
  1111. in the macro list display area with it's body (the macros it combines)
  1112. indented and delineated by lines.  You can expand and contract the display
  1113. of a {fclr:fstd}Compound{fclr:fhelp} macro's body - see the View Expand
  1114. command.
  1115.  
  1116. {n}{n}To insert macros into the body of a
  1117. {fclr:fstd}Compound{fclr:fhelp} macro, select the
  1118. {fclr:fstd}Compound{fclr:fhelp} macro, expand it's body, then create a
  1119. macro or insert one from the clipboard with the Edit Insert command.  If
  1120. a {fclr:fstd}Compound{fclr:fhelp} macro's body is contracted, then macros
  1121. will be inserted {style:italic}after  {style:normal}the
  1122. {fclr:fstd}Compound{fclr:fhelp} macro.
  1123.  
  1124. {n}{n}To abort the execution of a
  1125. {fclr:fstd}Compound{fclr:fhelp} macro, type Ctrl+C.
  1126.  
  1127. {n}{n}A {fclr:fstd}Compound{fclr:fhelp} macro has no settings besides
  1128. the initial Macro Information settings.
  1129.  
  1130.  
  1131. {comment:-------------------------- Group macro --------------------}
  1132. {sect: Group macro}\
  1133. {bclr:bhelp}\
  1134. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1135. Group macro
  1136. {n,pt:10,fclr:fhelp,col:60}\
  1137. A {fclr:fstd}Group{fclr:fhelp} type of macro behaves the same as a
  1138. {fclr:fstd}Compound{fclr:fhelp} macro except that they cannot be executed.
  1139. {fclr:fstd}Group{fclr:fhelp} macros are used to gather similar macros
  1140. that are not intended to be executed sequentially as one.
  1141.  
  1142. {n}{n}Gathering similar macros into a
  1143. {fclr:fstd}Group{fclr:fhelp} macro eases viewing of macros because the
  1144. {fclr:fstd}Group{fclr:fhelp} macro's body is visually isolated, and
  1145. the body can be expanded and contracted - see the View Expand command.
  1146.  
  1147. {n}{n}Editing of the macro list is
  1148. made easier because the entire group of macros can be cut/paste in one
  1149. operation - see the Edit commands help topic.
  1150.  
  1151.  
  1152. {comment:-------------- Macro Build Desktop Arrangement command--------------}
  1153. {sect:Macro Build Desktop Arrangement command}\
  1154. {bclr:bhelp}\
  1155. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1156. Macro Build Desktop Arrangement command
  1157. {n,pt:10,fclr:fhelp,col:60}\
  1158. The
  1159. {font:sys,pt:12,fclr:fstd}Macro Build Desktop Arrangement{font:helv,pt:10,fclr:fhelp}
  1160. command builds a {fclr:fstd}Compound{fclr:fhelp} macro made up of
  1161. {fclr:fstd}Position Window{fclr:fhelp}
  1162. macros.  A {fclr:fstd}Position Window{fclr:fhelp} macro is created to
  1163. move each window on the desktop to it's current location.
  1164.  
  1165. {n}{n}In this way you can save the current desktop arrangement and
  1166. restore it later by executing the built macro.
  1167.  
  1168. {n}{n}After choosing the
  1169. {font:sys,pt:12,fclr:fstd}Macro Build Desktop Arrangement{font:helv,pt:10,fclr:fhelp}
  1170. command, you enter the settings for the
  1171. {fclr:fstd}Compound{fclr:fhelp} macro to build.
  1172. After you've entered the settings the
  1173. {fclr:fstd}Position Window{fclr:fhelp} macros are built.
  1174.  
  1175.  
  1176. {comment:----------- Macro Build Start Programs Group command -------------}
  1177.  
  1178. {sect:Macro Build Start Programs Group command}\
  1179. {bclr:bhelp}\
  1180. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1181. Macro Build Start Programs Group
  1182. {n,pt:10,fclr:fhelp,col:60}\
  1183. The
  1184. {font:sys,pt:12,fclr:fstd}Macro Build Start Programs Group{font:helv,pt:10,fclr:fhelp}
  1185. command builds a {fclr:fstd}Group{fclr:fhelp} macro made up of
  1186. {fclr:fstd}Start Program{fclr:fhelp}
  1187. macros.  You select which Start Programs Application's group
  1188. you wish to base the macros on.
  1189. A {fclr:fstd}Start Program{fclr:fhelp} macro is created for each entry
  1190. in that Start Programs Application group.
  1191.  
  1192. {n}{n}In this way you can import program information directly from the
  1193. Start Programs application  (this is the application which is provided
  1194. with Presentation Manager and started automatically when you run PM).
  1195.  
  1196. {n}{n}After choosing the
  1197. {font:sys,pt:12,fclr:fstd}Macro Build Start Programs Group{font:helv,pt:10,fclr:fhelp}
  1198. command you select which Start Programs Application's group to import the
  1199. program information from.  After making the selection you
  1200. enter the settings for the
  1201. {fclr:fstd}Group{fclr:fhelp} macro to build.
  1202. After you've entered the settings the
  1203. {fclr:fstd}Start Programs{fclr:fhelp} macros are built.
  1204.  
  1205.  
  1206. {comment:-------------------------- Macro Execute command -------------------}
  1207. {sect:Macro Execute command}\
  1208. {bclr:bhelp}\
  1209. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1210. Macro Execute command
  1211. {n,pt:10,fclr:fhelp,col:60}\
  1212. The
  1213. {font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
  1214. command executes the currently selected macro in special
  1215. ways.  The following settings control how the macro is executed:
  1216.  
  1217. {n}{font:sys,pt:12,fclr:fstd,n}Execute once    \
  1218. {font:helv,pt:10,fclr:fhelp}Executes the macro once.
  1219.  
  1220. {n}{font:sys,pt:12,fclr:fstd,n}Execute ... times    \
  1221. {font:helv,pt:10,fclr:fhelp}Executes the macro the given number of times.
  1222. Enter the number of times into the edit field.  You can abort the macro
  1223. while it is executing by typing Ctrl+C.
  1224.  
  1225. {n}{font:sys,pt:12,fclr:fstd,n}Execute indefinitely    \
  1226. {font:helv,pt:10,fclr:fhelp}Executes the macro repeatedly until you
  1227. abort the macro by typing Ctrl+C.
  1228.  
  1229. {n}{n}{font:sys,pt:12,fclr:fstd}Execute Compound macro in random order    \
  1230. {font:helv,pt:10,fclr:fhelp}If the currently selected macro is a
  1231. {fclr:fstd}Compound{fclr:fhelp} macro this setting causes the macros
  1232. comprising it's body to be executed in random order rather than sequential
  1233. order.  This is useful for setting up automated demonstrations to run at a
  1234. trade convention, or for running automated software tests in random order.
  1235.  
  1236. {n}{font:sys,pt:12,fclr:fstd,n}Block all input during execution    \
  1237. {font:helv,pt:10,fclr:fhelp}Blocks all user mouse and keyboard input
  1238. during the execution of the macro.  This is useful for setting up
  1239. unattended demonstrations.  Using this setting prevents observers from
  1240. breaking the demonstration by typing randomly on the keyboard (which
  1241. observers are prone to do during unattended demonstrations).  Typing
  1242. Ctrl+C will still abort the macro.
  1243.  
  1244. {n}{n}Click the {font:sys,pt:12,fclr:fstd}Execute{font:helv,pt:10,fclr:fhelp}
  1245. button to execute the macro.
  1246.  
  1247.  
  1248. {comment:-------------------------- Macro Disable command -------------------}
  1249. {sect:Macro Disable command}\
  1250. {bclr:bhelp}\
  1251. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1252. Macro Disable command
  1253. {n,pt:10,fclr:fhelp,col:60}\
  1254. The
  1255. {font:sys,pt:12,fclr:fstd}Macro Disable{font:helv,pt:10,fclr:fhelp}
  1256. command disables the hot-key of the currently
  1257. selected macro.  Disabling a macro's hot-key prevents PM Assistant from
  1258. executing the macro when the hot-key is typed.
  1259.  
  1260. {n}{n}The hot-key of a macro who's hot-key is disabled is blue in the PM
  1261. Assistant macro list display.
  1262.  
  1263. {n}{n}You can still execute a
  1264. macro who's hot-key is disabled with the
  1265. {font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
  1266. command, by double-clicking on it in the
  1267. PM Assistant macro list display, or selecting the macro and hitting the
  1268. enter key.
  1269.  
  1270. {n}{n}Choosing the
  1271. {font:sys,pt:12,fclr:fstd}Macro Disable{font:helv,pt:10,fclr:fhelp}
  1272. command again re-enables the selected macro's hot-key.
  1273.  
  1274.  
  1275. {comment:-------------------------- Macro Disable All command -------------}
  1276. {sect:Macro Disable All command}\
  1277. {bclr:bhelp}\
  1278. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1279. Macro Disable All command
  1280. {n,pt:10,fclr:fhelp,col:60}\
  1281. The
  1282. {font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
  1283. command disables the hot-keys of all macros.
  1284. Disabling all hot-keys prevents PM Assistant from executing any macros
  1285. when a hot-key is typed.  A check mark appears next to the
  1286. {font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
  1287. menu item.
  1288.  
  1289. {n}{n}All hot-keys are blue in the macro list display to indicate they are
  1290. disabled.
  1291.  
  1292. {n}{n}You can still execute a
  1293. macro who's hot-key is disabled by double-clicking on the macro name in the
  1294. PM Assistant macro list display.
  1295.  
  1296. {n}{n}Choosing the
  1297. {font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
  1298. command again re-enables the hot-keys.
  1299. The check mark next to the
  1300. {font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
  1301. menu item is removed.
  1302.  
  1303. {comment:------------------------ Macro Options command ---------------}
  1304. {sect:Macro Options command}\
  1305. {bclr:bhelp}\
  1306. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1307. Macro Options command
  1308. {n,pt:10,fclr:fhelp,col:60}\
  1309. The
  1310. {font:sys,pt:12,fclr:fstd}Macro Options{font:helv,pt:10,fclr:fhelp}
  1311. command lets you change the way PM Assistant behaves
  1312. in various ways.  The Macro Options dialog box has the following settings:
  1313.  
  1314. {n}{n,font:sys,pt:12}Display field widths:    \
  1315. {font:helv,pt:10}These settings control the widths of display fields in the
  1316. macro display area.  If a macro name is longer than it's column width the
  1317. display of the name is truncated.  If you typically use long names and
  1318. want the whole name displayed, you can widen the display field width here.
  1319. The widths are measured in units of characters.
  1320.  
  1321. {n,font:sys,pt:12,col:40}Hot-key field:    \
  1322. {font:helv,pt:10,lmgn:60}The display field width of the Hot-key field.
  1323.  
  1324. {n,font:sys,pt:12,col:40}Macro name field:    \
  1325. {font:helv,pt:10,lmgn:60}The display field width of the macro name field.
  1326.  
  1327.  
  1328. {n}{lmgn:20,n,font:sys,pt:12}Keystroke treatment while entering hot-keys:    \
  1329. {font:helv,pt:10}When entering hot-keys into the Macro Information hot-key
  1330. edit field (see Macro Settings command) three keystrokes are treated specially
  1331. and cannot normally be entered as hot-keys.  When set, these check-boxes
  1332. override the keystrokes special meaning and allows them to be entered.
  1333. The same applies to entering keystrokes for a
  1334. {fclr:fstd}Keyboard Input{fclr:fhelp} macro.
  1335.  
  1336. {n,font:sys,pt:12,col:40,fclr:fstd}Tab key    \
  1337. {font:helv,pt:10,fclr:fhelp,lmgn:60}Normally advances the input focus to the next
  1338. dialog box control.
  1339.  
  1340. {n,font:sys,pt:12,col:40,fclr:fstd}Shift+Tab key    \
  1341. {font:helv,pt:10,fclr:fhelp}Normally advances the input focus to the
  1342. previous dialog box control.
  1343.  
  1344. {n,font:sys,pt:12,col:40,fclr:fstd}Backspace key    \
  1345. {font:helv,pt:10,fclr:fhelp}Normally clears the edit field identically
  1346. to clicking the
  1347. {font:sys,pt:12,fclr:fstd}Clear hot-key{font:helv,pt:10,fclr:fhelp} button.
  1348.  
  1349. {n}{n,font:sys,fclr:fstd,pt:12,lmgn:20}\
  1350. Minimize PM Assistant while pointing to window    \
  1351. {font:helv,pt:10,fclr:fhelp}
  1352. When set, PM Assistant will minimize it's window when performing the
  1353. {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
  1354. procedure in creating a {fclr:fstd}Position Window{fclr:fhelp} macro.
  1355. See the Position Window macro help topic for more information.
  1356.  
  1357. {n}{n,font:sys,fclr:fstd,pt:12}\
  1358. Minimize PM Assistant while recording MK macro    \
  1359. {font:helv,pt:10,fclr:fhelp}
  1360. When set, PM Assistant will minimize it's window while recording a
  1361. {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro.
  1362.  
  1363.  
  1364. {n}{n,font:sys,pt:12}Restrict MK recording resolution to:    \
  1365. {font:helv,pt:10}These settings restrict mouse movements when recording
  1366. {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macros to the specified
  1367. resolution.  Restricting the resolution allows you to create macros
  1368. on a computer with high resolution and run them on computers with
  1369. lower resolutions.  The resolutions are:
  1370.  
  1371. {n,font:sys,pt:12,col:40,lmgn:60,fclr:fstd}640 x 480    \
  1372. {font:helv,pt:10,fclr:fhelp}Standard VGA resolution.
  1373.  
  1374. {n,font:sys,pt:12,col:40,fclr:fstd}720 x 540    \
  1375. {font:helv,pt:10,fclr:fhelp}Improved VGA resolution.
  1376.  
  1377. {n,font:sys,pt:12,col:40,fclr:fstd}800 x 600    \
  1378. {font:helv,pt:10,fclr:fhelp}Super VGA resolution.
  1379.  
  1380.  
  1381. {n}{n,lmgn:20,font:sys,pt:12}MK Recording dialog box hot-key:    \
  1382. {font:helv,pt:10}Specifies a special hot-key used to bring the
  1383. {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro Recording dialog
  1384. box to the foreground.  Hot-key access to the Recording dialog box can
  1385. be useful when recording macros to work with a maximized window which
  1386. hides the Recording dialog box.  See the
  1387. {fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro help topic for more
  1388. information.
  1389.  
  1390. {n}{n}Click the
  1391. {font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
  1392. save the new PM Assistant Options settings to the os2.ini file.  If the
  1393. new settings are not saved they will be lost when you exit PM Assistant.
  1394.  
  1395. {n}{n}Click the
  1396. {font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
  1397. accept, but not permanently save, the new settings.
  1398.  
  1399.  
  1400. {comment:-------------------------- View Expand command -------------------}
  1401. {sect:View Expand command}\
  1402. {bclr:bhelp}\
  1403. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1404. View Expand command
  1405. {n,pt:10,fclr:fhelp,col:60}\
  1406. The
  1407. {font:sys,pt:12,fclr:fstd}View Expand{font:helv,pt:10,fclr:fhelp}
  1408. command expands or collapses (toggles) the display of the
  1409. currently selected {fclr:fstd}Compound{fclr:fhelp} or
  1410. {fclr:fstd}Group{fclr:fhelp} macro's body.
  1411.  
  1412. {n}{n}You can also expand or collapse the display of a
  1413. {fclr:fstd}Compound{fclr:fhelp} or
  1414. {fclr:fstd}Group{fclr:fhelp} macro's body by clicking on the
  1415. {fclr:fstd}(+)/(-){fclr:fhelp} symbol displayed in front of the macro's name.
  1416. A {fclr:fstd}(+){fclr:fhelp} is displayed
  1417. if the macro is currently collapsed, a {fclr:fstd}(-){fclr:fhelp}
  1418. if it is currently expanded.
  1419.  
  1420.  
  1421. {comment:-------------------------- View Expand All command ----------------}
  1422. {sect:View Expand All command}\
  1423. {bclr:bhelp}\
  1424. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1425. View Expand All command
  1426. {n,pt:10,fclr:fhelp,col:60}\
  1427. The
  1428. {font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
  1429. command expands the display of all
  1430. {fclr:fstd}Compound{fclr:fhelp} and
  1431. {fclr:fstd}Group{fclr:fhelp} macros' bodies.  A check mark appears
  1432. next to the
  1433. {font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
  1434. menu item.  This command is useful if you want to quickly view all macros.
  1435.  
  1436. {n}{n}Choosing the
  1437. {font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
  1438. command again restores the display of all
  1439. {fclr:fstd}Compound{fclr:fhelp} and
  1440. {fclr:fstd}Group{fclr:fhelp} macros' bodies to their previous state.
  1441. The check mark next to the
  1442. {font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
  1443. menu item is removed.
  1444.  
  1445.  
  1446. {comment:-------------------------- View Find Macro command -----------------}
  1447. {sect:View Find Macro command}\
  1448. {bclr:bhelp}\
  1449. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1450. View Find Macro command
  1451. {n,pt:10,fclr:fhelp,col:60}\
  1452. The
  1453. {font:sys,pt:12,fclr:fstd}View Find Macro{font:helv,pt:10,fclr:fhelp}
  1454. command searches for a macro based on the strings in
  1455. the Macro Information settings.  The search dialog box requests the
  1456. following information:
  1457.  
  1458. {n}{n,font:sys,pt:12}Search string:    \
  1459. {font:helv,pt:10}Enter the string to search for.
  1460.  
  1461. {n}{n,font:sys,pt:12}Macro strings to search:    \
  1462. {font:helv,pt:10}Specifies the Macro Information string settings to search
  1463. for a matching string.  You can choose any combination of the three settings
  1464. {font:sys,pt:12,fclr:fstd}Name{font:helv,pt:10,fclr:fhelp},
  1465. {font:sys,pt:12,fclr:fstd}Comment{font:helv,pt:10,fclr:fhelp}, and
  1466. {font:sys,pt:12,fclr:fstd}Hot-key{font:helv,pt:10,fclr:fhelp}.
  1467.  
  1468. {n}{n,font:sys,pt:12}Case sensitivity:    \
  1469. {font:helv,pt:10}Specifies whether to use a
  1470. {font:sys,pt:12,fclr:fstd}Case sensitive{font:helv,pt:10,fclr:fhelp} or a
  1471. {font:sys,pt:12,fclr:fstd}Case insensitive{font:helv,pt:10,fclr:fhelp}
  1472. string match.
  1473.  
  1474. {n}{n}Strings need not match starting with the first character of the Macro
  1475. Information setting.  For example, if you have a macro named 'One Macro'
  1476. and search for the string 'Macro', the macro 'One Macro' would be found.
  1477.  
  1478. The search starts with the macro following the currently selected macro.  To
  1479. search all macros select the first macro in the macro list (type the Home
  1480. key).
  1481.  
  1482. To initiate the search click the
  1483. {font:sys,pt:12,fclr:fstd}Search{font:helv,pt:10,fclr:fhelp} button.
  1484.  
  1485. {n}{n}The Status/Help line will indicate the success or failure of the search.
  1486.  
  1487.  
  1488. {comment:-------------------------- View Find Next command -----------------}
  1489. {sect:View Find Next command}\
  1490. {bclr:bhelp}\
  1491. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1492. View Find Next command
  1493. {n,pt:10,fclr:fhelp,col:60}\
  1494. The
  1495. {font:sys,pt:12,fclr:fstd}View Find Next{font:helv,pt:10,fclr:fhelp}
  1496. command searches for a macro based on the same criteria
  1497. used in the last
  1498. {font:sys,pt:12,fclr:fstd}View Find Macro{font:helv,pt:10,fclr:fhelp}
  1499. command.  The search starts with the
  1500. macro following the currently selected macro.
  1501.  
  1502. {n}{n}The Status/Help line will indicate the success or failure of the search.
  1503.  
  1504.  
  1505. {comment:-------------------------- View Status/Help Line command -----------}
  1506. {sect:View Status/Help Line command}\
  1507. {bclr:bhelp}\
  1508. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1509. View Status/Help Line command
  1510. {n,pt:10,fclr:fhelp,col:60}\
  1511. The
  1512. {font:sys,pt:12,fclr:fstd}View Status/Help Line{font:helv,pt:10,fclr:fhelp}
  1513. command removes or restores (toggles) the
  1514. Status/Help line at the bottom of the PM Assistant display.
  1515.  
  1516. {n}{n}Removing the Status/Help line leaves more room to display the
  1517. macro list.
  1518.  
  1519.  
  1520. {comment:-------------------------- View Memory Stats command -----------}
  1521. {sect:View Memory Stats command}\
  1522. {bclr:bhelp}\
  1523. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1524. View Memory Stats command
  1525. {n,pt:10,fclr:fhelp,col:60}\
  1526. The
  1527. {font:sys,pt:12,fclr:fstd}View Memory Stats{font:helv,pt:10,fclr:fhelp}
  1528. command displays statistics about the memory requirements
  1529. of the current macro list (including any macros on the macro clipboard)
  1530. on the Status/Help line.  The statistics message reports two values:
  1531.  
  1532. {lmgn:50}
  1533. {n}{n,fclr:fstd,col:20}Macro list in memory: <number> bytes
  1534. {n,fclr:fhelp}- This portion of the message reports how many bytes of computer memory is
  1535. required to store the macro list.
  1536.  
  1537. {n}{n,fclr:fstd,col:20}in a file: <number> bytes
  1538. {n,fclr:fhelp}- This portion of the message reports how many bytes of disk space
  1539. is required to store the macro list in a file.
  1540.  
  1541.  
  1542. {comment:-------------------------- Control Process Priority command ------}
  1543. {sect:Control Process Priority command}\
  1544. {bclr:bhelp}\
  1545. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1546. Control Process Priority command
  1547. {n,pt:10,fclr:fhelp,col:60}\
  1548. The
  1549. {font:sys,pt:12,fclr:fstd}Control Process Priority{font:helv,pt:10,fclr:fhelp}
  1550. command displays and changes the OS/2
  1551. process priority of programs started with PM Assistant
  1552. (Create and execute a {fclr:fstd}Start Program{fclr:fhelp} macro to
  1553. start a program with PM Assistant).  The Process Priority Control
  1554. dialog box has the following settings:
  1555.  
  1556. {n}{n,font:sys,pt:12}Process' Task Title:    \
  1557. {font:helv,pt:10}Select the process to view/change the priority of.
  1558. The Task Titles correspond to the programs' title bars.
  1559.  
  1560. {n}{n,font:sys,pt:12}Current Process Priority:    \
  1561. {font:helv,pt:10}These settings show the current process priority of the
  1562. selected task.  When you change these settings the label changes to
  1563. "New Process Priority."  The new process priority settings do not take
  1564. effect until you press the
  1565. {font:sys,pt:12,fclr:fstd}Set Priority{font:helv,pt:10,fclr:fhelp} button.
  1566. An OS/2 process priority is made up of a Priority class and a Priority level.
  1567. The Priority Classes are:
  1568.  
  1569. {n,font:sys,pt:12,col:40,fclr:fstd}Normal    \
  1570. {font:helv,pt:10,fclr:fhelp,lmgn:60}\
  1571. Most programs fall into this class.  The program neither takes absolute
  1572. precedence nor is denied processing resources for a long time.
  1573.  
  1574. {n,font:sys,pt:12,col:40,fclr:fstd}Idle-time    \
  1575. {font:helv,pt:10,fclr:fhelp,lmgn:60}\
  1576. The program is granted processing resources only when all programs in the
  1577. other two classes are idle.  This is the lowest priority class.
  1578.  
  1579. {n,font:sys,pt:12,col:40,fclr:fstd}Time-critical    \
  1580. {font:helv,pt:10,fclr:fhelp,lmgn:60}\
  1581. The program is always granted processing resources prior to programs in
  1582. the other two classes.  This class is usually used by OS/2 processes
  1583. which require rapid response time such as Disk Drive controlling
  1584. processes.  Indiscriminant use of this class can cause improper functioning
  1585. of OS/2, so if you attempt to set a program to this class PM Assistant will
  1586. first ask you to confirm your choice.
  1587.  
  1588. {n,font:sys,pt:12,col:40}Priority level    \
  1589. {font:helv,pt:10,lmgn:60}\
  1590. The Priority level gives the process a ranking to use when allocating
  1591. processing resources to processes within the same class.  The levels range
  1592. from 0 to 31, 0 being the lowest level (runs slower).  Use the scroll bar
  1593. to set the priority level.
  1594.  
  1595. {n,lmgn:20}{n}Click the
  1596. {font:sys,pt:12,fclr:fstd}Done{font:helv,pt:10,fclr:fhelp} button
  1597. to dismiss the
  1598. Process Priority Control dialog box.  Remember that new Process
  1599. Priority settings for a process do not take effect until you click the
  1600. {font:sys,pt:12,fclr:fstd}Set Priority{font:helv,pt:10,fclr:fhelp} button.
  1601.  
  1602.  
  1603. {comment:---------------------- Control Invoke commands ----------------}
  1604. {sect:Control Invoke commands}\
  1605. {bclr:bhelp}\
  1606. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1607. Control Invoke commands
  1608. {n,pt:10,fclr:fhelp,col:60}\
  1609. The
  1610. {font:sys,pt:12,fclr:fstd}Control Invoke{font:helv,pt:10,fclr:fhelp}
  1611. commands allow you to invoke Password Protection,
  1612. Screen Saver, or both.  Choose which to invoke from the
  1613. {font:sys,pt:12,fclr:fstd}Control Invoke{font:helv,pt:10,fclr:fhelp}
  1614. submenu.
  1615.  
  1616. {n}{n}Invoking Password Protection makes your computer inaccessible until
  1617. the correct password is entered.  PM Assistant can be configured to invoke
  1618. Password Protection automatically after a period disuse.  See the Control
  1619. Password Protection command for information on setting the password and
  1620. automatic invocation features.
  1621.  
  1622. {n}{n}Invoking Screen Saver blanks your computer screen to prevent
  1623. image burn-in.  PM Assistant can be configured to invoke
  1624. Screen Saver automatically after a period disuse.  See the Control
  1625. Screen Saver command for information on setting the screen saver feature.
  1626.  
  1627.  
  1628. {comment:------------------------ Control Password command ---------------}
  1629. {sect:Control Password command}\
  1630. {bclr:bhelp}\
  1631. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1632. Control Password command
  1633. {n,pt:10,fclr:fhelp,col:60}\
  1634. The
  1635. {font:sys,pt:12,fclr:fstd}Control Password{font:helv,pt:10,fclr:fhelp}
  1636. command lets you change the settings of the Password
  1637. Protection feature.  When invoked, Password Protection makes your computer
  1638. inaccessible until the correct password is entered.
  1639. Password Protection has the following settings:
  1640.  
  1641. {n}{n,font:sys,pt:12}Automatic invocation:    \
  1642. {font:helv,pt:10}These settings control how PM Assistant automatically
  1643. invokes Password Protection after a period of disuse.
  1644.  
  1645. {n,font:sys,pt:12,col:40}Time delay:    \
  1646. {font:helv,pt:10,lmgn:60}Specifies the length of disuse before Password
  1647. Protection is automatically invoked.  Enter the hours:minutes:seconds
  1648. of the delay in the three edit fields.
  1649.  
  1650. {n,font:sys,pt:12,col:40,fclr:fstd}Enabled    \
  1651. {font:helv,pt:10,fclr:fhelp}Enables Password Protection automatic
  1652. invocation.  When enabled, a check mark appears next to the Control Password
  1653. menu command.
  1654.  
  1655. {n,font:sys,pt:12,col:40,fclr:fstd}Disabled    \
  1656. {font:helv,pt:10,fclr:fhelp}Disables Password Protection automatic
  1657. invocation.  You can still invoke Password Protection with the
  1658. {font:sys,pt:12,fclr:fstd}Control Invoke Password Protection{font:helv,pt:10,fclr:fhelp}
  1659. command.
  1660.  
  1661. {lmgn:20,n}{n}Click the
  1662. {font:sys,pt:12,fclr:fstd}Password{font:helv,pt:10,fclr:fhelp} button to
  1663. set the password.  You will be presented with the Password Entry prompt.
  1664. Type your new password then type Enter.  You will be asked to enter your
  1665. new password a second time to confirm it.  You will be warned if your second
  1666. entry does not match the first and the password will not be changed.
  1667.  
  1668. {n}{n}Click the
  1669. {font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
  1670. save the new Password Protection settings to the os2.ini file.  If the
  1671. new settings are not saved they will be lost when you exit PM Assistant.
  1672.  
  1673. {n}{n}Click the
  1674. {font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
  1675. accept, but not permanently save, the new settings.
  1676.  
  1677.  
  1678. {comment:------------------------ Control Screen Saver command ---------------}
  1679. {sect:Control Screen Saver command}\
  1680. {bclr:bhelp}\
  1681. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1682. Control Screen Saver command
  1683. {n,pt:10,fclr:fhelp,col:60}\
  1684. The
  1685. {font:sys,pt:12,fclr:fstd}Control Screen Saver{font:helv,pt:10,fclr:fhelp}
  1686. command lets you change the settings of the Screen
  1687. Saver feature.  When invoked, Screen Saver blanks the screen preventing image
  1688. burn-in.  Screen Saver has the following settings:
  1689.  
  1690. {n}{n,font:sys,pt:12}Automatic invocation:    \
  1691. {font:helv,pt:10}These settings control how PM Assistant automatically
  1692. invokes Screen Saver after a period of disuse.
  1693.  
  1694. {n,font:sys,pt:12,col:40}Time delay:    \
  1695. {font:helv,pt:10,lmgn:60}Specifies the length of disuse before Screen Saver
  1696. is automatically invoked.  Enter the hours:minutes:seconds
  1697. of the delay in the three edit fields.
  1698.  
  1699. {n,font:sys,pt:12,col:40,fclr:fstd}Enabled    \
  1700. {font:helv,pt:10,fclr:fhelp,lmgn:60}Enables Screen Saver automatic
  1701. invocation.  When enabled, a check mark appears next to the Control Screen
  1702. Saver menu command.
  1703.  
  1704. {n,font:sys,pt:12,col:40,fclr:fstd}Disabled    \
  1705. {font:helv,pt:10,fclr:fhelp,lmgn:60}Disables Screen Saver automatic
  1706. invocation.  You can still invoke Screen Saver with the
  1707. {font:sys,pt:12,fclr:fstd}Control Invoke Screen Saver{font:helv,pt:10,fclr:fhelp}
  1708. command.
  1709.  
  1710. {lmgn:20,n}{n}
  1711. {font:sys,pt:12}Text to display:    \
  1712. {font:helv,pt:10}Enter a phrase to display in this edit box.  The phase is
  1713. displayed in varying positions and colors while Screen Saver is invoked.
  1714. One phase might be "Computer is on" to remind you that although the screen
  1715. is blank, the computer is on.
  1716.  
  1717. {n}{n}Click the
  1718. {font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
  1719. save the new Screen Saver settings to the os2.ini file.  If the
  1720. new settings are not saved they will be lost when you exit PM Assistant.
  1721.  
  1722. {n}{n}Click the
  1723. {font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
  1724. accept, but not permanently save, the new settings.
  1725.  
  1726.  
  1727. {comment: --------------- Control Speed button command ----------------------}
  1728. {sect:Control Speed Button command}\
  1729. {bclr:bhelp}\
  1730. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1731. Control Speed Button command
  1732. {n,pt:10,fclr:fhelp,col:60}\
  1733. The Speed Button feature makes the right mouse
  1734. button (button #2) behave like the enter key when a dialog box is in the
  1735. foreground.
  1736.  
  1737. {n}{n}In dialog boxes the most often used button is the "default"
  1738. button (has a thicker boarder).  When you hit the enter key it clicks
  1739. the "default" button.  Usually you change the settings of a dialog box
  1740. and then dismiss the dialog box by clicking the default button.
  1741. Presentation manager provides two ways of clicking the default button:
  1742. {n,col:40}1.{col:70,lmgn:70}Move the mouse pointer above the button and
  1743. push the left mouse button.
  1744. {n,col:40}2.{col:70}Type the enter key (requiring you to move your
  1745. hand from the mouse to the keyboard).
  1746. {n,lmgn:20}The Speed Button feature provides a more convenient third method
  1747. of clicking the "default" button:
  1748. {n,col:40}3.{col:70,lmgn:70}Push the right mouse button.
  1749.  
  1750. {n,lmgn:20}{n}You enable and disable the Speed Button feature with the
  1751. {font:sys,fclr:fstd,pt:12}Control Speed Button{font:helv,pt:10,fclr:fhelp}
  1752. menu command.  When Speed Button is turned on
  1753. the
  1754. {font:sys,fclr:fstd,pt:12}Control Speed Button{font:helv,pt:10,fclr:fhelp}
  1755. menu command has a check mark next to it.
  1756.  
  1757.  
  1758. {comment: --------------- Supply parameters dlg box ----------------------}
  1759. {sect:Supply parameters box}\
  1760. {bclr:bhelp}\
  1761. {lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
  1762. Supply parameters dialog box
  1763. {n,pt:10,fclr:fhelp,col:60}\
  1764. The Supply Parameters dialog box appears when you execute a Start Program
  1765. macro which specifies a question mark (?) as the only parameter to the
  1766. program to execute.  Fill in the parameters you wish to pass to the program
  1767. in the
  1768. {font:sys,fclr:fstd,pt:12}Parameters{font:helv,pt:10,fclr:fhelp}
  1769. entry field.
  1770.