home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pc2.zip / SOURCE.ZIP / SOURCE / PC2.IPF < prev    next >
Text File  |  1993-03-09  |  28KB  |  509 lines
  1. :userdoc.
  2. :title.PC/2 Help Program
  3. :body.
  4.  
  5.  
  6. .****************************************************************************************
  7. .*--------------------------------------------------------------------------------------*
  8. .* The user selected help with F1, the mouse or the keyboard.                           *
  9. .*--------------------------------------------------------------------------------------*
  10. .****************************************************************************************
  11.  
  12. :h1 res=2000.PC/2 Help for Help
  13. :lines align=center.
  14. :color fc=red.
  15. PC/2 - Program Commander/2 Version 1.20
  16. for IBM OS/2 2.0 Presentation Manager
  17. Copyright (C) by Stangl Roman 03, 1993
  18. :color fc=default.
  19. :elines.
  20. :p.Please select one of the following topics for further information:
  21. :ul compact.
  22. :li.:link reftype=hd res=302.About the utility PC/2:elink.
  23. :li.:link reftype=hd res=2008.Installing PC/2:elink.
  24. :li.:link reftype=hd res=2003.Using PC/2 as a WPS addon:elink.
  25. :li.:link reftype=hd res=2004.Concepts of the Popup-Menu:elink.
  26. :li.:link reftype=hd res=2005.Starting a Program from PC/2:elink.
  27. :li.:link reftype=hd res=301.Setup the Popup-Menu:elink.
  28. :ul compact.
  29. :li.:link reftype=hd res=800.Adding a Submenu:elink.
  30. :li.:link reftype=hd res=500.Adding a Program:elink.
  31. :eul.
  32. :li.:link reftype=hd res=2006.Error messages:elink.
  33. :eul.
  34. :p.:link reftype=hd res=2000.<Backward>:elink.
  35.                                   :link reftype=hd res=302.<Forward>:elink.
  36.  
  37.  
  38. .****************************************************************************************
  39. .*--------------------------------------------------------------------------------------*
  40. .* The user selected help from the About PC/2 dialog box.                               *
  41. .*--------------------------------------------------------------------------------------*
  42. .****************************************************************************************
  43.  
  44. :h1 res=302.Help for About PC/2
  45. :lines align=center.
  46. :color fc=red.
  47. PC/2 - Program Commander/2 Version 1.20
  48. for IBM OS/2 2.0 Presentation Manager
  49. Copyright (C) by Stangl Roman 03, 1993
  50.  
  51. University for Business Administration
  52. and Management Vienna, Austria
  53. (Wirtschaftsuniversität Wien)
  54. :color fc=default.
  55. :elines.
  56. :p.E-Mail:
  57. :ul compact.
  58. :li.8650533@awiwuw11.wu-wien.ac.at
  59. :li.Roman Stangl @ IBM Austria National Support BBS ((0043) 0222 21145 6600)
  60. :eul.
  61. :p.This program is classified as Shareware. Under the copyright, you are allowed and
  62. encouraged to freely use, distribute or modify this program under the following
  63. conditions:
  64. :ul compact.
  65. :li.The complete source code and all executables are included. This rule also applies
  66. for any modifications you made.
  67. :li.You may only charge for the costs of duplicating.
  68. :li.:hp7.Any:ehp7. commercial use is prohibited without contacting me prior, except
  69. for incorporating the idea/code in any future release of OS/2 by IBM, however this
  70. clause doesn't apply for any private use.
  71. :li.You don't want to port this utility to MS Windows or Windows NT (never there).
  72. :eul.
  73. :p.You are encouraged to upload this utility to your favourite file-server or
  74. BBS. Please ensure that no file is missing, if you change the archive to
  75. a different compression scheme.
  76. :p.If you find this program useful and want to honor the four weeks of work writing
  77. this utility, you are welcome to send me a small fee of about 50 to 150 Austrian
  78. Schilling (about 5 to 15 dollar) to my home address. Any suggestions are of
  79. course welcome too.
  80. :p.My home address is:
  81. :sl compact.
  82. :li.    Roman Stangl
  83. :li.    Strebersdorferstrasse 46
  84. :li.    2103  Langenzersdorf, Austria
  85. :esl.
  86. :p.:link reftype=hd res=2000.<Backward>:elink.
  87.                                   :link reftype=hd res=2008.<Forward>:elink.
  88.  
  89.  
  90. .****************************************************************************************
  91. .*--------------------------------------------------------------------------------------*
  92. .* The user selected help for PC/2 installation.                                        *
  93. .*--------------------------------------------------------------------------------------*
  94. .****************************************************************************************
  95.  
  96. :h1 res=2008.Installing PC/2
  97. :p.You have obviously started PC/2 once, because you are reading this help panel.
  98. The installation is just straight forward with the REXX script that installs PC/2,
  99. however there are some points to notice:
  100. :ul.
  101. :li.The installation installed an Icon on the Desktop and started the help panels
  102. of PC/2. To ensure that OS/2 starts PC/2 automatically the next time you boot your
  103. system, you must start PC/2 again (you then can notice that the background behind
  104. the icon changes). If you have added :hp3.SET RESTARTOBJECTS=STARTUPFOLDERSONLY:ehp3.
  105. in your :hp2.CONFIG.SYS:ehp2. then you must also add a shadow of PC/2 to your startup
  106. folder to ensure PC/2 is started the next time you boot OS/2.
  107. :li.PC/2 requires the files :hp2.PC2.HLP:ehp2. to be in the path indicated by
  108. the :hp3.HELP:ehp3. and :hp2.PC2HOOK.DLL:ehp2. to be in the path indicated by
  109. the :hp3.LIBPATH:ehp3. environment variables. If you have problems running PC/2,
  110. ensure that the working directory of PC/2 is accessible by these variables in
  111. your :hp2.CONFIG.SYS:ehp2..
  112. :li.The installation assumes that you are using the default profile :hp2.Pc2.cfg:ehp2.
  113. containing a standart pre-defined Popup-Menu. If you want to use an other Popup-Menu,
  114. you have to open the Settings of PC/2 and add your preferred profile in the
  115. :hp3.Parameters:ehp3. entryfield. Please click for the next help panel to see the
  116. syntax of the command-line parameters of PC/2. This command-line parameters then
  117. must be added to the :hp3.Parameters:ehp3. entryfield.
  118. :li.You can only run one copy of PC/2 concurrently.
  119. :li.If you select a DOS-Program to be started via PC/2, the time-slice of their
  120. sessions is optimized (the DOS-Settings are modified to
  121. :hp3.IDLE_SECONDS=5 IDLE_SENSITIVITY=100:ehp3.) to get a better performance. This
  122. is useful for most DOS games.
  123. :li.You may use PC/2 with or without the WPS installed, you may even use PC/2 as
  124. a replacement for the WPS. To do so you must install PC/2 first. Then you have
  125. to ensure that :hp2.PC2HOOK.DLL:ehp2. is in a path pointed to by the :hp3.LIBPATH:ehp3.
  126. environment variable in your :hp2.CONFIG.SYS:ehp2..You also have to ensure that
  127. :hp2.PC2.HLP:ehp2. is in a path pointed to by the :hp3.HELP:ehp3. environment
  128. variable in your :hp2.CONFIG.SYS:ehp2. file. The default access ":hp2..;:ehp2." is
  129. :hp7.not:ehp7. sufficient. Then replace the statement 
  130. :hp2.SET RUNWORKPLACE=C&colon.\OS2\PMSHELL.EXE:ehp2. with
  131. :hp2.SET RUNWORKPLACE=[path]PC2.EXE:ehp2. where :hp2.[path]:ehp2. is the pathname
  132. of the directory you installed PC/2. The next time you boot, PC/2 will be
  133. started as a replacement for the WPS.
  134. :p.:hp7.Caution! PC/2 in not tested on all OS/2 version or installed software
  135. and hardware :ehp7.(simply because I don't have them):hp7., so there may be
  136. bugs!:ehp7.. Of course you can start the WPS from a command prompt by typing
  137. :hp2.START PMSHELL:ehp2. or add a corresponding entry to PC/2.
  138. :eul.
  139. :p.:link reftype=hd res=302.<Backward>:elink.
  140.                                   :link reftype=hd res=2003.<Forward>:elink.
  141.  
  142.  
  143. .****************************************************************************************
  144. .*--------------------------------------------------------------------------------------*
  145. .* The user selected general help from the PC/2 main help panel.                        *
  146. .*--------------------------------------------------------------------------------------*
  147. .****************************************************************************************
  148.  
  149. :h1 res=2003.General Help for PC/2
  150. :p.PC/2 - Program Commander is an addon for the WPS (Workplace Shell). The user
  151. can configure a menu that pops up, when the left mouse button is clicked anywhere
  152. on the Desktop. F.e. the Popup-Menu might look like:
  153. :artwork name='C:\PROGRAMMING\PC2\SOURCE\Pc2ipc01.bmp' align=left.
  154. :p.You have selected the item :hp3.Prompts:ehp3., which is a Submenu containing
  155. four more items. F.e. the item :hp3.OS/2 Window:ehp3. starts a windowed OS/2
  156. command prompt, when selected. This Popup-Menu is fully configurable, you may add,
  157. change or remove items. An item can either be a Submenu containing more items, or
  158. the name of a program.
  159. :p.Only the first Submenu :hp3.PC/2 Setup:ehp3. cannot be modified. This Submenu
  160. is used to setup PC/2 and to get help.
  161. :p.Your configuration is read from the default file :hp2.Pc2.cfg:ehp2. each time PC/2 is
  162. started and saved every time you made changes. You can of course overwrite the default
  163. configuration filename to a file named :hp2.Filename.ext:ehp2. by invoking PC/2 with
  164. the following syntax:
  165. :p.:hp2.PC2 [-Profile Filename.ext]:ehp2. or
  166. :p.:hp2.PC2 [/Profile Filename.ext]:ehp2.
  167. :p.where :hp2.Filename.ext:ehp2. conforms to a filename of a PC/2 profile. Both FAT
  168. and HPFS filename naming convention is accepted. A few
  169. sample configuration files are provided in the package.
  170. :p.I would strongly recommend to start PC/2 during OS/2 boot. If you don't
  171. want to use the default profile, don't forget to add :hp2./Profile Filename.exe:ehp2.
  172. to the :hp3.Parameters:ehp3. entryfield in the Settings of PC/2.
  173. :p.The reason why I wrote this utility was primarily, that many programs
  174. installed on a system require many folders and icons on the Desktop. But to
  175. start a program, I don't want to open and close folders, so I made shadows on
  176. the Desktop messing it up. The solution I prefer is to click on the Desktop,
  177. getting immediatly a menu and selecting the application from this menu. So
  178. PC/2 may help you to start your programs quickly, without needing to open
  179. and close folders.
  180. :p.:link reftype=hd res=2008.<Backward>:elink.
  181.                                   :link reftype=hd res=2004.<Forward>:elink.
  182.  
  183.  
  184. .****************************************************************************************
  185. .*--------------------------------------------------------------------------------------*
  186. .* The user selected concepts from the PC/2 main help panel.                            *
  187. .*--------------------------------------------------------------------------------------*
  188. .****************************************************************************************
  189.  
  190. :h1 res=2004.Concepts of PC/2
  191. :p.The basic idea behind PC/2 is to have an configurable Popup-Menu available,
  192. to start programs quicky, without having to open and close folders.
  193. :p.The Popup-Menu, popped up when you click the left mouse button anywhere on
  194. the Desktop (just like the right one for shutdown), consists of so-called
  195. items. An item may be a Submenu, which contains further items, or the title of
  196. an Application. A Submenu contains a little arrow right beside the title of
  197. the Submenu.
  198. :p.You can imagine this Popup-Menu as a tree, with applications as leaves and
  199. Submenus as nodes. PC/2 allows you to freely build your own tree. To do so
  200. you have to click on the Desktop with the left mouse button and to select
  201. :hp2.PC/2 Setup &rarrow. Configure PC/2:ehp2.. A dialog box appears, where you
  202. can add, modify or remove Submenus and Applications. The listbox displays all
  203. Submenus and Applications of one level (like a cut through the tree). Of
  204. course you may change this level up and down.
  205. :p.Once you have configured your tree of Submenus and Applications, just press
  206. :hp2.Ok:ehp2. to take them into effect and save them to the profile or
  207. :hp2.Cancel:ehp2. to take them into effect without saving.
  208. :p.:link reftype=hd res=2003.<Backward>:elink.
  209.                                   :link reftype=hd res=2005.<Forward>:elink.
  210.  
  211.  
  212. .****************************************************************************************
  213. .*--------------------------------------------------------------------------------------*
  214. .* The user selected help for starting a program from PC/2.                             *
  215. .*--------------------------------------------------------------------------------------*
  216. .****************************************************************************************
  217.  
  218. :h1 res=2005.Help for starting a program via PC/2
  219. :p.After you have configured the PC/2 Popup-Menu, you click on the Desktop
  220. with the left mouse button, select the Application you want to start and click on it.
  221. The Application will be started as if you were clicking on an icon.
  222. :p.One advantage starting an Application this way is, that you can manipulate
  223. many parameters on how the Application is started, one thing you can't do with
  224. many icons. F.e. you can start it invisible (useful for a backup program), making
  225. it only visible by selecting it from the tasklist. You may also specify the size
  226. of the Application or to start it in the background.
  227. :p.To close an Application, select the corresponding option from the Application
  228. or terminate it from the tasklist.
  229. :p.:link reftype=hd res=2004.<Backward>:elink.
  230.                                   :link reftype=hd res=301.<Forward>:elink.
  231.  
  232.  
  233. .****************************************************************************************
  234. .*--------------------------------------------------------------------------------------*
  235. .* The user selected help from the Configuration/Setup PC/2 dialog box.                 *
  236. .*--------------------------------------------------------------------------------------*
  237. .****************************************************************************************
  238.  
  239. :h1 res=301.Help for PC/2 Setup
  240. :p.In the listbox, all Submenus and Applications of one level (imagine as a cut
  241. through the tree) are displayed. A Submenu has an arrow right beside it. F.e. assume
  242. the listbox contains 3 Submenus and 2 Appliations resulting in the following Popup-Menu:
  243. :artwork name='C:\PROGRAMMING\PC2\SOURCE\Pc2ipc02.bmp' align=left.
  244. :p.You may want to get into the Submenu :hp3.Prompts:ehp3.. Just select the Submenu
  245. :hp3.Prompts:ehp3. an click on the button :hp2.Level Down >>:ehp2.. The listbox
  246. will now be filled with all Submenus and Applications of the Submenu :hp3.Prompts:ehp3..
  247. To get one level up, simply press :hp2.<< Level Up:ehp2.. If nothing seems to
  248. change, you may be at the highest level (the root of the tree) or at the deapest
  249. level (a leaf of the tree) of a Submenu.
  250. :p.To configure the Popup-Menu just select an item.
  251. :ul compact.
  252. :li.To change or to remove this item use the buttons :hp2.Change Entry:ehp2. 
  253. or :hp2.Remove Entry:ehp2.. Either a new dialog appears allowing you to change
  254. the item, or the item will be removed.
  255. :li.To add a Submenu or an Application press the buttons :hp2.Add Submenu:ehp2.
  256. or :hp2.Add Program:ehp2.. A new dialog is displayed allowing you to add a new
  257. Submenu or Application, after pressing :hp2.Ok:ehp2. in this dialog, the Submenu
  258. or Application will be inserted :hp7.after:ehp7. the selected item.
  259. :eul.
  260. :p.If the listbox is empty, you can't remove or change anything. You also can't
  261. select any item, but in this case you can add a Submenu or an Application by
  262. just pressing the buttons, without needing to select an item.
  263. :p.Press :hp2.Ok:ehp2. to write the configuration to the profile, or press
  264. :hp2.Cancel:ehp2. to keep the changes only in memory. Both buttons will dismiss
  265. the dialog.
  266. :p.:link reftype=hd res=710.Example 1:elink.
  267.      :link reftype=hd res=711.Example 2:elink.
  268. :p.:link reftype=hd res=2004.<Backward>:elink.
  269.                                   :link reftype=hd res=800.<Forward>:elink.
  270.  
  271. .*--------------------------------------------------------------------------------------*
  272. .* The user selected example 1 from the Setup PC/2 help.                                *
  273. .*--------------------------------------------------------------------------------------*
  274.  
  275. :h2 res=710.Setup example 1
  276. :p.Assume the listbox contains the following items resulting in the following Popup-Menu:
  277. :artwork name='C:\PROGRAMMING\PC2\SOURCE\Pc2ipc03.bmp' align=left.
  278. :p.You want to remove the Submenu :hp3.Editors:ehp3., rename the Submenu
  279. :hp3.Tools:ehp3. to :hp3.Utilities:ehp3. and add a Submenu :hp3.Demos:ehp3..
  280. :ol compact.
  281. :li.Select the item :hp3.Editors:ehp3.. You can now press the button
  282. :hp2.Remove Entry:ehp2. to remove the submenu, but only if this Submenu is empty.
  283. If it isn't empty, get into this Submenu by pression :hp2.Level Down >>:ehp2.
  284. and remove all items.
  285. :li.To rename :hp3.Tools:ehp3. to :hp3.Utilities:ehp3. select the item
  286. :hp3.Tools:ehp3. and press the button :hp2.Change Entry:ehp2.. A dialog box
  287. appears allowing you to rename this item.
  288. :li.Select the item, after which you want to insert the new Submenu. Then press
  289. the button :hp3.Add Submenu:ehp3. to add one. A dialog box appears allowing you
  290. to enter the title of a new Submenu.
  291. :eol.
  292.  
  293. .*--------------------------------------------------------------------------------------*
  294. .* The user selected example 2 from the Setup PC/2 help.                                *
  295. .*--------------------------------------------------------------------------------------*
  296.  
  297. :h2 res=711.Setup example 2
  298. :p.Assume that you have remove all items, leading to an empty listbox. Now
  299. you want to add the Applications :hp3.Backup:ehp3. and :hp3.Terminal:ehp3..
  300. :ol compact.
  301. :li.The listbox is empty, so you can't select any item. Just press the
  302. button :hp2.Add Program:ehp2. and a dialog box appears, allowing you to
  303. enter all the data required for the new Application.
  304. :li.Now the listbox contains the item :hp3.Backup:ehp3., select it and
  305. press the button :hp2.Add Program:ehp2. a second time. Again you get
  306. a dialog box, where you enter the data for the Application :hp3.Terminal:ehp3..
  307. :eol.
  308.  
  309.  
  310. .****************************************************************************************
  311. .*--------------------------------------------------------------------------------------*
  312. .* The user selected help from the Menu installation PC/2 dialog box.                   *
  313. .*--------------------------------------------------------------------------------------*
  314. .****************************************************************************************
  315.  
  316. :h1 res=800.Help for PC/2 Menu Installation
  317. :p.This dialog is used to get a name for a Submenu, which is then added to the
  318. Popup-Menu. You can enter whatever you like, f.e. to make a Submenu that contains
  319. OS/2 utilities you might enter :hp3.Utilities:ehp3..
  320. :p.If you have choosen in the previous dialog to change the name of a Submenu, then
  321. overwrite the preentered text.
  322. :p.Press :hp2.Ok:ehp2. to accept, or press :hp2.Cancel:ehp2. to ignore the data
  323. you entered.
  324. :p.:link reftype=hd res=810.Examples:elink.
  325. :p.:link reftype=hd res=301.<Backward>:elink.
  326.                                   :link reftype=hd res=500.<Forward>:elink.
  327.  
  328. .*--------------------------------------------------------------------------------------*
  329. .* The user selected examples from the Menu installation PC/2 help.                     *
  330. .*--------------------------------------------------------------------------------------*
  331.  
  332. :h2 res=810.Menu installation examples
  333. :p.Assume you have entered the following Submenu Titles:
  334. :dl tsize=22.
  335. :dthd.:hp2.Title
  336. :ddhd.Purpose:ehp2.
  337. :dt.Prompts
  338. :dd.You want to add a Submenu named :hp3.Prompts:ehp3., that contains OS/2 and DOS,
  339. fullscreen and windowed command prompts.
  340. :dt.Spreadsheets
  341. :dd.You want to add a Submenu named :hp3.Spreadsheets:ehp3. for your spreadsheet
  342. program like Lotus 123/G or Excel.
  343. :edl.
  344.  
  345.  
  346. .****************************************************************************************
  347. .*--------------------------------------------------------------------------------------*
  348. .* The user selected help from the Program installation PC/2 dialog box.                *
  349. .*--------------------------------------------------------------------------------------*
  350. .****************************************************************************************
  351.  
  352. :h1 res=500.Help for PC/2 Program Installation
  353. :p.This dialog is used to get the title, the path and filename, the working
  354. directory and parameters of a Menuitem, which is then added to the Popup-Menu.
  355. Additionally you can fine-tune the appearance of the program you want to add
  356. to the Popup-Menu. However the standard selections should provide a basis
  357. that is sufficient for most applications.
  358. :p.If you have choosen in the previous dialog to change the data of a Program,
  359. then overwrite or change the options you want.
  360. :p.Press :hp2.Ok:ehp2. to accept, or press :hp2.Cancel:ehp2. to ignore the data
  361. you entered.
  362. :p.For more information click on one of the following items:
  363. :ul compact.
  364. :li.:link reftype=hd res=551.Program Data:elink.
  365. :li.:link reftype=hd res=552.Program Type:elink.
  366. :li.:link reftype=hd res=553.Program Style:elink.
  367. :li.:link reftype=hd res=554.Program Size &. Position:elink.
  368. :li.:link reftype=hd res=555.Program Priority:elink.
  369. :eul.
  370. :p.:link reftype=hd res=550.Examples:elink.
  371. :p.:link reftype=hd res=800.<Backward>:elink.
  372.                                   :link reftype=hd res=2006.<Forward>:elink.
  373.  
  374. .*--------------------------------------------------------------------------------------*
  375. .* The user selected examples from the Program installation PC/2 help.                  *
  376. .*--------------------------------------------------------------------------------------*
  377.  
  378. :h2 res=550.Program installation examples
  379. :p.Assume you want to add Lotus 123/G:
  380. :dl tsize=22.
  381. :dthd.:hp2.Fieldname
  382. :ddhd.You would enter:ehp2.
  383. :dt.Program Title:
  384. :dd.:hp3.Lotus 123/G:ehp3.
  385. :dt.Path and Filename:
  386. :dd.:hp3.c&colon.\123g\123g.exe:ehp3.
  387. :dt.Working Directory:
  388. :dd.:hp3.c&colon.\123g:ehp3.
  389. :dt.Parameters:
  390. :dd.(none)
  391. :edl.
  392. :p.Lotus 123/G is a Presentation Manager application so you would select
  393. :hp3.Presentation Manager:ehp3. as program type. The program style may be
  394. :hp3.Maximized:ehp3., because more information is visible. The priority
  395. may be left at the default selection :hp3.No Change:ehp3..
  396.  
  397. :h2 res=551.Program Data
  398. :p.For a normal user it is the easiest way to use the following guidelines:
  399. :dl tsize=22.
  400. :dthd.:hp2.Fieldname
  401. :ddhd.You would enter:ehp2.
  402. :dt.Program Title:
  403. :dd.Here you enter the name, under which the program should appear in the tasklist.
  404. For OS/2 and DOS windows, this will be the title of the window.
  405. :dt.Path and Filename:
  406. :dd.Here you enter the fully qualified path and filename. F.e. you might enter
  407. :hp3.c&colon.\os2\cmd.exe:ehp3. to obtain an OS/2 command prompt, or
  408. :hp3.c&colon.\os2\mdos\qbasic.exe:ehp3. to start the basic interpreter.
  409. :dt.Working Directory:
  410. :dd.Here you enter the directory where the EXE, HLP and DLL files of your
  411. application are located. Before the application is started, a change drive
  412. and change directory call is made, to make this directory the working directory.
  413. :dt.Parameters:
  414. :dd.Here you enter the parameters passed to the application. Assume that you want
  415. to use VIEW.EXE to view the command reference, you would enter
  416. :hp3.c&colon.\os2\book\cmdref.inf:ehp3..
  417. :dt.DOS Settings:
  418. :dd.If you select as program type a DOS Full-Screen or DOS Window, a multiline
  419. entryfield is displayed where you can enter the DOS Settings you need. Default,
  420. the DOS Settings :hp3.IDLE_SECONDS=5:ehp3. and :hp3.IDLE_SENSITIVITY:ehp3. are
  421. added if you create a DOS application for the first time. (You have to spell
  422. the DOS Settings exactly as they are displayed in the standard DOS Settings
  423. dialog - even then some can't be set for whatever reasons there are.)
  424. :dt.:hp2.File Find:ehp2.&colon.
  425. :dd.If you click on this button, the standard file dialog of OS/2 is displayed
  426. where you can select the application you want to install. The application
  427. parameters (f.e. path) will then be inserted automatically in the
  428. corresponding entryfields.
  429. :edl.
  430. :p.For a power user, the data entered may be less. Because the OS/2 API
  431. DosStartSession() is used to start the application, all rules for this
  432. API apply as described in the toolkit. Hence you may leave the entryfield
  433. Path and Filename blank and then select from the
  434. :link reftype=hd res=552.Program Type:elink. group an
  435. OS/2 or DOS fullscreen or window, to get a command prompt.
  436. :p.You may also start an appliciation indirectly through a secondary command
  437. processor by specifying :hp3.c&colon.\os2\cmd.exe:ehp3. as the Path and Filename and
  438. use then the :hp3./C:ehp3. or :hp3./K:ehp3. option of CMD.EXE in the
  439. Parameters entryfield.
  440.  
  441. :h2 res=552.Program Type
  442. :p.Here you can select the type of application you want to add. By default
  443. type is determined by the WPS, which is correct for most applications. You
  444. may change to Presentation Manager for a PM application.
  445. :p.OS/2 and DOS Fullscreen or Windows are only used, if you want to start
  446. a command prompt as the application. In this case, you usually enter in the
  447. the entryfield Path and Filename of the group Program Data the path of
  448. the corresponding command processor. A advanced technique to select the
  449. type of command processor only with these radiobuttons is described under
  450. the group :link reftype=hd res=551.Program Data:elink..
  451.  
  452. :h2 res=553.Program Style
  453. :p.These selections should be self-explanatory, you can only change one of
  454. the radiobuttons, but apply as many checkboxes as you want as the Program
  455. Style. F.e. if you selected :hp3.Minimized:ehp3., :hp3.Invisible:ehp3. and
  456. :hp3.Background:ehp3., the application will be started minimized, in the
  457. background and invisible (if this makes sense?).
  458.  
  459. :h2 res=554.Program Size &. Position
  460. :p.Here you can use the checkbox to start an application with a preselected
  461. size and position. If you select the checkbox :hp3.Size, Position:ehp3. you
  462. will be able to modify the size the started application should appear.
  463. :p.If you deselect the checkbox, the data will be saved, but the application
  464. is started ignoring the size and position you entered.
  465.  
  466. :h2 res=555.Program Priority
  467. :p.At this level of development, I don't know how to change the priority of a
  468. program started as an independent session, so these radiobuttons are
  469. unavailable. I know how to change the priority started as a child of PC/2, but if the
  470. parent application PC/2 fails (by a bug or a close from the tasklist) all the
  471. childs are also terminated, which is surely unacceptable.
  472.  
  473.  
  474. .****************************************************************************************
  475. .*--------------------------------------------------------------------------------------*
  476. .* The user selected error help.                                                        *
  477. .*--------------------------------------------------------------------------------------*
  478. .****************************************************************************************
  479.  
  480. :h1 res=2006.Help for PC/2 Errors
  481. :p.PC/2 can't verify all user input for validity, so some user input may cause
  482. some PC/2 functions to fail. In this case, a message box is displayed containing
  483. the module and the sourcecode linenumber that failed. Also a error message is
  484. displayed containing which error occured and what should be done to resolve the
  485. problem.
  486. :p.F.e. you might have configured to start the program :hp3.VIEW.EXE:ehp3. by
  487. writing :hp3.c&colon.\os3\view.exe:ehp3. in the entryfield :hp2.Path and Filename:ehp2.
  488. in the Program Installation dialog. This of course leads to an error, because when
  489. OS/2 tries to start this item, it can't find the directory :hp3.\os3\:ehp3. simply
  490. because it should read :hp3.\os2\:ehp3.. A message box is displayed saying an
  491. error occured and that the user input should be corrected.
  492. :p.The messagebox has three buttons that may be pressed:
  493. :dl tsize=22.
  494. :dthd.:hp2.Button
  495. :ddhd.Result:ehp2.
  496. :dt.:hp2.Abort:ehp2.
  497. :dd.PC/2 will be terminated and all unsaved data will be lost. You have to restart
  498. PC\2 again. This button should be the last one you select.
  499. :dt.:hp2.Retry:ehp2.
  500. :dd.The error is ignored, you may need to correct your data entered in the entryfields.
  501. :dt.:hp2.Ignore:ehp2.
  502. :dd.The error is ignored, you may need to correct your data entered in the entryfields.
  503. :edl.
  504. :p.:link reftype=hd res=500.<Backward>:elink.
  505.                                   :link reftype=hd res=2000.<Forward>:elink.
  506.  
  507. :euserdoc.
  508.  
  509.