home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / warptlk3.zip / TOOLKIT / SAMPLES / REXX / API / PMREXX / PMREXXIO.IPF < prev    next >
Text File  |  1995-08-24  |  34KB  |  978 lines
  1. .*
  2. .* PMREXXIO.IPF
  3. .*
  4. .* This file contains the help text for PMREXX.
  5. .*
  6. .* 11/14/94 -- Completed major revisions for 32-bit version
  7. .*             done in Endicott.  Mike Baryla
  8. .*
  9. :userdoc.
  10. :prolog.
  11. :title.
  12. :tline.PMREXX HELP
  13. :etitle.
  14. :eprolog.
  15. :body.
  16. .********************************************************************
  17. .* General Help from the help pull-down menu on PMREXX action bar.
  18. .* The general help topic is "Help for PMREXX."  It links several
  19. .* other topics of general interest.
  20. .********************************************************************
  21. :h1 res=01.Help for PMREXX
  22. :i1.PMREXX
  23. :i1.About PMREXX
  24. :p.Use PMREXX to run and debug REXX procedures.
  25. :p.
  26. PMREXX is a windowed
  27. application that runs a REXX procedure.
  28. Any results displayed by the REXX procedure
  29. are displayed in the PMREXX window.
  30. You
  31. can use the scroll bar to view any previous output that
  32. has not been cleared.
  33. :p.PMREXX also provides a single line input field so that you can supply
  34. input to the REXX procedure or to any commands called by the REXX procedure.
  35. For more information about using REXX procedures, see :hp1.REXX
  36. Information:ehp1..
  37. :p.
  38. For more information about starting and using PMREXX, select these topics:
  39. :ul compact.
  40. :li.:link reftype=hd RES=38 group=40.Using PMREXX:elink.
  41. :li.:link reftype=hd RES=40 group=40.Developing Procedures with PMREXX:elink.
  42. :li.:link reftype=hd RES=39 group=40.Tracing REXX Procedures:elink.
  43. :eul.
  44. .*
  45. .* Additional topic that is linked by the "Help for PMREXX" topic
  46. .*
  47. :h1 res=38.Using PMREXX
  48. :i1.using PMREXX
  49. :i1.starting PMREXX
  50. :i1.arguments, specifying
  51. :i1.specifying arguments
  52. :p.
  53. To start PMREXX, enter PMREXX from an OS/2 command prompt followed
  54. by the name of a REXX procedure to run:
  55. :xmp.
  56. pmrexx myprog
  57. :exmp.
  58. :p.
  59. You can also supply arguments for the REXX procedure.
  60. In this example, PMREXX runs the procedure MYPROG and
  61. passes MYPROG the argument c&colon.\test\test.data&colon.
  62. :xmp.
  63. pmrexx myprog c&colon.\test\test.data
  64. :exmp.
  65. :p.
  66. PMREXX runs the REXX procedure and displays any output generated
  67. by it in a scrollable output box that is part of the
  68. PMREXX window.
  69. If the procedure prompts you for input, the prompt
  70. is displayed in the output box, but you type the response
  71. in the smaller input box near the top of the PMREXX window.
  72. :p.
  73. To try it, start another OS/2 session and create this REXX procedure:
  74. :xmp.
  75. /* DIRTEST.CMD -- displays directory contents */
  76. do forever
  77.    say 'Enter the name of a directory'
  78.    parse upper pull response
  79.    if response='QUIT' then leave
  80.    'dir' response
  81. end
  82. exit
  83. :exmp.
  84. :p.
  85. Then start PMREXX again for the DIRTEST procedure:
  86. :xmp.
  87. pmrexx dirtest
  88. :exmp.
  89. :p.
  90. When the PMREXX window is displayed, you will see the prompt in
  91. the output box.
  92. Position the cursor in the input box, type the name of a
  93. directory, and press Enter.
  94. The contents of the directory will be listed in the output
  95. box, and another prompt will be displayed.
  96. :p.
  97. When amount of displayed output exceeds the size of the output
  98. box, a slider box appears in the scroll bar.
  99. :p.
  100. To end the DIRTEST program, enter QUIT in the input box.
  101. :p.
  102. .*
  103. .* Additional topic that is linked by the "Help for PMREXX" topic
  104. .*
  105. :h1 res=40.Developing Procedures with PMREXX
  106. :i1.developing procedures with PMREXX
  107. :i1.REXX procedures, developing
  108. :i1.restarting a REXX procedure
  109. :i1.REXX procedures, restarting
  110. :p.
  111. To use PMREXX as a miniature development environment for your
  112. procedures, run PMREXX in one OS/2 session and an editor in another
  113. session.
  114. :p.
  115. Use the editor to change and save the procedure being developed.
  116. Then switch to the PMREXX session to run the modified procedure.
  117. :p.
  118. You can restart a procedure from PMREXX by
  119. selecting :hp2.Trace:ehp2. from the action bar in the PMREXX window.
  120. If the procedure is running, select :hp2.Halt procedure:ehp2. to stop
  121. it,
  122. then
  123. select :hp2.Restart:ehp2. from the menu.
  124. Otherwise, just select :hp2.Restart:ehp2..
  125. The latest version of the procedure will run again.
  126. .*
  127. .* Additional topic that is linked by the "Help for PMREXX" topic
  128. .*
  129. :h1 res=39.Tracing REXX Procedures
  130. :p.
  131. :i1.tracing REXX procedures
  132. :i1.debugging REXX procedures
  133. :i1.REXX procedures, debugging
  134. :i1.REXX procedures, tracing
  135. :i1.interactive trace
  136. PMREXX includes several functions that are useful for debugging
  137. your procedures.
  138. You can, for instance, start an interactive trace from PMREXX without
  139. having to add a TRACE instruction to your procedure.
  140. Select :hp2.Trace:ehp2. on the action bar, and then select
  141. :hp2.Interactive trace on:ehp2..
  142. A check mark on the menu shows that interactive tracing is on.
  143. To stop the interactive trace, just select :hp2.Interactive trace on again:ehp2..
  144. One advantage of using the interactive trace from PMREXX is that you can turn
  145. the trace on and off while the program is running.
  146. :p.
  147. Once tracing is active, you can step through your procedure one clause at
  148. at time, re-do a clause that was just processed, or enter a line of REXX
  149. clauses for immediate processing.
  150. The ability to enter REXX clauses is especially useful if you want to
  151. try a fix to a problem interactively or if you want to test
  152. instruction paths that are otherwise difficult to trigger.
  153. For example, you might want to test some error handling instructions,
  154. but cannot easily create the condition that would cause the error.
  155. By using the interactive trace, you can add REXX instructions
  156. at the right moment to fake the conditions that would cause the error
  157. handling instructions to be processed.
  158. :p.
  159. To process a line of one or more REXX clauses, type the line in the
  160. PMREXX input box when tracing is active and press ENTER.
  161. For example, you could enter:
  162. :xmp.
  163. do i=1 to 10; say 'hello' i; end
  164. :exmp.
  165. :p.
  166. The line is processed before the next REXX clause in the program is processed.
  167. If you simply want to step ahead to the next clause, press Enter
  168. without typing anything in the input area.
  169. You can also step ahead by selecting :hp2.Trace next clause:ehp2.
  170. from the :hp2.Trace:ehp2. menu.
  171. If you want to process the last REXX clause again,
  172. select
  173. :hp2.Re-do last clause:ehp2. from the :hp2.Trace:ehp2.menu.
  174. :p.
  175. To stop tracing, select
  176. :hp2.Trace off:ehp2. from the :hp2.Trace:ehp2..
  177. This item is not selectable
  178. when the REXX procedure is waiting for user input.
  179. In this case select :hp2.Interactive trace on:ehp2. again to stop the
  180. trace.
  181. :p.
  182. .********************************************************************
  183. .*
  184. .* End of general Help topics.
  185. .*
  186. .********************************************************************
  187. .*
  188. .* Start of Help topics for action bar choices.  Each action bar
  189. .* choice is followed by the helps for the pull-down menus
  190. .*
  191. .*********************************************************************
  192. .* Help for File       (Action Bar)
  193.  
  194. :h1 res=02 nosearch.Help for File
  195. :p.Use the choices on the :hp2.File:ehp2. pull-down to save the contents
  196. of the output window, to set properties of the output window, and to exit PMREXX.
  197. .********************************************************************
  198.  
  199. .*Help for Save  (PD)
  200. :h1 res=03 nosearch.Help for Save
  201. :i1.saving the output window
  202. :i1.output window, saving
  203. :p.Use :hp2.Save:ehp2. on the :hp2.File:ehp2. pull down menu to save the text displayed in the PMREXX
  204. window.
  205. If you have previously saved the output window, the text
  206. is written to that same file.
  207. Otherwise, the :hp2.Save as:ehp2. dialog box is displayed
  208. so that you can select a file.
  209. .***********************************************************************
  210.  
  211. .*Help for Save as    (PD)
  212.  
  213. :h1 res=04 nosearch.Help for Save As
  214. :p.Use :hp2.Save as:ehp2. to name and save a new file or to save an existing
  215. file under a different name, in a different directory, or on a different disk.
  216. When you choose :hp2.Save as:ehp2., a pop-up is displayed.
  217.  
  218. .* Help for Properties (PD)
  219.  
  220. :h1 res=35.Help for Properties
  221. :i1.properties, setting
  222. :p.Use :hp2.Properties:ehp2. to set PMREXX fonts and to
  223. indicate whether output from REXX procedures should be appended to any existing
  224. text in the output window.
  225.  
  226. .*Help for font
  227. :h1 res=18.Help for Font
  228. :p.Use :hp2.Font:ehp2.
  229. to display the text in the output window in a different font.  When you
  230. choose :hp2.Font:ehp2., a pop-up is displayed.
  231. .*
  232.  
  233. :h1 res=36.Help for Append Results
  234. :p.Use :hp2.Append Results:ehp2.
  235. if you want the results of REXX procedures
  236. to be appended to the output window.
  237. If :hp2.Append Results:ehp2. is not selected,
  238. the output window is cleared each time you run the REXX procedure.
  239. .**********************************************************************
  240. .*Help for Exit   (PD)
  241. :h1 res=09 nosearch.Help for Exit
  242. :p.Use :hp2.Exit:ehp2.
  243. to close PMREXX.
  244. .*******************************************************************
  245.  
  246. .*Help for Edit  (AB)
  247. :h1 res=10 nosearch.Help for Edit
  248. :p.Use the choices on the :hp2.Edit:ehp2. pull-down to cut, copy, paste, delete, or search
  249. the contents of the output window.
  250. .*************************************************************************
  251.  
  252. :h1 res=32.Help for Cut
  253. :p.Use :hp2.Cut:ehp2.
  254. to move or delete
  255. :link reftype=hd RES=4864 group=41 dependent.selected text:elink. from the
  256. output window.  A
  257. copy of the text is moved to the
  258. :link reftype=hd RES=4752 group=40 dependent.Clipboard:elink..
  259. :p.You can use the :hp2.Paste:ehp2. choice to insert the text from
  260. the Clipboard into the input window.
  261. :p.To select or mark text&colon.
  262. :ol compact.
  263. :li.Position the mouse pointer to the left of the first character
  264. to be selected.
  265. :li.Hold down mouse button 1; then use the mouse to drag (move)
  266. the cursor to the right of the last character to be selected.
  267. :li.Release mouse button 1.
  268. :eol.
  269. :p.When the cursor comes to a window border while you are marking text,
  270. PMREXX scrolls past the border.
  271. This makes it possible to select more text than can be displayed in the window.
  272. :p.
  273. To deselect text or remove the highlighting, click once within the text
  274. area of the window.
  275. .*Help for Copy
  276. :h1 res=11 nosearch.Help for Copy
  277. :p.Use :hp2.Copy:ehp2.
  278. to duplicate
  279. :link reftype=hd RES=4864 group=41 dependent.selected text:elink. from the
  280. output window.  The
  281. text remains in the output window, but a copy of the text is moved to the
  282. :link reftype=hd RES=4752 group=40 dependent.Clipboard:elink..
  283. :p.You can use the :hp2.Paste:ehp2. choice to insert the text from
  284. the Clipboard into the input window.
  285. :p.To select or mark text&colon.
  286. :ol compact.
  287. :li.Position the mouse pointer to the left of the first character
  288. to be selected.
  289. :li.Hold down mouse button 1; then use the mouse to drag (move)
  290. the cursor to the right of the last character to be selected.
  291. :li.Release mouse button 1.
  292. :eol.
  293. :p.When the cursor comes to a window border while you are marking text,
  294. PMREXX scrolls past the border.
  295. This makes it possible to select more text than can be displayed in the window.
  296. :p.
  297. To deselect text or remove the highlighting, click once within the text
  298. area of the window.
  299. .*************************************************************************
  300.  
  301. .*Definition Selected Text
  302. :h1 hide res=4864 x=25% y=20% width=70% height=50% scroll=vertical rules=sizeborder titlebar=sysmenu group=41 id=A4864.Selected Text&colon.definition
  303. :i1.Selected text, definition
  304. :p.To select text means to highlight the text that you want to delete
  305. or move.  You delete or move selected text by using the :hp2.Cut:ehp2., :hp2.Delete:ehp2.,
  306. :hp2.Copy:ehp2., or :hp2.Paste:ehp2. choices on the
  307. :hp2.Edit:ehp2. pull-down.
  308. .************************************************************************
  309.  
  310.  
  311. .*Definition Clipboard
  312. :h1 hide res=4752 x=25% y=20% width=70% height=50% scroll=vertical rules=sizeborder titlebar=sysmenu group=40 id=A4752.Clipboard&colon.definition
  313. .*:i1.Clipboard, definition
  314. :p.
  315. A clipboard is an area of storage that can temporarily hold data
  316. that is available to other programs.
  317. .*************************************************************************
  318.  
  319.  
  320. :h1 res=12 nosearch.Help for Paste
  321. :p.Use :hp2.Paste:ehp2.
  322. to insert the text from
  323. the :link reftype=hd RES=4752 group=40 dependent.Clipboard:elink.
  324. into the input window.  Press Enter to pass the text you have pasted in
  325. the input window into the REXX program.
  326. :p.If text is :link reftype=hd res=4864 group=41 dependent.selected:elink.,
  327. the text from the Clipboard will replace the selected text.
  328. :nt.Use
  329. :hp2.Copy:ehp2. or :hp2.Cut:ehp2. to put text on the
  330. Clipboard.
  331. :ent.
  332. .*************************************************************************
  333.  
  334. .*Help for Delete
  335. :h1 res=13 nosearch.Help for Delete
  336. :p.Use :hp2.Delete:ehp2.
  337. to delete
  338. :link reftype=hd RES=4864 dependent.selected text:elink.
  339. from the output window.
  340. :p.To delete selected text&colon.
  341. :ol compact.
  342. :li.Select the text to be deleted.
  343. :li.Select :hp2.Edit:ehp2..
  344. :li.Select :hp2.Delete:ehp2..
  345. :eol.
  346. .**********************************************************************
  347.  
  348.  
  349. .*Help for Select All (PD)
  350. :h1 res=14 nosearch.Help for Select All
  351. :p.Use :hp2.Select all:ehp2.
  352. to
  353. :link reftype=hd RES=4864.select:elink.
  354. all of the text in the output window.  You can then perform some action on this
  355. text.  (For example, you could copy all the text to the clipboard.)
  356. .**************************************************************************
  357. :h1 res=34.Help for Deselect All
  358. :p.Use :hp2.Deselect All:ehp2. to deselect all selected
  359. text in the output window.
  360.  
  361. :h1 res=37.Help for Search
  362. :p.Use :hp2.Search:ehp2. to search for a string in the PMREXX output window.
  363.  
  364. :h1 res=24.Help for Trace
  365. :p.Use the choices on the :hp2.Trace:ehp2. pull-down menu to set tracing on or off and to
  366. halt and restart REXX procedures.
  367.  
  368. .*Help for Restart
  369. :h1 res=16 nosearch.Help for Restart
  370. :p.Use :hp2.Restart:ehp2. to start a PMREXX procedure again.
  371. .**********************************************************************
  372.  
  373. .*Help for Interactive trace on
  374. :h1 res=17.Help for Interactive trace on
  375. :p.
  376. Use :hp2.Interactive trace on:ehp2. to start an interactive trace.
  377. Interactive Trace is used for debugging your program.
  378. .***********************************************************************
  379.  
  380.  
  381.  
  382. .*Help for Halt Procedure
  383. :h1 res=25 nosearch.Help for Halt Procedure
  384. :p.Use :hp2.Halt procedure:ehp2. to stop a PMREXX program.
  385. .************************************************************************
  386.  
  387.  
  388. .*Help for Trace next clause
  389. :h1 res=26 nosearch.Help for Trace next clause
  390. :p.
  391. Use :hp2.Trace next clause:ehp2. to step to the next clause in the PMREXX
  392. procedure.  Using this choice is the same as entering a
  393. blank line in the input field.
  394. .**********************************************************************
  395.  
  396.  
  397. .*Help for Re-do last clause
  398. :h1 res=27 nosearch.Help for Re-do last clause
  399. :p.
  400. Use :hp2.Re-do last clause:ehp2. to repeat the last PMREXX clause procedure.
  401. Using this choice is the same as entering an
  402. equal sign (=) in the input field.
  403. .************************************************************************
  404.  
  405.  
  406. .*Help for Trace off
  407. :h1 res=28 nosearch.Help for Trace off
  408. :p.
  409. Use :hp2.Trace off:ehp2. to turn off the debugging procedure in your
  410. program session.
  411. .*********************************************************************
  412. .* Help for Dialog Boxes
  413. .* -- font selection
  414. .*********************************************************************
  415. .*
  416. .* Help for Save As Dialog box (D)
  417. .*
  418. :h1 hide res=56 scroll=none titlebar=yes group=100 id=A9004.Help for Save as
  419. :link reftype=hd res=26500 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  420. :link reftype=hd res=26600 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  421.  
  422. :h1 hide res=26500 nosearch noprint.Help for Save as
  423. :ol compact.
  424. :li.Select the down arrow to the right of the :hp2.Drive:ehp2. list to display
  425. all the drives on your system.
  426. :li.Select a drive from the :hp2.Drive:ehp2. list.
  427. :li.Select a directory from the :hp2.Directory:ehp2. list.
  428. :li.Type the name of the file in which you want to save the contents of
  429. the output window in the :hp2.Save as file name:ehp2. field
  430. and select the :hp2.Ok:ehp2. pushbutton.
  431. :eol.
  432. :p.For specific help, select a topic below.
  433.  
  434. :h1 hide res=26600 nosearch noprint.List of Fields
  435. :dl compact tsize=23.
  436. :dt.:link reftype=hd res=58 group=200.Save as filename:elink.
  437. :dd.:link reftype=hd res=60 group=210.Save file as type:elink.
  438. :dt.:link reftype=hd res=59 group=220.Drive:elink.
  439. :dd.:link reftype=hd res=62 group=230.File:elink.
  440. :dt.:link reftype=hd res=61 group=240.Directory:elink.
  441. :dd.:link reftype=hd res=57 group=250.Ok pushbutton:elink.
  442. :dt.:link reftype=hd res=55 group=251.Cancel pushbutton:elink.
  443. :dd.
  444. :edl.
  445. .*
  446. .* Help for "Save as file name" field on Save As dialog box
  447. .*
  448. :h1 hide res=58 scroll=none titlebar=yes group=260 nosearch noprint.Help for Save as filename
  449. :link reftype=hd res=26550 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  450. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  451.  
  452. :h1 hide res=26550 nosearch.Help for Save as filename
  453. :p.Type the name of the file in which you want to place the contents
  454. of the output window in the
  455. :hp2.Save as filename:ehp2. field
  456. and select the :hp2.Ok:ehp2. pushbutton.
  457. :p.For more help, select a topic below.
  458.  
  459. :h1 hide res=26650 nosearch noprint.List of Fields
  460. :dl compact tsize=23.
  461. :dt.:link reftype=hd res=58 group=270.Save as filename:elink.
  462. :dd.:link reftype=hd res=60 group=280.Save file as type:elink.
  463. :dt.:link reftype=hd res=59 group=290.Drive:elink.
  464. :dd.:link reftype=hd res=62 group=300.File:elink.
  465. :dt.:link reftype=hd res=61 group=310.Directory:elink.
  466. :dd.:link reftype=hd res=57 group=320.Ok pushbutton:elink.
  467. :dt.:link reftype=hd res=55 group=321.Cancel pushbutton:elink.
  468. :dd.:link reftype=hd res=56  group=330.General help:elink.
  469. :edl.
  470. .************************************************************************
  471.  
  472. .* Help for "Save file as type" field in Save As dialog box
  473.  
  474. :h1 hide res=60 scroll=none titlebar=yes group=380 nosearch noprint.Help for Save file as type
  475. :link reftype=hd res=26552 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  476. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  477.  
  478. :h1 hide res=26552 group=390 nosearch.Help for Save file as type
  479. :p.Select the down arrow to the right of the :hp2.Save file as type:ehp2. field to
  480. display the available file types.  PMREXX is set for all file types.
  481. :p.For more help, select a topic below.
  482. .***********************************************************************
  483.  
  484. .* Help for Drive field on the Save As dialog box
  485.  
  486. :h1 hide res=59 scroll=none titlebar=yes group=110 nosearch noprint.Help for Drive
  487. :link reftype=hd res=26553 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  488. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  489.  
  490. :h1 hide res=26553 group=400 nosearch.Help for Drive
  491. :p.The :hp2.Drive:ehp2. list displays the drives on your system.  Select the
  492. drive that contains the file in which you want to place the contents
  493. of the output window.
  494. :p.For more help, select a topic below.
  495. .***************************************************************************
  496.  
  497. .* Help for File field on the Save As dialog box
  498.  
  499. :h1 hide res=62 scroll=none titlebar=yes group=120 nosearch noprint.Help for File
  500. :link reftype=hd res=26554 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  501. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  502.  
  503. :h1 hide res=26554 group=420 nosearch.Help for File
  504. :p.The :hp2.File:ehp2. list displays all the files in the directory
  505. you selected from the :hp2.Directory:ehp2. list.  Select the file in which
  506. you want to place the contents of the output window.
  507. :p.For more help, select a topic below.
  508. .***************************************************************************
  509.  
  510. .* Help for Directory field on the Save As dialog box
  511.  
  512. :h1 hide res=61 scroll=none titlebar=yes group=11 nosearch noprint.Help for Directory
  513. :link reftype=hd res=26555 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  514. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  515.  
  516. :h1 hide res=26555 group=430 nosearch.Help for Directory
  517. :p.The :hp2.Directory:ehp2. list displays the directories on the selected
  518. drive.  Select a directory to display the list of files from that directory
  519. in the :hp2.File:ehp2. list box.
  520. :p.For more help, select a topic below.
  521. .*************************************************************************
  522.  
  523. .* Help for Ok pushbutton on the Save As dialog box
  524.  
  525. :h1 hide res=57 scroll=none titlebar=yes group=170 nosearch noprint.Help for Ok
  526. :link reftype=hd res=26556 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  527. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  528.  
  529. :h1 hide res=26556 group=440 nosearch.Help for Ok
  530. :p.Select the :hp2.Ok:ehp2. pushbutton to save the contents of the output window
  531. to the file, drive, and directory you selected and with the file name
  532. you specified.
  533. :p.For more help, select a topic below.
  534. .********************************************************************
  535.  
  536. :h1 hide res=55 scroll=none titlebar=yes group=110 nosearch noprint.Help for Cancel
  537. :link reftype=hd res=26557 vpx=left vpy=top vpcx=100% vpcy=70% scroll=vertical rules=border titlebar=none child auto.
  538. :link reftype=hd res=26650 vpx=left vpy=bottom vpcx=100% vpcy=30% scroll=vertical rules=none titlebar=none child auto.
  539.  
  540. .* Help for Cancel push button on the Save As dialog box
  541. .*
  542. :h1 res=26557.Help for Cancel
  543. :p.
  544. Select :hp2.Cancel:ehp2. to close the dialog box without
  545. saving the contents of PMREXX output window in a file.
  546.  
  547. .********************************************************************
  548. .*
  549. .* Help for PMREXX Font Selection dialog box
  550. .*
  551. :h1 res=400.Help for PMREXX Font Selection
  552. :p.
  553. Use the PMREXX Font Selection dialog box to change the font PMREXX uses for displaying
  554. or printing text.
  555. To change fonts:
  556. :ol compact.
  557. :li.Select the device for which you are changing the font:
  558. :hp2.Display:ehp2. or :hp2.Printer:ehp2..
  559. :li.Select the font :hp2.Name:ehp2..
  560. :li.Select the font :hp2.Style:ehp2..
  561. :li.Select the font :hp2.Size:ehp2..
  562. :li.Select any desired attributes under :hp2.Emphasis:ehp2..
  563. :li.Select :hp2.Ok:ehp2..
  564. :eol.
  565. :p.
  566. As you make selections, :hp2.Sample:ehp2. will change to
  567. show you what the font looks like.
  568. :p.
  569. For a detailed explanation of each field, select from the list below:
  570. :ul compact.
  571. :li.:link reftype=hd RES=404 group=40.Name:elink.
  572. :li.:link reftype=hd RES=405 group=40.Style:elink.
  573. :li.:link reftype=hd RES=406 group=40.Size:elink.
  574. :li.:link reftype=hd RES=407 group=40.Outline:elink.
  575. :li.:link reftype=hd RES=408 group=40.Underline:elink.
  576. :li.:link reftype=hd RES=409 group=40.Strikeout:elink.
  577. :li.:link reftype=hd RES=401 group=40.Cancel:elink. push button.
  578. :eul.
  579. .*
  580. .* Help for cancel button on the font selection dialog
  581. .*
  582. :h1 res=401.Help for Cancel
  583. :p.
  584. When :hp2.Cancel:ehp2. is selected,
  585. the dialog box is closed.
  586. No changes are made to the fonts.
  587. .*
  588. .* Help for OK button on the font selection dialog
  589. .*
  590. :h1 res=402.Help for Ok
  591. :p.
  592. When :hp2.Ok:ehp2. is selected, the
  593. fonts are changed according to your selections.
  594. .*
  595. .* Help for Name field in the font selection dialog
  596. .*
  597. :h1 res=404.Help for Name
  598. :p.
  599. To select a font name, point to the
  600. arrow to the right of the :hp2.Name:ehp2. field and click mouse button 1.
  601. Then select the desired font from the displayed list.
  602. .*
  603. .* Help for Style field on the font selection dialog
  604. .*
  605. :h1 res=405.Help for Style
  606. :p.
  607. To select a font style, point to the
  608. arrow to the right of the :hp2.Style:ehp2. field and click mouse button 1.
  609. Then select the desired style from the displayed list.
  610. .*
  611. .* Help for the size field on the font selection dialog
  612. .*
  613. :h1 res=406.Help for Size
  614. :p.
  615. To select a font size, point to the
  616. arrow to the right of the :hp2.Size:ehp2. field and click mouse button 1.
  617. Then select the desired size from the displayed list.
  618. .*
  619. .* Help for the Outline check box on the font selection dialog
  620. .*
  621. :h1 res=407.Help for Outline
  622. :p.
  623. Select :hp2.Outline:ehp2. if you want only the outline
  624. of the characters in the font to be displayed.
  625. .*
  626. .* Help for the Underline check box on the font selection dialog
  627. .*
  628. :h1 res=408.Help for Underline
  629. :p.
  630. Select :hp2.Underline:ehp2. if you want all
  631. characters to be underlined.
  632. .*
  633. .* Help for the Strikeout check box on the font selection dialog
  634. .*
  635. :h1 res=409.Help for Strikeout
  636. :p.
  637. Select :hp2.Strikeout:ehp2. if you want a horizontal line
  638. to be drawn through all characters.
  639. .*
  640. :h1 res=410.Help for Display
  641. :p.Select the :hp2.Display:ehp2. check box if you
  642. want to change the font used for the output window display.
  643. :h1 res=411.Help for Print
  644. :p.Select the :hp2.Print:ehp2. check box if you want to
  645. change the font used when the output window is printed.
  646. .********************************************************************
  647. .*
  648. .* Help for Search dialog
  649. .*
  650. .********************************************************************
  651. .* I think that 604 is never called and that 601 is used instead
  652. :h1 res=604.Help for Search
  653. :p.Use the Search dialog to find text
  654. in the PMREXX output window.
  655. :h1 res=603.Help for Case Sensitive
  656. :p.Select the :hp2.Case sensitive:ehp2. check box if you
  657. want PMREXX to consider capital and small letters in its search.
  658. .*
  659. :h1 res=602.Help for Enter search text
  660. :p.Type the string of text to be found in the :hp2.Enter search text:ehp2. field.
  661. .*
  662. :h1 res=601.Help for Search 
  663. :p.Use the :hp2.Search:ehp2. dialog box to search
  664. for strings of text in the output window:
  665. :ol.
  666. :li.Type the text to be found in the :hp2.Enter search text field:ehp2..
  667. :li.Select the :hp2.Case sensitive:ehp2. check box if you want the
  668. capital and small letters to be significant.
  669. :li.Select :hp2.Ok:ehp2..
  670. :eol.
  671. .*
  672. .*
  673. :h1 res=605.Help for Ok
  674. :p.Select the :hp2.Ok:ehp2. push button to start the search.
  675. .*
  676. :h1 res=606.Help for Cancel
  677. :p.Select the :hp2.Cancel:ehp2. push button to close the :hp2.Search:ehp2. dialog
  678. box without searching for text.
  679. .********************************************************************
  680. .*
  681. .* THE HELP KEY DEFINITIONS
  682. .*
  683. .********************************************************************
  684. .****** HID_KEYS_HELP_PANEL
  685. :h1 res=9001 group=250.Help for Key Assignments
  686. :p.
  687. Select the key group you want help for:
  688. :ul.
  689. :li.
  690. :link reftype=hd res=6375 group=251.HELP KEYS:elink. to get help
  691. and manage help information
  692. :li.
  693. :link reftype=hd res=6376 group=252.SYSTEM KEYS:elink. to switch
  694. among open programs, groups, and online documents
  695. :li.
  696. .*:link reftype=hd res=6377 group=253.PROGRAM WINDOW KEYS:elink.
  697. :link reftype=hd res=6377 group=253.WINDOW MOVEMENT KEYS:elink.
  698. to move around in a program, group, or help window, or to move
  699. or size a window
  700. :li.
  701. :link reftype=hd res=6378 group=254.POP-UP KEYS:elink.
  702. to move around in or complete a pop-up.
  703. :eul.
  704. :p.
  705. When two key names are joined by a plus sign (+), use these two keys
  706. together.  Hold down the first key and press the second key.
  707.  
  708. :h1 hide res=6375 group=251 id=A6375 nosearch.Help for Help Keys
  709. :p.
  710. From any active window:
  711. :dl tsize=5 break=all compact.
  712. :dt.:hp2.
  713. Alt+F6:ehp2.
  714. :dd.
  715. Switch between the help window and the associated program window
  716. :dt.:hp2.
  717. F1:ehp2.
  718. :dd.
  719. Get help for the active area
  720. :edl.
  721. :p.
  722. From any active window that has a :hp2.Help:ehp2. action bar choice:
  723. :dl tsize=5 break=all compact.
  724. :dt.:hp2.
  725. F2:ehp2.
  726. :dd.
  727. Display general information about the program
  728. :dt.:hp2.
  729. F9:ehp2.
  730. :dd.
  731. Display a list of keys for the program
  732. :dt.:hp2.
  733. F11 or Shift+F1:ehp2.
  734. :dd.
  735. Display the help index for the program
  736. :dt.:hp2.
  737. Shift+F10:ehp2.
  738. :dd.
  739. Get help about the help facility
  740. :edl.
  741. :p.
  742. From any active help window:
  743. :dl tsize=5 break=all compact.
  744. :dt.:hp2.
  745. Alt+F4:ehp2.
  746. :dd.
  747. Close the help window
  748. :dt.:hp2.
  749. Esc:ehp2.
  750. :dd.
  751. Redisplay the previous help
  752. .*Following added per Mark Benge 6/8am -- there will be PTR.
  753. .*topic
  754. topic, if there is one; if not, remove the help window
  755. .*End change
  756. :dt.:hp2.
  757. Ctrl+A:ehp2.
  758. :dd.
  759. Copy the displayed topic and add it to the end of a temporary file
  760. :dt.:hp2.
  761. Ctrl+C:ehp2.
  762. :dd.
  763. Display the help table of contents
  764. :dt.:hp2.
  765. Ctrl+F:ehp2.
  766. :dd.
  767. Copy the displayed topic to a temporary file
  768. :dt.:hp2.
  769. Ctrl+H:ehp2.
  770. :dd.
  771. Display a list of all the topics you have viewed
  772. :dt.:hp2.
  773. Ctrl+L:ehp2.
  774. :dd.
  775. Display a list of libraries that contain help topics for one or
  776. more programs
  777. :dt.:hp2.
  778. Ctrl+N:ehp2.
  779. :dd.
  780. Open a new help window to display any topic
  781. .*
  782. .*you can select from a list
  783. .*of topics or index entries, or sometimes for topics related to words or
  784. .*phrases that have special highlighting
  785. that is displayed in a window where the minimize and maximize choices
  786. in the System Menu pull-down are displayed and available
  787. .*
  788. :dt.:hp2.
  789. Ctrl+S:ehp2.
  790. :dd.
  791. Search for a word or phrase in help topics
  792. :dt.:hp2.
  793. Ctrl+Ins:ehp2.
  794. :dd.
  795. Copy the displayed topic to the clipboard
  796. :edl.
  797. :p.
  798. From any active Contents window that has multiple levels of help topics:
  799. :dl tsize=5 break=all compact.
  800. :dt.:hp2.
  801. Ctrl+* (Asterisk):ehp2.
  802. :dd.
  803. Display all levels of the table of contents
  804. :dt.:hp2.
  805. Ctrl+- (Minus):ehp2.
  806. :dd.
  807. Remove all subtopics from the table of contents
  808. :dt.:hp2.
  809. + (Plus):ehp2.
  810. :dd.
  811. Display one more level of topics in the table of contents
  812. :dt.:hp2.
  813. * (Asterisk):ehp2.
  814. :dd.
  815. Display all subtopics for one topic in the table of contents
  816. :dt.:hp2.
  817. - (Minus):ehp2.
  818. :dd.
  819. Remove all subtopics from one topic in the table of contents
  820. :dt.:hp2.
  821. Tab:ehp2.
  822. :dd.
  823. Move to the next word or phrase that has special highlighting
  824. :edl.
  825.  
  826. :h1 hide res=6376 group=252 id=A6376 nosearch.Help for System Keys
  827. :dl tsize=5 break=all compact.
  828. :dt.:hp2.
  829. Alt+Esc or Alt+Tab:ehp2.
  830. :dd.
  831. Switch to the next program (windowed or full-screen), group,
  832. or online document
  833. :dt.:hp2.
  834. Ctrl+Esc:ehp2.
  835. :dd.
  836. Switch to the Task List
  837. :edl.
  838.  
  839. :h1 hide res=6377 group=253 id=A6377 nosearch.Help for Window Movement Keys
  840. :dl tsize=5 break=all compact.
  841. :dt.:hp2.
  842. F3:ehp2.
  843. :dd.
  844. Close the active program window
  845. :dt.:hp2.
  846. F10 or Alt:ehp2.
  847. :dd.
  848. Switch to or from the action bar
  849. :dt.:hp2.
  850. Arrow keys:ehp2.
  851. :dd.
  852. Move among choices
  853. :dt.:hp2.
  854. End:ehp2.
  855. :dd.
  856. Move to the last choice in a pull-down
  857. :dt.:hp2.
  858. Esc:ehp2.
  859. :dd.
  860. Remove an action bar pull-down or the System Menu pull-down but keep
  861. the action bar choice or the System Menu icon selected
  862. :dt.:hp2.
  863. First letter:ehp2.
  864. :dd.
  865. Select from a list the next choice that starts with the
  866. .*typed letter
  867. letter you type
  868. :dt.:hp2.
  869. Home:ehp2.
  870. :dd.
  871. Move to the first choice in a pull-down
  872. :dt.:hp2.
  873. PgUp:ehp2.
  874. :dd.
  875. Scroll the contents of a window up one page
  876. :dt.:hp2.
  877. PgDn:ehp2.
  878. :dd.
  879. Scroll the contents of a window down one page
  880. :dt.:hp2.
  881. Underlined letter:ehp2.
  882. :dd.
  883. Select a choice on the action bar or a pull-down
  884. :dt.:hp2.
  885. Alt+F4:ehp2.
  886. :dd.
  887. Close the active program window
  888. :dt.:hp2.
  889. Alt+F5:ehp2.
  890. :dd.
  891. Restore the active program window
  892. :dt.:hp2.
  893. Alt+F7:ehp2.
  894. :dd.
  895. Move the active program window
  896. :dt.:hp2.
  897. Alt+F8:ehp2.
  898. :dd.
  899. Size the active program window
  900. :dt.:hp2.
  901. Alt+F9:ehp2.
  902. :dd.
  903. Minimize the active program window
  904. :dt.:hp2.
  905. Alt+F10:ehp2.
  906. :dd.
  907. Maximize the active program window
  908. :dt.:hp2.
  909. Ctrl+PgDn:ehp2.
  910. :dd.
  911. Scroll the contents of a window right one page
  912. :dt.:hp2.
  913. Ctrl+PgUp:ehp2.
  914. :dd.
  915. Scroll the contents of a window left one page
  916. :dt.:hp2.
  917. Shift+Esc or Alt+Spacebar:ehp2.
  918. :dd.
  919. Switch to or from the System Menu pull-down
  920. :dt.
  921. :hp2.Shift+Esc or Alt:ehp2.
  922. :dd.
  923. Switch to or from the System Menu pull-down of an OS/2 or a DOS window
  924. :edl.
  925.  
  926. :h1 hide res=6378 group=254 id=A6378 nosearch.Help for Pop-Up Keys
  927. :dl tsize=5 break=all compact.
  928. :dt.:hp2.
  929. Alt+F6:ehp2.
  930. :dd.
  931. Switch between the pop-up and the help window
  932. :dt.:hp2.
  933. Enter:ehp2.
  934. :dd.
  935. Send any changes to the program
  936. :dt.:hp2.
  937. Esc:ehp2.
  938. :dd.
  939. Remove the pop-up without sending any changes to the program
  940. :dt.:hp2.
  941. F1:ehp2.
  942. :dd.
  943. Get help for the active area
  944. :dt.:hp2.
  945. Spacebar:ehp2.
  946. :dd.
  947. Select a check box choice
  948. or perform the task described in the selected pushbutton
  949. :dt.:hp2.
  950. Tab:ehp2.
  951. :dd.
  952. Move to the next field (entry field, check box, list, spin button,
  953. first radio button, or first pushbutton)
  954. :edl.
  955. :p.
  956. In an entry field:
  957. :dl tsize=5 break=all compact.
  958. :dt.:hp2.
  959. Backspace
  960. :ehp2.
  961. :dd.
  962. Delete the character to the left of the cursor
  963. :dt.:hp2.
  964. Del:ehp2.
  965. :dd.
  966. Delete the character to the right of the cursor
  967. :dt.:hp2.
  968. End or Ctrl+Right Arrow key:ehp2.
  969. :dd.
  970. Move to the end of a field
  971. :dt.:hp2.
  972. Home or Ctrl+Left Arrow key:ehp2.
  973. :dd.
  974. Move to the beginning of a field
  975. :edl.
  976.  
  977. :euserdoc.
  978.