home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / FILEMAN / PC2_180 / PC2.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-01-01  |  71KB  |  1,550 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PC/2 Help for Help ΓòÉΓòÉΓòÉ
  3.  
  4.                      PC/2 - Program Commander/2 Version 1.80
  5.                    for IBM OS/2 2.x, 3.x Presentation Manager
  6.                      Copyright (C) by Stangl Roman 01, 1995
  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.    - Adding a Popup Menu controls 
  20.    - Resorting a (Sub)menu 
  21.    - Run-time parameters 
  22.  
  23. o Setup the Desktop 
  24. o PC/2's Desktop Overview Window 
  25. o PC/2's Spooler control window 
  26. o PC/2's compatibility to other applications 
  27. o Error messages 
  28.  
  29. Note:  PC/2 contains WPS 2 PC/2 in its package. For further information about 
  30. WPS 2 PC/2 select Help from the WPS Object WPS 2 PC/2 itself. WPS 2 PC/2 is 
  31. installed on your Desktop during installation of the PC/2 package. 
  32.  
  33. <Backward>                 <Forward> 
  34.  
  35.  
  36. ΓòÉΓòÉΓòÉ 2. Help for About PC/2 ΓòÉΓòÉΓòÉ
  37.  
  38.                      PC/2 - Program Commander/2 Version 1.80
  39.                    for IBM OS/2 2.x, 3.x Presentation Manager
  40.                      Copyright (C) by Stangl Roman 01, 1995
  41.  
  42. E-Mail: 
  43.  
  44. o InterNet: RSTANGL@VNET.IBM.COM 
  45. o IBM VNET: 61821799 at VIEVMA 
  46. o FidoNet: Roman Stangl @ 2:310/14 LA BAMBA BBS Tel.: (Int. Code +43 +1 
  47.   +6083621) 
  48. o FidoNet: Roman Stangl @ IBM Austria National Support BBS Tel.: (Int. Code +43 
  49.   +1 +21145-6600) 
  50.  
  51. The PC/2 package (consisting of the OS/2 PM application PC/2 and the WPS 
  52. program Object WPS 2 PC/2) is classified as Freeware. Under the copyright, you 
  53. are allowed and encouraged to freely use, distribute or modify this program 
  54. under the following conditions: 
  55.  
  56. o The complete source code and all executables are included. This rule also 
  57.   applies for any modifications you made. 
  58. o You may only charge for the costs of duplicating, distribution on InterNet, 
  59.   FidoNet or similar is preferred therefor. This program must not be sold by 
  60.   immoral "Public Domain & ShareWare" dealers that charge a price far ahead of 
  61.   the actual duplication costs. 
  62. o Any commercial use is prohibited without contacting me prior, except for 
  63.   incorporating the idea/code in any future release of OS/2 by IBM, however 
  64.   this clause doesn't apply for any private use. 
  65. o You don't want to port this utility to MS Windows or Windows NT (Nice Try). 
  66.  
  67. You are encouraged to upload this utility to your favourite file-server or BBS. 
  68. Please ensure that no file is missing, if you change the archive to a different 
  69. compression scheme. 
  70.  
  71. If you find this program useful and want to honor many weeks of work writing 
  72. this utility, you are welcome to send me a small fee of about 50 to 150 
  73. Austrian Schilling (about 5 to 15 dollar) to my home address. Of course you 
  74. don't need to pay again, if a new release of PC/2 comes out. Please send any 
  75. donations in cash, because it makes some troubles to exchange money orders or 
  76. similar in Austria! 
  77.  
  78. Any suggestions are of course welcome too. Because of the Freeware status of 
  79. PC/2 I am not going to send new versions or anything else by mail (which is 
  80. likely to become a never ending story), however I try my best to do support via 
  81. E-Mail! 
  82.  
  83. Thanks to all those, who sent me proposals and bug reports to improve this 
  84. utility! Special thanks to Mario Semo, Carrick von Schoultz and Markus Hof, 
  85. Roman Fischer, Alex Stewart, Ingo Pflanz, Rolf Knebel, Michael Wakunda, Stefan 
  86. Hora, Monte Copeland who gave me advices and/or source code to modify for use 
  87. within PC/2 and/or other support and anyone who makes "undocumented" 
  88. information available. 
  89.  
  90. My home address is: 
  91.  
  92.   Roman Stangl 
  93.   Strebersdorferstrasse 46 
  94.   A-2103  Langenzersdorf, Austria 
  95.  
  96. <Backward>                 <Forward> 
  97.  
  98.  
  99. ΓòÉΓòÉΓòÉ 3. Installing PC/2 ΓòÉΓòÉΓòÉ
  100.  
  101. You have obviously started PC/2 once, because you are reading this help panel. 
  102. The installation is just straight forward with the REXX script that installs 
  103. PC/2, however there are some points to notice: 
  104.  
  105. o The installation installed an icon on the Desktop and started the help panels 
  106.   of PC/2. To ensure that OS/2 starts PC/2 automatically the next time you boot 
  107.   your system, you must start PC/2 again (you then can notice that the 
  108.   background behind the icon changes). If you have added SET 
  109.   RESTARTOBJECTS=STARTUPFOLDERSONLY in your CONFIG.SYS then you must also add a 
  110.   shadow of PC/2 to your startup folder to ensure PC/2 is started the next time 
  111.   you boot OS/2. 
  112.  
  113. o PC/2 requires the files PC2HOOK.DLL and PC2SPOOL.DLL to be accessible. PC/2 
  114.   tries to find this file either in the current directory when the LIBPATH 
  115.   environment variable contains .;), or in a path that is included in the 
  116.   LIBPATH environment variable. PC/2 will not be able to run, if PC2HOOK.DLL 
  117.   can't be loaded or will not be able to provide the PC/2 Spooler Control 
  118.   Window, if PC2SPOOL.DLL can't be loaded. The file PC2.HLP may be either 
  119.   accessible in the directory, where PC/2 is started from, or in a path that is 
  120.   included in the environment variable HELP. If you have problems running PC/2, 
  121.   ensure, that the working directory of PC/2 is accessible by these variables 
  122.   in your CONFIG.SYS. 
  123.  
  124. o The installation assumes that you are using the default profile Pc2.cfg 
  125.   containing a standard pre-defined Popup-Menu. If you want to use an other 
  126.   Popup-Menu, you have to restart PC/2 and add your preferred profile as a 
  127.   commandline option. Click to the next help panel to get more information 
  128.   about commandline parameters. You may also use your favourite editor, to 
  129.   import one profile into another, but you have to ensure, that you don't 
  130.   violate the syntax rules of the profile. 
  131.  
  132. o PC/2 looks for its initialization file PC2.INI in the directory where PC/2 
  133.   was started from. 
  134.  
  135. o You can only run one copy of PC/2 concurrently. 
  136.  
  137. o If you select a DOS or WIN-OS2 Program to be started via PC/2, the time-slice 
  138.   of their sessions is optimized (the DOS-Settings are modified to 
  139.   IDLE_SECONDS=5 IDLE_SENSITIVITY=100) to get a better performance. This is 
  140.   useful for most DOS games. 
  141.  
  142. o You may use PC/2 with or without the WPS installed, you may even use PC/2 as 
  143.   a replacement for the WPS. To do so you must install PC/2 first. Then you 
  144.   have to ensure that PC2HOOK.DLL and PC2SPOOL.DLL are accessible by PC/2. You 
  145.   also have to ensure that PC2.HLP is accessible in the PC/2 directory or in a 
  146.   path pointed to by the HELP environment variable in your CONFIG.SYS file. 
  147.   Then replace the statement 
  148.  
  149.   SET RUNWORKPLACE=C:\OS2\PMSHELL.EXE with 
  150.  
  151.   SET RUNWORKPLACE=[path]PC2.EXE or 
  152.  
  153.   SET RUNWORKPLACE=[directory]PC2.EXE, 
  154.  
  155.   where where [path] is the full pathname of the directory (including the drive 
  156.   letter, e.g. C:\PMAPPS\PC2\PC2.EXE) and [directory] is the pathname of the 
  157.   directory (excluding the drive letter, e.g. \PMAPPS\PC2\PC2.EXE) you 
  158.   installed PC/2. 
  159.  
  160.   Warning: If you specify only the directory you installed PC/2 into, then be 
  161.   sure that this directory is found on your boot drive. 
  162.  
  163.   This feature is useful when using PC/2 as the shell process for an OS/2 
  164.   maintenance setup created by BOOTOS2. See the  compatibility section 
  165.  
  166.   The next time you boot, PC/2 will be started as a replacement for the WPS. Be 
  167.   careful, OS/2 seems to dislike any parameters added to the program that is 
  168.   started as the WPS ! Of course you can start the WPS from a command prompt by 
  169.   typing START PMSHELL or add a corresponding entry to PC/2. 
  170.  
  171.   Caution! PC/2 was not tested on all OS/2 versions or installed software and 
  172.   hardware (simply because I don't have them), so there may be bugs!. 
  173.  
  174. <Backward>                 <Forward> 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 4. General Help for PC/2 ΓòÉΓòÉΓòÉ
  178.  
  179. PC/2 - Program Commander is an addon or replacement for the WPS (Workplace 
  180. Shell). The user can configure a menu that pops up, when mouse button 1 is 
  181. clicked anywhere on the Desktop. From this freely configurable Popup-Menu, you 
  182. can select an entry, which is launched immediately. 
  183.  
  184. PC/2 lets you define Hotkeys too. Pressing the Hotkey defined for a program, 
  185. this program is switched into the foreground or, if it is not already running, 
  186. launched immediately. 
  187.  
  188. PC/2 also allows you to expand the Desktop up to a 81-fold Virtual Desktop, you 
  189. may define Hotkeys to switch to an application on any Virtual Desktop by a 
  190. simple keypress. You may also switch to any Virtual Desktop directly by 
  191. doubleclicking with mouse button 1 on PC/2's Overview Window. p.PC/2 also 
  192. enables you to define a UNIX-style behaviour of switching the input focus from 
  193. one window to another. This allows you to have the input focus in a window, 
  194. which is not the topmost window. 
  195.  
  196. PC/2 additionally provides a simple Spooler interface. You can manage the 
  197. printer queues and jobs on your local machine - a necessity when using PC/2 as 
  198. a WPS replacement (because without the WPS you have no spooler available unless 
  199. you use PC/2's spooler interface). 
  200.  
  201. PC/2 allows you to customize the fonts used by the Popup-Menu, the Overview 
  202. Window and the Spooler window, just by dragging fonts from the Font Palette to 
  203. PC/2. Warning! On some display drivers you may not be able to setup every font 
  204. available in the Font Palette exactly, you may just get a similar font. 
  205.  
  206. For example. the Popup-Menu might look like: 
  207.  
  208. You have selected the item Prompts, which is a Submenu containing seven more 
  209. items. E.g the item OS/2 Window starts a windowed OS/2 command prompt, when 
  210. selected. This Popup-Menu is fully configurable, you may add, change or remove 
  211. items. An item can either be a Submenu containing more items, the name of a 
  212. program or a Menu Control. 
  213.  
  214. The complete Popup-Menu can be modified but the Menu Control Desktop Menu must 
  215. be defined before the Popup-Menu will be displayed after mouse button 1 clicks. 
  216. If you have not defined this Menu Control, the Setup dialog appears after mouse 
  217. button 1 clicks enabling you to add this control. 
  218.  
  219. Your configuration is read from the default profile Pc2.cfg each time PC/2 is 
  220. started and saved every time you made changes. You can of course overwrite the 
  221. default configuration filename to a file named Filename.ext by invoking PC/2 
  222. with the following commandline option: 
  223.  
  224. PC2 [-Profile Filename.ext] or 
  225.  
  226. PC2 [/Profile Filename.ext] 
  227.  
  228. where Filename.ext conforms to a filename of a PC/2 profile. Both FAT and HPFS 
  229. filename naming convention is accepted. A few sample configuration files are 
  230. provided in this package. 
  231.  
  232. As the default, the Popup-Menu appears if you double-click once on the Desktop, 
  233. if no option or the following option is specified: 
  234.  
  235. PC2 [-DoubleClick] or 
  236.  
  237. PC2 [/DoubleClick] 
  238.  
  239. You may select a single-click instead, by invoking PC/2 with the following 
  240. commandline option: 
  241.  
  242. PC2 [-SingleClick] or 
  243.  
  244. PC2 [/SingleClick] 
  245.  
  246. Please be sure not to combine both click behavior options. If you don't specify 
  247. this option a user-modifyable default behaviour is taken from PC2.INI. Of 
  248. course the options changing the click behavior and the configuration filename 
  249. options may be combined. 
  250.  
  251. Because some people use PC/2 as a WPS replacement, PC/2 contains a Menuitem to 
  252. ShutDown OS/2. By selecting this entry, it is safe to power off your PS/2 or PC 
  253. after all disk activity has been stopped, although no windows are closed. If 
  254. you run PC/2 as a WPS replacement and may want to start the WPS either by 
  255. starting PMSHELL.EXE from a command prompt or by starting a PMSHELL Menuitem 
  256. with PC/2. You then can follow the WPS initialization by heavy disk access and 
  257. buildup of your Desktop with objects. PC/2 requires to know the Desktop (in 
  258. technical terms the window handle of the Desktop) to be able to catch mouse 
  259. button 1 clicks. If you start the WPS the Desktop changes too. Therefor PC/2 
  260. checks regularly if the Desktop has changed, so you may have to wait a little 
  261. bit, after the WPS was started, that PC/2 recognizes mouse clicks again.. 
  262.  
  263. I would strongly recommend to start PC/2 during OS/2 boot. If you don't want to 
  264. use the default profile, don't forget to add /Profile Filename.exe to the 
  265. Parameters entryfield in the Settings of PC/2. 
  266.  
  267. The reason why I wrote this utility was primarily, that many programs installed 
  268. on a system require many folders and icons on the Desktop. But to start a 
  269. program, I don't want to open and close folders, so I made shadows on the 
  270. Desktop messing it up. The solution I prefer is to click on the Desktop, 
  271. getting immediately a menu and selecting the application to be launched from 
  272. this menu, or alternatively launch or switch to applications by simply pressing 
  273. a Hotkey. So PC/2 may help you to start your programs more quickly, without 
  274. needing to open and close folders. When running without the WPS installed, you 
  275. even don't have the possibility to launch applications from icons. 
  276.  
  277. <Backward>                 <Forward> 
  278.  
  279.  
  280. ΓòÉΓòÉΓòÉ 5. Concepts of PC/2 ΓòÉΓòÉΓòÉ
  281.  
  282. The basic idea behind PC/2 is to have an configurable Popup-Menu available, to 
  283. start programs quicky, without having to open and close folders. 
  284.  
  285. The Popup-Menu, popped up when you click with mouse button 1 anywhere on the 
  286. Desktop (just like button 2 for the Desktop Menu), consists of so-called items. 
  287. An item may be a Submenu, which contains further items, or the title of an 
  288. Application or Menu Control items. A Submenu contains a little arrow right 
  289. beside the title of the Submenu. Mouse button 1 is on most system the left 
  290. mouse button. 
  291.  
  292. To change the font of the Popup-Menu, drag a font from the Font Palette to the 
  293. smarticon bar of PC/2's Overview Window. This font will be saved when you exit 
  294. PC/2. 
  295.  
  296. You can imagine this Popup-Menu as a tree, with applications as leaves and 
  297. Submenus as nodes. PC/2 allows you to freely build your own tree. To do so you 
  298. have to click on the Desktop with the left mouse button and to select PC/2 
  299. Setup  Config Menu. A dialog box appears, where you can add, modify or remove 
  300. Submenus and Applications. The listbox displays all Submenus and Applications 
  301. of one level (like a cut through the tree). Of course you may change this level 
  302. up and down. 
  303.  
  304. You must have defined the Menu Configure Menu before PC/2 display it's 
  305. Popup-Menu on mouse button 1 clicks. If you don't have defined it, PC/2 
  306. displays it's Setup dialog after each click until you have added this control. 
  307.  
  308. Once you have configured your tree of Submenus and Applications, just press Ok 
  309. to take them into effect and save them to the profile or Cancel to take them 
  310. into effect without saving. 
  311.  
  312. <Backward>                 <Forward> 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 6. Help for starting a program via PC/2 ΓòÉΓòÉΓòÉ
  316.  
  317. After you have configured the PC/2 Popup-Menu, you click on the Desktop with 
  318. mouse button 1, select the Application you want to start and click on it. The 
  319. Application will be started as if you were clicking on an icon. 
  320.  
  321. One advantage starting an Application this way is, that you can manipulate many 
  322. parameters on how the Application is started, one thing you can't do with many 
  323. icons. E.g you can start it invisible (useful for a backup program), making it 
  324. only visible by selecting it from the window list. You may also specify the 
  325. size of the Application or to start it in the background. You can even set it's 
  326. priority or define a Hotkey to switch to it. 
  327.  
  328. You can also start WPS Objects that are not Folder (WPFolder class) or Program 
  329. (WPProgram class) type WPS Objects, if they have an ObjectID defined. Most OS/2 
  330. WPS Objects get installed with a predefined ObjectID by default during 
  331. installation (see OS2_20.RC for a more detailed information), and many 
  332. applications (e.g. IBM C Set++, Toolkit, ...) defined an ObjectID for their WPS 
  333. Objects too. 
  334.  
  335. Folder or Program WPS Objects and other WPS Objects that have defined an 
  336. ObjectID, can be dumped automatically by WPS 2 PC/2 to create corresponding 
  337. Popup-Menu entries. 
  338.  
  339. You can also open any WPS Folder by PC/2 after dragging the folder onto PC/2 to 
  340. create a corresponding menuentry. 
  341.  
  342. Warning: You can start WPS Objects via their ObjectID and open folders only if 
  343. the WPS is running, because only the WPS can process the request made by PC/2 
  344. to open them. 
  345.  
  346. To close an Application, select the corresponding option from the Application 
  347. or terminate it from the Window List. Alternatively you may use PC/2's Kill 
  348. smarticon to close the application's window. 
  349.  
  350. <Backward>                 <Forward> 
  351.  
  352.  
  353. ΓòÉΓòÉΓòÉ 7. Help for PC/2 Setup ΓòÉΓòÉΓòÉ
  354.  
  355. In the listbox, all Submenus and Applications of one level (imagine as a cut 
  356. through the tree) are displayed. A Submenu has an arrow right beside it. E.g 
  357. assume the listbox contains 6 Submenus and 2 Applications resulting in the 
  358. following Popup-Menu: 
  359.  
  360. Select the item Config Menu to configure the items appearing in the Popup-Menu. 
  361. The Setup dialog appears allowing you to adjust all items of the current level. 
  362.  
  363. You may want to get into the Submenu Prompts. Just select the Submenu Prompts 
  364. an click on the button Level Down >>. The listbox will now be filled with all 
  365. Submenus and Applications of the Submenu Prompts. To get one level up, simply 
  366. press << Level Up. If nothing seems to change, you may be either at the highest 
  367. level (the root of the tree) or at the deepest level (a leaf of the tree) of a 
  368. Submenu. 
  369.  
  370. To configure the Popup-Menu just select an item and/or invoke functions by 
  371. selecting the following pushbuttons.. 
  372.  
  373. Pushbutton: Description: 
  374.  
  375. Level Down  After selecting a Submenu click on Level Down. The listbox contents 
  376.             are replaces with the Menuentries of the Submenu. 
  377.  
  378.             You may alternatively doubleclick on a Submenu to change into. 
  379.  
  380. Level Up    Selecting Level Up chains up into the next upper Submenu level, 
  381.             unless the root level is reached. 
  382.  
  383. Add Submenu To add a Submenu press the button Add Submenu. The Menu 
  384.             Installation dialog is displayed allowing you to add a new Submenu. 
  385.             After pressing Ok in that dialog, the Submenu will be inserted 
  386.             after the selected item, or at the end of the list if no item was 
  387.             selected. 
  388.  
  389. Add Program To add an application press the button Add Program. The Program 
  390.             Installation. dialog is displayed allowing you to add a new 
  391.             Application. After pressing Ok in that dialog, the Application will 
  392.             be inserted after the selected item, or at the end of the list if 
  393.             no item was selected. 
  394.  
  395. Add Control To add a Control press the button Add Control and a dialog appears 
  396.             allowing you to add Menu Controls predefined by PC/2. 
  397.  
  398. Change Entry To change a Menuentry that corresponds to an executable 
  399.             application, select the application and then invoke Change Entry to 
  400.             display the Program Installation dialog. 
  401.  
  402.             Alternatively you may just doubleclick on a Menuentry, to display 
  403.             the Program Installation dialog. 
  404.  
  405. Remove Entry .To remove an application or an empty Submenu, select the Menuitem 
  406.             and click on the button Remove Entry. 
  407.  
  408. Resort Menu To resort a Submenu press the button Resort Menu. A new dialog is 
  409.             displayed allowing you to resort the currently listed Submenu. 
  410.             Press here to get more information about the Resort dialog. 
  411.  
  412. If the listbox is empty, you can't remove or change anything. You also can't 
  413. select any item, but in this case you can add a Submenu or an Application by 
  414. just pressing the buttons, without needing to select an item. 
  415.  
  416. (WPS 2 PC/2's icon) By using the listbox on this dialog page together with WPS 
  417.             2 PC/2, you can easyly convert WPS Objects into menuitems for 
  418.             PC/2's Popup-Menu. Assuming that you have extracted details about 
  419.             WPS Objects by dropping them onto WPS 2 PC/2's icon on the Desktop, 
  420.             just drag them from WPS 2 PC/2's Status bitmap and drop it onto the 
  421.             Submenu/Program Configuration listbox. PC/2 then generates 
  422.             Popup-Menu items automatically and adds them to your Popup-Menu. 
  423.             This lets you copy the settings of WPS Objects easyly, without 
  424.             entering them manually. 
  425.  
  426.             For more information about WPS 2 PC/2 just select help from the WPS 
  427.             2 PC/2 WPS Object, which you can install by PC/2's installation 
  428.             program, if it is missing. 
  429.  
  430. Press Ok to write the configuration to the profile, or press Cancel to keep the 
  431. changes only in memory. Both buttons will dismiss the dialog. 
  432.  
  433. Example 1    Example 2 
  434.  
  435. <Backward>                 <Forward> 
  436.  
  437.  
  438. ΓòÉΓòÉΓòÉ 7.1. Setup example 1 ΓòÉΓòÉΓòÉ
  439.  
  440. Assume the listbox contains the following items resulting in the following 
  441. Popup-Menu: 
  442.  
  443. You want to remove the Submenu References, rename the Submenu Tools to 
  444. Utilities and add a Submenu Demos. 
  445.  
  446.  1. Select the item References. You can now press the button Remove Entry to 
  447.     remove the submenu, but only if this Submenu is empty. If it isn't empty, 
  448.     get into this Submenu by pressing Level Down >> and remove all items. 
  449.  2. To rename Tools to Utilities select the item Tools and press the button 
  450.     Change Entry. A dialog box appears allowing you to rename this item. 
  451.  3. Select the item, after which you want to insert the new Submenu. Then press 
  452.     the button Add Submenu to add one. A dialog box appears allowing you to 
  453.     enter the title of a new Submenu. 
  454.  
  455.  
  456. ΓòÉΓòÉΓòÉ 7.2. Setup example 2 ΓòÉΓòÉΓòÉ
  457.  
  458. Assume that you have remove all items, leading to an empty listbox. Now you 
  459. want to add the Applications Backup and Terminal. 
  460.  
  461.  1. The listbox is empty, so you can't select any item. Just press the button 
  462.     Add Program and a dialog box appears, allowing you to enter all the data 
  463.     required for the new Application. 
  464.  2. Now the listbox contains the item Backup, select it and press the button 
  465.     Add Program a second time. Again you get a dialog box, where you enter the 
  466.     data for the Application Terminal. 
  467.  
  468.  
  469. ΓòÉΓòÉΓòÉ 8. Help for PC/2 Menu Installation ΓòÉΓòÉΓòÉ
  470.  
  471. This dialog is used to get a name for a Submenu, which is then added to the 
  472. Popup-Menu. You can enter whatever you like, e.g to make a Submenu that 
  473. contains OS/2 utilities you might enter Utilities. 
  474.  
  475. If you have chosen in the previous dialog to change the name of a Submenu, then 
  476. overwrite the pre-entered text. 
  477.  
  478. Press Ok to accept, or press Cancel to ignore the data you entered. 
  479.  
  480. Examples 
  481.  
  482. <Backward>                 <Forward> 
  483.  
  484.  
  485. ΓòÉΓòÉΓòÉ 8.1. Menu installation examples ΓòÉΓòÉΓòÉ
  486.  
  487. Assume you have entered the following Submenu Titles: 
  488.  
  489. Title:      Purpose: 
  490.  
  491. Prompts     You want to add a Submenu named Prompts, that contains OS/2 and 
  492.             DOS, fullscreen and windowed command prompts. 
  493.  
  494. Spreadsheets You want to add a Submenu named Spreadsheets for your spreadsheet 
  495.             program like Lotus 123/G or Excel. 
  496.  
  497.  
  498. ΓòÉΓòÉΓòÉ 9. Help for PC/2 Program Installation ΓòÉΓòÉΓòÉ
  499.  
  500. This dialog is a notebook consisting of the following pages: 
  501.  
  502. Page:       Tab title: 
  503.  
  504. Application This page is used to define an application's title, path, filename, 
  505.             working directory, command-line parameters and DOS settings. 
  506.  
  507. Session     This page determines the type of session you want to add. Select 
  508.             between PM, OS/2, DOS and WIN-OS2 sessions. 
  509.  
  510. Style       This page can be used to define the appearance of an application. 
  511.             If the application doesn't overwrite attributes, you may define the 
  512.             style, size and position. 
  513.  
  514. Hotkey      This page is used to define a Hotkey, which will switch to the 
  515.             application and bring it into the foreground. 
  516.  
  517. Priority    This page can be used to overwrite the default priority assigned to 
  518.             an application. 
  519.  
  520.             Caution: Changing the priority may cause serious problems, because 
  521.             the application may be set to consume nothing to the full CPU 
  522.             time!. 
  523.  
  524.  
  525. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  526. notebook pages. 
  527.  
  528. For more information click about on one of the above notebook pages select: 
  529.  
  530. o Application Settings 
  531. o Session Settings 
  532. o Style Settings 
  533. o Hotkey Settings 
  534. o Priority Settings 
  535.  
  536. Example 1 
  537.  
  538. <Backward>                 <Forward> 
  539.  
  540.  
  541. ΓòÉΓòÉΓòÉ 9.1. Application Settings ΓòÉΓòÉΓòÉ
  542.  
  543. This dialog is used to get the title, the path and filename, the working 
  544. directory and parameters of a Menuitem, which is then added to the Popup-Menu. 
  545.  
  546. For a normal user it is the easiest way to use the following guidelines. 
  547. According to the type of application you add, some fields may not be editable 
  548. or visible: 
  549.  
  550. Fieldname:  You would enter: 
  551.  
  552. Program Title: Here you enter the name which should appear on the 
  553.             applications's titlebar, which may be overwritten by some 
  554.             applications. For OS/2 and DOS windows, this will also be the title 
  555.             in the window list. You may also name the Objects here, you want to 
  556.             add. 
  557.  
  558.             For better navigation through the Popup-Menu, you may add a tilde 
  559.             (~). When a menuentry has a tilde before a letter, the letter is 
  560.             treated as a mnemonic. After activating the Popup-Menu, you can 
  561.             type a mnemonic defined for a session to start it, instead of 
  562.             selecting it with the mouse or keyboard. 
  563.  
  564.             When defining a mnemonic ensure that the entryfield Session Name on 
  565.             page Hotkey Settings is filled correctly. 
  566.  
  567. Path and Filename: Here you enter the fully qualified path and filename. E.g 
  568.             you might enter c:\os2\cmd.exe to obtain an OS/2 command prompt, or 
  569.             c:\os2\mdos\qbasic.exe to start the basic interpreter. 
  570.  
  571.             Here you also enter the name of WPS Objects. WPS Objects are 
  572.             referred either by their defined Object ID (Identity) e.g 
  573.             <WP_DRIVES> or <WP_INST> for preinstalled Objects, of e.g 
  574.             <WP_USER_CALC> or <WP_WIN_PBRUSH> which can be extracted by the WPS 
  575.             2 PC/2 WPS Object, unless they represent Folder or Program objects 
  576.             (then their settings are taken instead of their ObjectID which may 
  577.             be available too). Preinstalled WPS Objects have usually a defined 
  578.             name, you may need to take a look into the file OS2_20.RC to get 
  579.             further information. 
  580.  
  581.             PC/2 can only launch WPS Objects named by their defined ID, so be 
  582.             careful to get either the correct ID from OS2_20.RC or by 
  583.             extracting the WPS Object in question by WPS 2 PC/2 You can't use 
  584.             the Program Template to create Objects if you want them to add to 
  585.             PC/2, because PC/2 can't define the Object ID of such Objects, try 
  586.             to use any installation routine that probably creates a Program 
  587.             object with an ObjectID. 
  588.  
  589.             Here you would also enter the path and filename of a seamless 
  590.             WIN-OS2 application. WIN-OS2 applications prefixed by a ! 
  591.             immediately before the filename get started minimized, applications 
  592.             prefixed by a ^ get started maximized. To start more than one 
  593.             application, separate applications by a ,. (By the way, this is a 
  594.             feature of OS/2 and should be therefor also available for your 
  595.             WIN-OS2 WPS Objects!) 
  596.  
  597. Working Directory: Here you enter the directory where the EXE, HLP and DLL 
  598.             files of your application are located. Before the application is 
  599.             started, a change drive and change directory call is made, to make 
  600.             this directory the working directory. 
  601.  
  602. Parameters: Here you enter the parameters passed to the application. PC/2 
  603.             allows you to be asked for commandline parameters before the 
  604.             application is invoked. Press on Commandline Parameters to find out 
  605.             more about this feature. Assume that you want to use VIEW.EXE to 
  606.             view the command reference, you would enter c:\os2\book\cmdref.inf. 
  607.  
  608.             If you have selected the WIN-OS2 Program Manager PROGMAN.EXE to be 
  609.             started as a seamless WIN-OS2 application, you may enter 1 and only 
  610.             1 additional WIN-OS2 application, that will be started by the 
  611.             Program Manager in the same WIN-OS2 session. The Program Manager 
  612.             itself will be started minimized. You may also change the 
  613.             application's style by using !, ^ and , characters as described in 
  614.             Path and Filename. 
  615.  
  616. DOS Settings: Selecting this pushbutton opens the standard OS/2 DOS settings 
  617.             dialog (OS/2 DOS support must be installed of course). You can then 
  618.             customize the DOS settings exactly as you whould do with a WPS 
  619.             program Object. The settings are then set into the multiline 
  620.             entryfield. You can of course write them by hand, but this is 
  621.             discouraged, because of spelling mistakes easily made. DOS settings 
  622.             are valid for DOS applications, and WIN-OS2 is just a special DOS 
  623.             application too. By default for a new DOS application the DOS 
  624.             Settings IDLE_SECONDS=5 and IDLE_SENSITIVITY=100 are defined. 
  625.  
  626.             As seamless WIN-OS2 sessions are also DOS type sessions, you may 
  627.             strongly want to adjust the Settings of WIN-OS2 sessions for better 
  628.             WIN-OS2 performance than the default settings, e.g you may want to 
  629.             increase the memory by adding DPMI_MEMORY_LIMIT=8. 
  630.  
  631. File Find:  If you click on this button, the standard file dialog of OS/2 is 
  632.             displayed where you can select the application you want to install. 
  633.             The application parameters (e.g path) will then be inserted 
  634.             automatically in the corresponding entryfields. 
  635.  
  636. Drag & Drop: You can alternatively use the Drag & Drop operation to create a 
  637.             Program Popup-Menu entry. There are 3 basic kind of objects you may 
  638.             want to drop onto this notebook page: 
  639.  
  640.             1. Program objects, which are *.EXE or *.COM files of PM, OS/2 
  641.             windowed, DOS or WIN-OS2 applications. Just select one application 
  642.             from e.g a Drives object or from a filemanager, drag it into the 
  643.             dialog over any area that accepts it and drop it. 
  644.  
  645.             2. Batch file objects, which are *.CMD or *.BAT type batch files 
  646.             for OS/2 and DOS command processors (CMD.EXE and COMMAND.COM). 
  647.             These batch files are automatically installed to be run through a 
  648.             copy of their command processors (see the online OS/2 command 
  649.             reference for more information about CMD.EXE and COMMAND.COM). 
  650.  
  651.             3. WPS Folder Objects, which are opened by the WPS on request of 
  652.             PC/2, when selected from the Popup-Menu. If the WPS is not running, 
  653.             PC/2 can't open menuentries of this type. 
  654.  
  655.             You can't create a menuentry for any object of a different type by 
  656.             dropping them onto this dialog, you have to use WPS 2 PC/2 in this 
  657.             case. Data extracted from the WPS by WPS 2 PC/2 can then be dropped 
  658.             onte PC/2's Setup dialog. 
  659.  
  660.             The notebook settings will be adjusted according to the application 
  661.             you dragged into. 
  662.  
  663. For a power user, the data entered may be less. Because the OS/2 API 
  664. DosStartSession() is used to start the application, all rules for this API 
  665. apply as described in the toolkit. Hence you may leave the entryfield Path and 
  666. Filename blank and then select from the Session Settings group an OS/2 or DOS 
  667. fullscreen or window, to get a command prompt. 
  668.  
  669. You may also start an application indirectly through a secondary command 
  670. processor by specifying c:\os2\cmd.exe as the Path and Filename and use then 
  671. the /C or /K option of CMD.EXE in the Parameters entryfield. 
  672.  
  673. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  674. notebook pages. 
  675.  
  676.  
  677. ΓòÉΓòÉΓòÉ 9.2. Session Settings ΓòÉΓòÉΓòÉ
  678.  
  679. Here you can select the type of application you want to add. By default, PC/2 
  680. tries to determine the type of an application you installed via the standard 
  681. file dialog or via Drag & Drop. 
  682.  
  683. Option:     Description: 
  684.  
  685. Determined by WPS This default selection lets the WPS choose the type of 
  686.             application when started. 
  687.  
  688. OS/2 Full-Screen The seesion is a command session, started in full-screen. 
  689.  
  690. OS/2 Window The session is a command session, started in a window on PM. 
  691.  
  692. Presentation Manager The session is graphical PM application. 
  693.  
  694. DOS Full-Screen The session is a DOS command session, started in full-screen. 
  695.  
  696. DOS Window  The session is a DOS command session, started in a window on PM. 
  697.  
  698. WPS Object  The Object-ID of the WPS Object to be started is contained in the 
  699.             entryfield Path and Filename:. The session can only be started when 
  700.             the Object-ID is assigned. 
  701.  
  702. Seamless WIN-OS2 The session is a seamless WIN-OS2 session. Be sure that your 
  703.             graphics adapter supports such sessions. Currently all seamless 
  704.             WIN-OS2 sessions are seperate sessions. 
  705.  
  706. Real Mode   The seamless WIN-OS2 session is started in Real Mode. Real Mode 
  707.             compatibility is only provided by OS/2 2.0. 
  708.  
  709. Standard Mode The seamless WIN-OS2 session is started in Standard Mode. 
  710.  
  711. 386 Enhanced Mode The seamless WIN-OS2 session is started in 386 Enhanced Mode. 
  712.             386 Enhanced mode compatibility is only provided by OS/2 2.1. 
  713.  
  714. Separate Session When checked, the seamless WIN-OS2 session in Standard Mode or 
  715.             386 Enhanced Mode is started in a separate session (loading another 
  716.             copy of the WIN-OS2 environment) otherwise the session is started 
  717.             into a common WIN-OS2 session (loading the WIN-OS2 environment only 
  718.             once). 
  719.  
  720. You generally have to verify, that the Program Type setting corresponds to the 
  721. application you installed, for most programs you can use Determined by WPS if 
  722. you aren't sure. 
  723.  
  724. According to the Program Type that is selected, some settings may not be 
  725. editable or visible. 
  726.  
  727. OS/2 and DOS Fullscreen or Windows are only used, if you want to start a 
  728. command prompt as the application. In this case, you usually enter in the the 
  729. entryfield Path and Filename of the group Program Data the path of the 
  730. corresponding command processor. A advanced technique to select the type of 
  731. command processor only with these radiobuttons is described under the group 
  732. Program Type. 
  733.  
  734. To add a seamless WIN-OS2 session without a corresponding WPS Object defined, 
  735. select the Seamless WIN-OS2 radiobutton. Another group of buttons will be 
  736. enabled, allowing you the select the Settings of the WIN-OS2 session. Although 
  737. there is a Separate Session checkbox, seamless WIN-OS2 sessions will currently 
  738. always be started as separate sessions. 
  739.  
  740. Warning: Under OS/2 2.0 GA, seamless WIN-OS2 sessions may only be started with 
  741. the WPS running, otherwise the system hangs. There seems also to be a problem 
  742. with a real mode session, because such a WIN-OS2 session starts to load, but 
  743. doesn't finish successfully. Under OS/2 2.1 GA you may start seamless WIN-OS2 
  744. session with or without the WPS installed. 
  745.  
  746. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  747. notebook pages. 
  748.  
  749.  
  750. ΓòÉΓòÉΓòÉ 9.3. Style Settings ΓòÉΓòÉΓòÉ
  751.  
  752. You can select one of the radiobuttons and any of the checkboxes to define the 
  753. style the application should be started with. 
  754.  
  755. Some applications overwrite the default style settings, i. e. by reading them 
  756. from a profile. PC/2 can't force such applications to accept the styles you 
  757. selected. 
  758.  
  759. Option:     Description: 
  760.  
  761. Application defined The default style defined by the session itself is used. 
  762.  
  763. Maximized   The session's default style is modified to maximized. 
  764.  
  765. Minimized   The session's default style is modified to minimized. 
  766.  
  767. Invisible   The window created by the application is invisible. 
  768.  
  769. No Autoclose The window created by the application is not terminated when the 
  770.             application shuts down. 
  771.  
  772. Background  The window is created in the background. 
  773.  
  774. Autostart   A session marked with this setting will by started automatically by 
  775.             PC/2 during PC/2's invokation. This feature works similar as the 
  776.             startup folder of the WPS. 
  777.  
  778. User defined Size & Position The session's default size and position is 
  779.             modified to the values entered. PC/2 forces the window to the 
  780.             entered position, even when the application overwrites these 
  781.             values. You may specify a position relative to the origin of the 
  782.             Virtual Desktops (the "middle" Desktop of the 9 Virtual Desktops), 
  783.             useful when the. Virtual Desktop feature is enabled. 
  784. g if you selected Minimized, Invisible and Background buttons, the application 
  785. will be started minimized, in the background and invisible (this may make sense 
  786. for a backup program). 
  787.  
  788. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  789. notebook pages. 
  790.  
  791.  
  792. ΓòÉΓòÉΓòÉ 9.4. Hotkey Settings ΓòÉΓòÉΓòÉ
  793.  
  794. PC/2 supports the definition of Hotkey, to switch from the current application 
  795. to a certain application just by pressing a Hotkey. If the Hotkeyed session is 
  796. on another Virtual Desktop, PC/2 switches to this Desktop and switches the 
  797. application into the foreground. PC/2 supports 0 ... 9 in combination with 
  798. either the Ctrl-Key or the Alt-Key as Hotkeys giving you 20 different Hotkeys 
  799. at maximum. 
  800.  
  801. If PC/2 can't detect the application running, the pressed Hotkey is defined 
  802. for, it starts the application as if it was invoked by PC/2's Popup-Menu. 
  803. Starting applications by pressing a Hotkey is another alternative invoking 
  804. programs delivered by PC/2. 
  805.  
  806. PC/2 allows you to mark the application as non-movable around the Virtual 
  807. Desktop. By defining this style the application always keeps on the active 
  808. Desktop, regardless to which Virtual Desktop you are switching to. 
  809.  
  810. Control:    Description: 
  811.  
  812. Session name If you either have marked the application as non-movable, defined 
  813.             a Hotkey or a mnemonic, you must fill this entryfield with a string 
  814.             that equals or is part of, of either the applications name on it's 
  815.             titlebar or the applications name in the Window List. If you use 
  816.             one of the two features and you leave the entryfield empty, PC/2 
  817.             copies the string from Program Title entryfield when you press Ok. 
  818.             after removing the tilde defined for the mnemonic. 
  819.  
  820.             Be sure that the string you entered matches only with the current 
  821.             application, because the first match of this string with any 
  822.             applications's titlebar or it's entry in the window list will be 
  823.             taken. You may want to start your application without these options 
  824.             first, to get it's titlebar name or it's entry in the window list. 
  825.  
  826.             I strongly recommend to fill in this entryfield if you experience 
  827.             unexpected results. PC/2 uses the session name to identify the 
  828.             current sessions from all running sessions. 
  829.  
  830. Keep on active Desktop Checking this flags keeps the application always on the 
  831.             current Desktop regardless to which Virtual Desktop you move. 
  832.  
  833. Enable Hotkey This flag defines you want to define a Hotkey for this 
  834.             application. The controls necessary to define the Hotkey will be 
  835.             enabled. 
  836.  
  837. Default     Once you pressed the Hotkey the Desktop is switched to the Virtual 
  838.             Desktop the application is located on and activates it. 
  839.  
  840. Maximized   The same as for Default is done, but the applications window is 
  841.             maximized too. 
  842.  
  843. Restore     The same as for Default is done, but the applications window is 
  844.             restored too. 
  845.  
  846. Ctrl-Key    You define a Hotkey which ranges from 0 ... 9 and A ... Z in 
  847.             conjunction with the Ctrl-Key. 
  848.  
  849. Alt-Key     You define a Hotkey which ranges from 0 ... 9 and A ... Z in 
  850.             conjunction with the Alt-Key. 
  851.  
  852.             You must select a key in the range between 0 and 9 or A ... Y from 
  853.             the drop down box which in conjunction with the Ctrl-key or Alt-key 
  854.             is used to switch to the application. You can define this way 72 
  855.             different keys as the maximum. 
  856.  
  857.             OS/2 and DOS windows modify the keys pressed in such a way, that 
  858.             PC/2 is not able to detect them. If you wand to switch from such a 
  859.             window, change the focus to another window, for example to the 
  860.             Window List by pressing CTRL+ESC. 
  861.  
  862.             Even if a Hotkey is defined, you may 
  863.  
  864.             Caution!  All keys defined as Hotkeys in PC/2 are no longer 
  865.             available for other applications, because once a key is defined as 
  866.             Hotkey no other application except PC/2 gets this key. This is a 
  867.             limitation of the Hotkey feature, because only this way PC/2 can 
  868.             ensure that if a Hotkey is defined, the Desktop switches to this 
  869.             application. The Hotkey launches the application, if the 
  870.             application, the Hotkey is defined for, is not running. If you need 
  871.             a certain key, which is defined as a Hotkey in PC/2, change the 
  872.             Hotkey to an unused key. 
  873.  
  874.             Even if a Hotkey is defined, you may pass this key to a 
  875.             application, when the SHIFT-key is pressed and hold before the 
  876.             Hotkey. When PC/2 detects SHIFT is pressed together with the 
  877.             Hotkey, it ignores the Hotkey by passing it the the application 
  878.             that currently has the focus. 
  879.  
  880. Current Window List To define the style non-movable or the Hotkey you may start 
  881.             the application first without these options and gets its titlebar 
  882.             name from it's window or it's window list name from the Current 
  883.             Window List. 
  884.  
  885. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  886. notebook pages. 
  887.  
  888.  
  889. ΓòÉΓòÉΓòÉ 9.5. Priority Settings ΓòÉΓòÉΓòÉ
  890.  
  891. PC/2 allows you to specify the priority of the applications you start via the 
  892. Popup-Menu. OS/2 has the following priority classes and deltas defined to 
  893. select from: 
  894.  
  895. Priority Class: Description: 
  896.  
  897. Idle time   Idle-time is the lowest priority class a session or thread can run 
  898.             under OS/2. You may use this option for task that should only be 
  899.             performed if enough CPU-resource is available, i.e. for a 
  900.             background NFS (Network File System) Server or BBS. 
  901.  
  902. Regular     If not specified otherwise the priority class Regular is the 
  903.             default class of all sessions and threads. For these default class 
  904.             the priority delta of 0 is default. 
  905.  
  906. No Change   This option just doesn't change the priority. The application is 
  907.             started with the priority class Regular and priority delta 0. 
  908.  
  909. Time Critical Time-critical priority class is used for time-critical sessions. 
  910.             Examples may be real-time data acquisition. 
  911.  
  912. Foreground Server Foreground Server is the highest priority class available 
  913.             that should be only used for small assembly language applications 
  914.             because they really eat up the CPU time. 
  915.  
  916. Priority Delta The priority delta selectable between 0 and 31 is defined for 
  917.             each priority class. I.e. a session with Regular priority class and 
  918.             priority delta 25 has a lower priority than a session with 
  919.             Time-critial priority class and priority delta 3. 
  920.  
  921. Extreme caution!  Changing the priority from the default selection may cause 
  922. serious performance impacts on your system. Be very carefully when selecting 
  923. higher priorities, because the higher the priority the higher the CPU 
  924. time-slice a session consumes deteriorating overall system performance. You 
  925. can't change the priority of DOS session (and WIN-OS2 sessions are DOS 
  926. sessions) because allowing this would lock PM for unknown reasons. 
  927.  
  928. For example if you set an OS/2 command prompt to a Time-critical priority, you 
  929. may not be able to switch to other sessions until the command prompt is waiting 
  930. for input. 
  931.  
  932. Press Ok to accept, or press Cancel to ignore the data you entered in all 
  933. notebook pages. 
  934.  
  935.  
  936. ΓòÉΓòÉΓòÉ 9.6. Program installation example 1 ΓòÉΓòÉΓòÉ
  937.  
  938. Assume you want to add Lotus 123/G: 
  939.  
  940. Fieldname:  You would enter: 
  941.  
  942. Program Title: Lotus 123/G 
  943.  
  944. Path and Filename: c:\123g\123g.exe 
  945.  
  946. Working Directory: c:\123g 
  947.  
  948. Parameters: (none) 
  949.  
  950. Lotus 123/G is a Presentation Manager application so you would select 
  951. Presentation Manager as program type. The program style may be Maximized, 
  952. because more information is visible. The priority may be left at the default 
  953. selection No Change. 
  954.  
  955. Assume you want to add the WPS Object System Clock (located in the folder OS/2 
  956. System  System Setup): 
  957.  
  958. Fieldname:  You would enter: 
  959.  
  960. Program Title: System Clock 
  961.  
  962. Path and Filename: <WP_CLOCK> 
  963.  
  964. Working Directory: (n/a) 
  965.  
  966. Parameters: (n/a) 
  967.  
  968. The System Clock is a WPS Object, so WPS Object is selected as the program 
  969. type. You may have to look into the file OS2_20.RC to get the defined name of 
  970. preinstalled WPS Objects. Most settings are not available for WPS Objects. 
  971.  
  972. Assume you want to add the WPS clock object with the ObjectID <WP_CLOCK>. First 
  973. you must extract the ObjectID by using WPS 2 PC/2. Then drag the extracted 
  974. object from the WPS 2 PC/2 window onto PC/2's Setup dialog, to create a 
  975. menuentry within the Popup-Menu. After you have created the clock menuentry, 
  976. you can view its settings by editing the menuentry: 
  977.  
  978. Fieldname:  You would enter: 
  979.  
  980. Program Title: System Clock 
  981.  
  982. Path and Filename: <WP_CLOCK> 
  983.  
  984. Working Directory: (n/a) 
  985.  
  986. Parameters: (n/a) 
  987.  
  988. The System Clock is a WPS Object, so WPS Object is used as the program type. 
  989. Assuming that you extracted the ObjectID as outlined before, then the Object ID 
  990. is <WP_CLOCK>. 
  991.  
  992. Sorry, this may be a little complicated, but it is the only way to get a known 
  993. Object ID. 
  994.  
  995. Assume you want to add the WIN-OS2 Program Manager. Open the Program 
  996. Installation dialog, and either enter the path information (e.g 
  997. c:\os2\mdos\winos2\progman.exe) or drag PROGMAN.EXE into. If you have entered 
  998. the data manually, you also must check the seamless WIN-OS2 session. Further 
  999. assume that you want in the same WIN-OS2 session also start the WIN-OS2 File 
  1000. Manager WINFILE.EXE, then you add it to the Parameters entryfield: 
  1001.  
  1002. Fieldname:  You would enter: 
  1003.  
  1004. Program Title: Prog & File Manager 
  1005.  
  1006. Path and Filename: c:\os2\mdos\winos2\progman.exe 
  1007.  
  1008. Working Directory: c:\os2\mdos\winos2 
  1009.  
  1010. Parameters: winfile.exe 
  1011.  
  1012. You can only add a Parameter to the WIN-OS2 Program Manager, and only one. 
  1013.  
  1014.  
  1015. ΓòÉΓòÉΓòÉ 10. Help for PC/2 Control Addition ΓòÉΓòÉΓòÉ
  1016.  
  1017. This dialog allows you to add Menu Control items to PC/2's Popup-Menu. Except 
  1018. for Break Separator and Menu Separator you may only add 1 instance of the Menu 
  1019. Control to the Popup-Menu. The Menu Control Configure Popup-Menu Settings must 
  1020. be added to the Popup-Menu in order that PC/2 displays the Popup-Menu after 
  1021. mouse button 1 clicks, otherwise the Setup dialog will be invoked after each 
  1022. mouse click until you have added this Menu Control. PC/2 supports the following 
  1023. Menu Controls: 
  1024.  
  1025. Control:    Description: 
  1026.  
  1027. Menu Settings This button is used to add the Menu Control to be able to 
  1028.             configure the Popup-Menu via the Setup dialog. 
  1029.  
  1030. Desktop Settings This button is used to add the Menu Control to configure the 
  1031.             Virtual Desktop feature. 
  1032.  
  1033. About PC/2  This button adds the About PC/2 Menu Control. 
  1034.  
  1035. ShutDown OS/2 This button adds a Menu Control, which when selected displays a 
  1036.             message box allowing you to shutdown OS/2 just be clicking on Ok or 
  1037.             pressing the Enter key. 
  1038.  
  1039. Help        This button add the online help Menu Control item. 
  1040.  
  1041. Exit        This button is used to add the Menu Control to be able to exit PC/2 
  1042.             via a message box by just clicking on Ok or pressing the Enter key. 
  1043.  
  1044. Break Separator This button is used to add one break separator Menu Control. 
  1045.             You may add this Menu Control to convert a large single-column menu 
  1046.             to a smaller multi-column menu. This Control is a Menu Control that 
  1047.             you may add as often you prefer. I suggest to use this Control only 
  1048.             to break Menuitems not being a Submenu. 
  1049.  
  1050. Menu Separator This button is used to add one separator Menu Control. You may 
  1051.             add this Menu Control to enhance the readability of the Popup-Menu. 
  1052.             This Control is a Menu Control that you may add as often you 
  1053.             prefer. 
  1054.  
  1055. Press Ok to accept or press Cancel to ignore the your modifications. 
  1056.  
  1057. <Backward>                 <Forward> 
  1058.  
  1059.  
  1060. ΓòÉΓòÉΓòÉ 11. Help for PC/2 Resort ΓòÉΓòÉΓòÉ
  1061.  
  1062. This dialog box contains two listboxes, the left one that displays the 
  1063. currently available Menuentries and the right one that displays the currently 
  1064. resorted Menuentries. Select the first Menuentry from the left listbox and 
  1065. press the Reorder button, to resort it to the right listbox. For the next 
  1066. Menuentry(ies) repeat this procedure, until the left listbox is empty. Instead 
  1067. of selecting a Menuentry and then clicking on the Reorder button, you may 
  1068. doubleclick on a Menuentry. 
  1069.  
  1070. You can cancel the resort before you have done any sort, but you have to resort 
  1071. the complete Submenu once you made one resort operation. 
  1072.  
  1073. All sorted Menuentries in the right listbox can't be started with PC/2 until 
  1074. you complete the resort by pressing OK. Warning! - You have to press OK in the 
  1075. Setup Dialog to write the resorted Menuentries structure to the configuration 
  1076. file. 
  1077.  
  1078. <Backward>                 <Forward> 
  1079.  
  1080.  
  1081. ΓòÉΓòÉΓòÉ 12. Help for PC/2 Startup Parameters ΓòÉΓòÉΓòÉ
  1082.  
  1083. PC/2 allows you to replace the commandline parameters of your application 
  1084. completly or partly. 
  1085.  
  1086. E.g assume you have a TCP/IP communications package installed on your system. 
  1087. You also have added an Menuitem that start a file transfer program named FTP. 
  1088. FTP requires as a parameter the name of the host you want to connect to. To 
  1089. prompt you for this parameter immediately before FTP is started, you would 
  1090. modify the parameters entryfield of the PC/2 Program Installation dialog like 
  1091. [Please enter host address] 
  1092.  
  1093. Further assume that you selected the Menuitem FTP from the Popup-Menu. Just 
  1094. before FTP is started, a dialog box is displayed, requesting the host address 
  1095. from you. E.g you will type ftp.cdrom.com, then the file transfer program will 
  1096. be invoked as if you typed FTP ftp.cdrom.com from a commandline. 
  1097.  
  1098. Generally the syntax for the commandline parameters is: 
  1099.  
  1100. Parameter(s) 1 [Text] Parameter(s) 2 
  1101.  
  1102. Assume you typed FirstFile.doc as the first and ThirdFile.doc as the second 
  1103. parameter. You will be asked by a dialog box, what to replace [Text] with. 
  1104. Assume you entered MyFile.doc then the program will be invoked with the 
  1105. commandline parameters FirstFile.doc MyFile.doc ThirdFile.doc. The string 
  1106. [Text] would have been replaced by MyFile.doc. Of course both parameters may be 
  1107. omitted, both may contain more than one parameter or only one of them may 
  1108. present. Omitting [Text] would start the application without asking you for a 
  1109. commandline parameter prior. 
  1110.  
  1111. You may also use this dialog, to add a second WIN-OS2 application to a WIN-OS2 
  1112. session, if the first application is the WIN-OS2 Program Manager. 
  1113.  
  1114. PC/2 allows you to edit commandline parameters similar to the WPS (open the 
  1115. Settings notebook of any application, position the cursor into the Parameters 
  1116. entryfield and press F1 or Help to get further information). 
  1117.  
  1118. Press Ok to accept the parameters you entered, or press Cancel to replace the 
  1119. commandline parameters by an empty string. 
  1120.  
  1121. <Backward>                 <Forward> 
  1122.  
  1123.  
  1124. ΓòÉΓòÉΓòÉ 13. Help for PC/2 Desktop Setup ΓòÉΓòÉΓòÉ
  1125.  
  1126. For more information click about on one of the above notebook pages select: 
  1127.  
  1128. o Application Settings 
  1129. o Session Settings 
  1130.  
  1131. PC/2 supports what is called Sliding Focus and Virtual Desktop. 
  1132.  
  1133. A sliding Focus ensures, that the window under the mouse pointer is always the 
  1134. active window (the one that has a highlighted frame). If you move the pointer 
  1135. over another window, PC/2 recognizes the pointer movements, and tries to 
  1136. activate the window currently under the mouse pointer. The windows will behave 
  1137. similar to X-Windows, but the active window is always fully displayed. 
  1138.  
  1139. A Virtual Desktop is a Desktop enhancement that expands your display. For 
  1140. example assume that you are running OS/2 on an XGA-2 at a resolution of 1024 * 
  1141. 768 pixels. Your display has then 1024 columns and 768 rows of pixels, giving 
  1142. you a Desktop where application windows can be seen. We will call this the 
  1143. physical Desktop. Of course you can start windows outside this Desktop, but you 
  1144. won't be able to see them unless you switch to this Desktop.. 
  1145.  
  1146. PC/2 allows you to expand this Desktop, so that you can move the physical 
  1147. Desktop around to see the windows you couldn't see before. We will call this 
  1148. enhancement the Virtual Desktop. Simply speaking, imagine the Virtual Desktop 
  1149. as an up to 9 * 9 array of Desktops, with the physical Desktop you now can see 
  1150. in the middle. Now imagine, that you can move your physical Desktop around 
  1151. within the larger Virtual Desktop. For example assume that you move the 
  1152. physical Desktop left, all windows you have started will move right, so some 
  1153. disappear in the right side  and some appear on the left side of your display. 
  1154.  
  1155. That's just that what PC/2 does for you. If you move your mouse pointer on the 
  1156. leftmost column of your display (column 0), all windows move rightward, as the 
  1157. physical Desktop moves leftward within the Virtual Desktop. The same principle 
  1158. is used on the rightmost columns and the top and bottom rows. If you move your 
  1159. mouse pointer into a corner of your display, the Desktop even will move in two 
  1160. directions, leading to a horizontal and a vertical movement. 
  1161.  
  1162. Of course you can only move your physical Desktop in one direction, as long as 
  1163. this movement keeps the physical Desktop within the Virtual Desktop. Using this 
  1164. feature, you expand your physical Desktop up to a 81-fold Virtual Desktop. 
  1165.  
  1166. All setting are saved and will be used when PC/2 is loaded unless you have 
  1167. specified a different behaviour with the Commandline Parameters. 
  1168.  
  1169. Caution: You may want to disable the Sliding Focus on a machine used for 
  1170. development. When using a debugger (e.g. IPMD) your machine is likely to lock 
  1171. with the Sliding Focus enabled. 
  1172.  
  1173. You can use the Virtual Desktop on a development machine, just avoid switching 
  1174. between Desktops when a debugger is active. 
  1175.  
  1176. Trap popup screens also make changes in the focus order so I would suggest to 
  1177. use the keyboard to dismiss these dialogs. 
  1178.  
  1179. Commandline Parameters. 
  1180.  
  1181. <Backward>                 <Forward> 
  1182.  
  1183.  
  1184. ΓòÉΓòÉΓòÉ 13.1. Virtual Desktop Settings ΓòÉΓòÉΓòÉ
  1185.  
  1186. This dialog is used to control the Virtual Desktop feature of PC/2. 
  1187.  
  1188. Fieldname:  Description: 
  1189.  
  1190. Virtual Desktop Select this checkbox to enable the Virtual Desktop feature of 
  1191.             PC/2. 
  1192.  
  1193. Move OS/2's Desktop This checkbox allows you to move the Desktop within the 
  1194.             Virtual Desktop like any other window. The Desktop is another name 
  1195.             for the WPS (WorkPlace-Shell). You may check this option if you 
  1196.             don't need the services provided by the WPS on all Virtual 
  1197.             Desktops. 
  1198.  
  1199. Click to Move If you prefer to click to a surrounding row or column, before the 
  1200.             physical Desktop is moved, select this option, otherwise you can 
  1201.             change to another Virtual Desktop by just moving the mouse pointer 
  1202.             on a surrounding row or column of your Display. 
  1203.  
  1204. Overview Window You may also want an Overview Window, that contains the current 
  1205.             layout of the Virtual Desktop. Select this checkbox to enable this 
  1206.             feature. You may doubleclick with mouse button 1 on any of the up 
  1207.             to 81 Virtual Desktops to immediately switch to this Desktop. 
  1208.             commandline option, to move the physical Desktop. 
  1209.  
  1210. Expand WPS to Virtual Desktop When selecting this feature, the WPS is expanded 
  1211.             to the size of the Virtual Desktop. You may then distribute WPS 
  1212.             Objects to any of the Virtual Desktops. If you have a scroll bar on 
  1213.             your WPS, this feature removes the scrollbar when your WPS 
  1214.             completely fits into the Virtual Desktop. 
  1215.  
  1216. Desktop Scrolling The scrollbar Desktop Scrolling enables you to define the 
  1217.             scrolling factor that is applied to your Virtual Desktop, when 
  1218.             switching to the next Virtual Desktop, by clicking on a surrounding 
  1219.             row or column. You can select between 0 and 100 % with 5% 
  1220.             increments, with 100 % being the default one. 
  1221.  
  1222. Virtual Desktop count These two spinbutton enable you to define the number of 
  1223.             Virtual Desktops in horizontal direction and vertical direction, 
  1224.             both in the range of 1 to 9. The first spinbutton determines the 
  1225.             number of Virtual Desktops in horizontal direction, the second 
  1226.             spinbutton the number of Virtual Desktops in vertical direction. 
  1227.  
  1228. Single Click Select this option if you want to activate the Popup-Menu or 
  1229.             switch to another Virtual Desktop with a single click with mouse 
  1230.             button 1. 
  1231.  
  1232. Double Click Select this option if you want to activate the Popup-Menu or 
  1233.             switch to another Virtual Desktop with a double click with mouse 
  1234.             button 1. 
  1235.  
  1236. Preselect first Menuitem Check this item if you want PC/2 automatically to 
  1237.             select the first entry of your Popup-Menu for you. If the first 
  1238.             item is a submenu, it will be opened automatically. 
  1239.  
  1240. Sliding Focus Select this checkbox to enable the Sliding Focus feature of PC/2. 
  1241.  
  1242.             Note! Even if this setting is enabled, you can temporarily prevent 
  1243.             the focus from moving by holding down the SHIFT-key when moving the 
  1244.             mouse. 
  1245.  
  1246. Preserve Z-Order To preserve the Z-Order of the windows, that is the order in 
  1247.             which a window in the foreground overlaps a window behind, also 
  1248.             check the Preserve Z-Order checkbox. 
  1249.  
  1250.             Note! Even if this setting is enabled, you can temporarily prevent 
  1251.             changes of the Z-Order by holding down the SHIFT-key when moving 
  1252.             the mouse. 
  1253.  
  1254. Hide Titlebar To hide the titlebar of PC/2's Overview Window select this 
  1255.             option. This increases the space available to paint a reduced image 
  1256.             of the Virtual Desktops. 
  1257.  
  1258. Hide Smarticons To hide the smarticon bar of PC/2's Overview Window select this 
  1259.             option. This increases the space available to paint a reduced image 
  1260.             of the Virtual Desktops too, at the cost of not being able to 
  1261.             manipulate PM windows on the Overview Window. 
  1262.  
  1263. Press Ok to accept the configuration and save it into an INI file, or press 
  1264. Cancel to ignore any changes you made. If your INI file is corrupted, PC/2 
  1265. assumes default values, which you then can edit and save to a new INI file. 
  1266.  
  1267.  
  1268. ΓòÉΓòÉΓòÉ 13.2. Physical Desktop Settings ΓòÉΓòÉΓòÉ
  1269.  
  1270. This dialog is used to control the physical Virtual Desktop feature of PC/2. 
  1271.  
  1272. Control:    Description: 
  1273.  
  1274. OS/2's Desktop Name PC/2 has to know the name of this Desktop, so you have to 
  1275.             ensure that you type its name in the entryfield. Under OS/2 2.0 its 
  1276.             usually named OS/2 2.0 Desktop, but it changes under OS/2 2.1 to 
  1277.             Desktop, if you haven't installed it over an existing OS/2 2.0 
  1278.             system. You may rename the Desktop by clicking with mouse button 2 
  1279.             on the Desktop selecting DesktopSettings and selecting the General 
  1280.             notebook page. Changing the title can be used to replace OS/2 2.0 
  1281.             Desktop by Desktop. Also ensure that you translate is into your 
  1282.             national language, if you don't use an English OS/2 version. 
  1283.  
  1284. Window List Name PC/2 also requires to know the name of the Window List. The 
  1285.             Window List is usually named Window List but you have to ensure 
  1286.             that it is translated into your national language, if you don't use 
  1287.             an English OS/2 version. 
  1288.  
  1289. Button 2 titlebar click lowers Z-order Select this checkbox if you want to 
  1290.             click down mouse button 2 on any window's titlebar to set this 
  1291.             window to the bottom of all windows. This moves the window you 
  1292.             clicked on behind all other windows, lowering its Z-Order to the 
  1293.             minimum. The window under the mouse pointer is moved to the 
  1294.             foreground and activated, if it is not the same you clicked on. 
  1295.  
  1296.             By holding the Ctrl-key while clicking with mouse button 2 on a 
  1297.             window's titlebar, the window under the mouse pointer gets not 
  1298.             moved to the foreground and activated. This allows you to kick a 
  1299.             window into the background without affecting the Z-order of other 
  1300.             windows. 
  1301.  
  1302.             By holding the Alt-key while clicking with mouse button 2 on a 
  1303.             window's titlebar, the titlebar acts as if you haven't checked 
  1304.             PC/2's option Button 2 titlebar click lowers Z-order. This allows 
  1305.             you to move the window or activate any special features the window 
  1306.             supports. 
  1307.  
  1308. Keep on top Select this option if you want the Overview Window to stay always 
  1309.             on the top of the Desktop, even if another window has the focus. 
  1310.  
  1311. Use Spooler Control Window PC/2 provides a Spooler Control Window, which allows 
  1312.             you to manage the printer queues and jobs of your local 
  1313.             workstation. This feature is primarliy to provide a printer 
  1314.             management, when PC/2 is running as a WPS replacement, because the 
  1315.             standard OS/2 Spooler management is a SOM application and requires 
  1316.             that the WPS is running. 
  1317.  
  1318.             By default PC/2 starts the Spooler Control Window only, when PC/2 
  1319.             is running as a WPS replacement. When selecting this checkbox, the 
  1320.             PC/2 Spooler Control Window is also available when you run PC/2 on 
  1321.             top of the WPS (which increases PC/2's memory requirements 
  1322.             slightly). Changes of this setting aren't available immediately, 
  1323.             but the next time you start PC/2. 
  1324.  
  1325. Background Bitmap Check this option to add the background Bitmap support of 
  1326.             PC/2. PC/2 then allows you to define a bitmap, which is displayed 
  1327.             on PM background. PM background means all the background of OS/2 
  1328.             that is not covered by the WPS. For example if you have 3 Virtual 
  1329.             Desktops, having the WPS as the centered one, then the 2 Virtual 
  1330.             Desktops beside the WPS will display the background bitmap. 
  1331.  
  1332. Normal      This option displays the bitmap unsized. The bitmap is centered. 
  1333.  
  1334. Scaled      This option scales the bitmap so that is covers the complete 
  1335.             screen. 
  1336.  
  1337. Tiled       The bitmap is tiled covering the complete screen with the tile 
  1338.             count selected in the Tile count spinbutton. You can select a tile 
  1339.             count of 1 to 99 although OS/2 seems to limit this to about 20. 
  1340.  
  1341.             Caution! Under OS/2 3.00 Warp this seems to hang OS/2 completely, 
  1342.             requiring a soft reset. 
  1343.  
  1344. Find Bitmap... Select this pushbutton to use the standard OS/2 file dialog to 
  1345.             locate the bitmap file you want to display. 
  1346.  
  1347. Path to Bitmap Either fill this entryfield by selecting a bitmap with the file 
  1348.             dialog by clicking on Find Bitmap... or enter the fully qualified 
  1349.             path to  the bitmap manually. 
  1350.  
  1351. Press Ok to accept the configuration and save it into an INI file, or press 
  1352. Cancel to ignore any changes you made. If your INI file is corrupted, PC/2 
  1353. assumes default values, which you then can edit and save to a new INI file. 
  1354.  
  1355.  
  1356. ΓòÉΓòÉΓòÉ 14. Help for PC/2 Overview Window ΓòÉΓòÉΓòÉ
  1357.  
  1358. PC/2's Desktop Overview Window displays a sized image of all windows available 
  1359. on all Virtual Desktops and allows direct manipulation. Of course PC/2's 
  1360. Overview Window must be enabled before it is displayed. 
  1361.  
  1362. To change the font of the Overview Window just drag a font from the Font 
  1363. Palette to the Overview Window. This font will be saved the next time you exit 
  1364. PC/2. 
  1365.  
  1366. The Overview Window is controlled by smarticons, located at the top of the 
  1367. window. The currently active smarticon is framed and pressed. If mouse button 2 
  1368. is pressed on a window the action corresponding to the active smarticon is 
  1369. performed. 
  1370.  
  1371. To perform actions on the windows displayed in PC/2's Desktop Overview Window, 
  1372. the following smarticons may be used: 
  1373.  
  1374. Icon:       Description: 
  1375.  
  1376. Exit PC/2   Click on this smarticon to exit PC/2. 
  1377.  
  1378. Move window Selecting this icon changes the pointer to a window pointer cursor, 
  1379.             allowing you to select and move a window by clicking and holding 
  1380.             mouse button 2. 
  1381.  
  1382. Hide window Selecting this icon changes the pointer to a window pointer cursor, 
  1383.             allowing you to select and hide a window by clicking mouse button 2 
  1384.             onto it. The window can be set visible again by selecting it from 
  1385.             the Window List. 
  1386.  
  1387. Set to top  Selecting this icon changes the pointer to a cross wires cursor, 
  1388.             allowing you to move a window on the top of the Desktop by clicking 
  1389.             mouse button 2 onto it. 
  1390.  
  1391. Set to bottom Selecting this icon changes the pointer to a cross wires cursor, 
  1392.             allowing you to move a window to the bottom of the Desktop by 
  1393.             clicking mouse button 2 onto it. 
  1394.  
  1395. Kill a session Selecting this icon changes the pointer to a cross wires cursor, 
  1396.             allowing you to terminate a window by clicking mouse button 2 onto 
  1397.             it. 
  1398.  
  1399. Maximize window Selecting this icon changes the pointer to a cross wires 
  1400.             cursor, allowing you to maximize a window by clicking mouse button 
  1401.             2 onto it. 
  1402.  
  1403. Minimize window Selecting this icon changes the pointer to a cross wires 
  1404.             cursor, allowing you to minimize a window by clicking mouse button 
  1405.             2 onto it. 
  1406.  
  1407. Restore window Selecting this icon changes the pointer to a cross wires cursor, 
  1408.             allowing you to restore a window by clicking mouse button 2 onto 
  1409.             it. 
  1410.  
  1411. ShutDown OS/2 Selecting this icon changes the pointer to a window pointer 
  1412.             cursor and displays a message box asking to continue ShutDown of 
  1413.             OS/2. 
  1414.  
  1415. PC/2 Help   Selecting this icon changes the pointer to a window pointer cursor 
  1416.             and displays PC/2's online help you are reading now. 
  1417.  
  1418. <Backward>                 <Forward> 
  1419.  
  1420.  
  1421. ΓòÉΓòÉΓòÉ 15. PC/2's Spooler Control Window ΓòÉΓòÉΓòÉ
  1422.  
  1423. PC/2 supports a Spooler Control Window, which is simply a container filled with 
  1424. the available printer queue and job information available on the local machine 
  1425. PC/2 is running. 
  1426.  
  1427. To change the font of the Spooler Control Window just drag a font from the Font 
  1428. Palette to the Spooler Control Window container. This font will be saved the 
  1429. next time you exit PC/2. The PC/2 Spooler was primarily added to be able to 
  1430. manage print jobs on systems PC/2 is running as a WPS replacement. Any WPS 
  1431. replacement has to start the OS/2 spooler and provide a mechanism to manage 
  1432. print jobs. 
  1433.  
  1434. To be able to display PC/2's Spooler Control Window, you must select the 
  1435. menuitem PC/2 Spooler from PC/2's Popup Menu (of course you have to add this 
  1436. menuitem via the Control Addition dialog. 
  1437.  
  1438. If the container is empty, PC/2 can't find any printer queue on your loca 
  1439. workstation. 
  1440.  
  1441. Menuentry:  Description: 
  1442.  
  1443. Refresh     Select this item to refresh the Spooler window container 
  1444.             immediately from the real-time printer queue status of the local 
  1445.             workstation. When you don't select this item, the Spooler window 
  1446.             container gets refreshed regularly. 
  1447.  
  1448. Hold job    Select this item to set the currently selected job(s) to a hold 
  1449.             status. 
  1450.  
  1451. Release job Select this item to set the currently selected job(s) to the normal 
  1452.             status (this request will be ignored for jobs being in the normal 
  1453.             status). 
  1454.  
  1455. Delete job  Select this item to delete the currently selected job(s). The jobs 
  1456.             will be removed from the printer queue by the OS/2 spooler in a few 
  1457.             seconds. 
  1458.  
  1459. Hold queue  Select this item to suspend the currently selected queue(s). All 
  1460.             jobs running in these queues will suspended from printing, too. 
  1461.  
  1462. Release queue Select this item to set the currently selected queue(s) to the 
  1463.             normal status (this request will be ignored for queues being in the 
  1464.             normal status). 
  1465.  
  1466. Help        Selecting this item just displays the online help panel you are 
  1467.             currently reading. 
  1468.  
  1469. <Backward>                 <Forward> 
  1470.  
  1471.  
  1472. ΓòÉΓòÉΓòÉ 16. PC/2's Compatibility with other applications ΓòÉΓòÉΓòÉ
  1473.  
  1474. This section provides information of compatibility with some (but certainly not 
  1475. all) useful packages. 
  1476.  
  1477. Program:    Compatibility information. 
  1478.  
  1479. BOOTOS2     This package, available as EWS (or from OS2TOOLS), allows you to 
  1480.             create a bootable system to either diskette or harddisc from a 
  1481.             single command prompt, over a PM to a complete WPS setup. This is 
  1482.             useful for creating a bootable maintenance partition on a logical 
  1483.             FAT (because HPFS required a CHKDSK when not shut down correctly) 
  1484.             drive (requiring under 10 MB disc space), allowing you to recover a 
  1485.             unbootable production partition (e.g. changes in CONFIG.SYS which 
  1486.             made it unbootable) or to remove files, which would have been 
  1487.             locked when booting from your production partition. 
  1488.  
  1489.             After creating a PM setup, the standard OS/2 command processor 
  1490.             CMD.EXE is your Workplace Shell process. 
  1491.  
  1492.             By replacing the line SET RUNWORKPLACE=\OS2\CMD.EXE, which BOOTOS2 
  1493.             creates in your CONFIG.SYS, by SET RUNWORKPLACE=\PC2\PC2.EXE, 
  1494.             assuming you have installed PC/2 into the directory \PC2 on the 
  1495.             boot drive, PC/2 will be a more comfortable Workplace Shell 
  1496.             process. You can of course copy your existing PC2.CFG file to this 
  1497.             directory, to continue fast access to your favourite programs. 
  1498.  
  1499. IPFCPREP    This package, available as EWS (or from OS2TOOLS) is a great help 
  1500.             for writing online help panels (that is compiling *.IPF files into 
  1501.             *.HLP files). This package contains a preprocessor, that adds 
  1502.             conditional compiling, macros and some more things, which the IPFC 
  1503.             (Information Presentation Facility Compiler) is definitely missing. 
  1504.  
  1505. OS/2 2.x    PC/2 was successfully tested with OS/2 2.10 and 2.11 US. It may 
  1506.             also be compatible with OS/2 2.00, but this was not tested. 
  1507.  
  1508. OS/2 WARP   PC/2 is fully compatible with OS/2 WARP. Using previous versions of 
  1509.             PC/2 (1.70 and before) may cause problems when using the Virtual 
  1510.             Desktop. Of course you can continue to use the Launchpad together 
  1511.             with PC/2. 
  1512.  
  1513. <Backward>                 <Forward> 
  1514.  
  1515.  
  1516. ΓòÉΓòÉΓòÉ 17. Help for PC/2 Errors ΓòÉΓòÉΓòÉ
  1517.  
  1518. PC/2 can't verify all user input for validity, so some user input may cause 
  1519. some PC/2 functions to fail. In this case, a message box is displayed 
  1520. containing the module and the sourcecode linenumber that failed. Also a error 
  1521. message is displayed containing which error occured and what should be done to 
  1522. resolve the problem. 
  1523.  
  1524. E.g. you might have configured to start the program VIEW.EXE by writing 
  1525. c:\os3\view.exe in the entryfield Path and Filename in the Program Installation 
  1526. dialog. This of course leads to an error, because when OS/2 tries to start this 
  1527. item, it can't find the directory \os3\ simply because it should read \os2\. A 
  1528. message box is displayed saying an error occured and that the user input should 
  1529. be corrected. 
  1530.  
  1531. Some messages aren't even errors, just warnings (e.g. the message that informs 
  1532. you that the file PC2.INI does not exist or must be updated from a previous 
  1533. version of PC/2). I have to admit that most messages primarily were debugging 
  1534. messages and are not so user-friendly and clear as they should be. 
  1535.  
  1536. The messagebox has three buttons that may be pressed: 
  1537.  
  1538. Button:     Result: 
  1539.  
  1540. Abort       PC/2 will be terminated and all unsaved data will be lost. You have 
  1541.             to restart PC/2 again. This button should be the last one you 
  1542.             select. 
  1543.  
  1544. Retry       The error is ignored, you may need to correct your data entered in 
  1545.             the entryfields. 
  1546.  
  1547. Ignore      The error is ignored, you may need to correct your data entered in 
  1548.             the entryfields. 
  1549.  
  1550. <Backward>                 <Forward>