home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / pc2.zip / PC2.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-03-09  |  24KB  |  472 lines

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