home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / os2 / pc2_150.zip / PC2.HLP (.txt) < prev    next >
OS/2 Help File  |  1993-05-31  |  35KB  |  766 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. PC/2 Help for Help ΓòÉΓòÉΓòÉ
  3.  
  4.                      PC/2 - Program Commander/2 Version 1.50
  5.                       for IBM OS/2 2.x Presentation Manager
  6.                      Copyright (C) by Stangl Roman 05, 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.    - Resorting a (Sub)menu 
  20.    - Run-time parameters 
  21.  
  22. o Setup the Desktop 
  23. o Error messages 
  24.  
  25. <Backward>                 <Forward> 
  26.  
  27.  
  28. ΓòÉΓòÉΓòÉ 2. Help for About PC/2 ΓòÉΓòÉΓòÉ
  29.  
  30.                      PC/2 - Program Commander/2 Version 1.50
  31.                       for IBM OS/2 2.x Presentation Manager
  32.                      Copyright (C) by Stangl Roman 05, 1993
  33.  
  34.                      University for Business Administration
  35.                          and Management Vienna, Austria
  36.                           (Wirtschaftsuniversit╨öt Wien)
  37.  
  38. E-Mail: 
  39.  
  40. o 8650533@awiwuw11.wu-wien.ac.at 
  41. o Roman Stangl @ IBM Austria National Support BBS ((0043) 0222 21145 6600) 
  42. o Roman Stangl on LA BAMBA BBS ((0043) 0222 688971) (You may try to mail me on 
  43.   this BBS at 2:310/14@fidonet.org but I don't know if and how it works.) 
  44.  
  45. This program is classified as Freeware. Under the copyright, you are allowed 
  46. and encouraged to freely use, distribute or modify this program under the 
  47. following conditions: 
  48.  
  49. o The complete source code and all executables are included. This rule also 
  50.   applies for any modifications you made. 
  51. o You may only charge for the costs of duplicating. 
  52. o Any commercial use is prohibited without contacting me prior, except for 
  53.   incorporating the idea/code in any future release of OS/2 by IBM, however 
  54.   this clause doesn't apply for any private use. 
  55. o You don't want to port this utility to MS Windows or Windows NT (never 
  56.   there). 
  57.  
  58. You are encouraged to upload this utility to your favourite file-server or BBS. 
  59. Please ensure that no file is missing, if you change the archive to a different 
  60. compression scheme. 
  61.  
  62. If you find this program useful and want to honor the seven weeks of work 
  63. writing this utility, you are welcome to send me a small fee of about 50 to 150 
  64. Austrian Schilling (about 5 to 15 dollar) to my home address. Of course you 
  65. don't need to pay again, if a new release of PC/2 comes out. Please send any 
  66. donations in cash, because it makes some troubles to exchange money orders or 
  67. similar in Austria! 
  68.  
  69. Any suggestions are of course welcome too. I try my best to follow discussion 
  70. of PC/2 on Internet NetNews and Fidonet OS/2 conferences. Thanks to all those, 
  71. who sent me proposals and bug reports to improve this utility! 
  72.  
  73. Thanks to Mario Semo, Carrick von Schoultz and Markus Hof, Roman Fischer who 
  74. gave me advices and/or source code to modify for use within PC/2. 
  75.  
  76. My home address is: 
  77.  
  78.   Roman Stangl 
  79.   Strebersdorferstrasse 46 
  80.   2103  Langenzersdorf, Austria 
  81.  
  82. <Backward>                 <Forward> 
  83.  
  84.  
  85. ΓòÉΓòÉΓòÉ 3. Installing PC/2 ΓòÉΓòÉΓòÉ
  86.  
  87. You have obviously started PC/2 once, because you are reading this help panel. 
  88. The installation is just straight forward with the REXX script that installs 
  89. PC/2, however there are some points to notice: 
  90.  
  91. o The installation installed an icon on the Desktop and started the help panels 
  92.   of PC/2. To ensure that OS/2 starts PC/2 automatically the next time you boot 
  93.   your system, you must start PC/2 again (you then can notice that the 
  94.   background behind the icon changes). If you have added SET 
  95.   RESTARTOBJECTS=STARTUPFOLDERSONLY in your CONFIG.SYS then you must also add a 
  96.   shadow of PC/2 to your startup folder to ensure PC/2 is started the next time 
  97.   you boot OS/2. 
  98.  
  99. o PC/2 requires the file PC2HOOK.DLL to be accessible. PC/2 tries to find this 
  100.   file either in the directory, where PC/2 was started from, or in a path that 
  101.   is included in the environment variable LIBPATH. PC/2 will issue an error 
  102.   message, if it can't find it. The file PC2.HLP may be either accessible in 
  103.   the directory, where PC/2 is started from, or in a path that is included in 
  104.   the environment variable HELP. If you have problems running PC/2, ensure, 
  105.   that the working directory of PC/2 is accessible by these variables in your 
  106.   CONFIG.SYS. 
  107.  
  108. o The installation assumes that you are using the default profile Pc2.cfg 
  109.   containing a standart pre-defined Popup-Menu. If you want to use an other 
  110.   Popup-Menu, you have to open the Settings of PC/2 and add your preferred 
  111.   profile in the Parameters entryfield. Please click for the next help panel to 
  112.   see the syntax of the command-line parameters of PC/2. This command-line 
  113.   parameters then must be added to the Parameters entryfield. 
  114.  
  115. o You can only run one copy of PC/2 concurrently. 
  116.  
  117. o If you select a DOS-Program to be started via PC/2, the time-slice of their 
  118.   sessions is optimized (the DOS-Settings are modified to IDLE_SECONDS=5 
  119.   IDLE_SENSITIVITY=100) to get a better performance. This is useful for most 
  120.   DOS games. 
  121.  
  122. o You may use PC/2 with or without the WPS installed, you may even use PC/2 as 
  123.   a replacement for the WPS. To do so you must install PC/2 first. Then you 
  124.   have to ensure that PC2HOOK.DLL is accessible by PC/2. PC/2 tries to find 
  125.   this file in the directory where PC/2 is started from or in a path pointed to 
  126.   by the LIBPATH environment variable in your CONFIG.SYS. You also have to 
  127.   ensure that PC2.HLP is accessible in the PC/2 directory or in a path pointed 
  128.   to by the HELP environment variable in your CONFIG.SYS file. The default 
  129.   access ".;" is not sufficient. Then replace the statement SET 
  130.   RUNWORKPLACE=C:\OS2\PMSHELL.EXE with SET RUNWORKPLACE=[path]PC2.EXE where 
  131.   [path] is the pathname of the directory you installed PC/2. The next time you 
  132.   boot, PC/2 will be started as a replacement for the WPS. Be carefull, OS/2 
  133.   seems to dislike any parameters added to the program that is started as the 
  134.   WPS! 
  135.  
  136.   Caution! PC/2 was not tested on all OS/2 versions or installed software and 
  137.   hardware (simply because I don't have them), so there may be bugs!. Of course 
  138.   you can start the WPS from a command prompt by typing START PMSHELL or add a 
  139.   corresponding entry to PC/2. 
  140.  
  141. <Backward>                 <Forward> 
  142.  
  143.  
  144. ΓòÉΓòÉΓòÉ 4. General Help for PC/2 ΓòÉΓòÉΓòÉ
  145.  
  146. PC/2 - Program Commander is an addon for the WPS (Workplace Shell). The user 
  147. can configure a menu that pops up, when the left mouse button is clicked 
  148. anywhere on the Desktop. F.e. the Popup-Menu might look like: 
  149.  
  150. You have selected the item Prompts, which is a Submenu containing four more 
  151. items. F.e. the item OS/2 Window starts a windowed OS/2 command prompt, when 
  152. selected. This Popup-Menu is fully configurable, you may add, change or remove 
  153. items. An item can either be a Submenu containing more items, or the name of a 
  154. program. 
  155.  
  156. Only the first Submenu PC/2 Setup cannot be modified. This Submenu is used to 
  157. setup PC/2 and to get help. 
  158.  
  159. Your configuration is read from the default profile Pc2.cfg each time PC/2 is 
  160. started and saved every time you made changes. You can of course overwrite the 
  161. default configuration filename to a file named Filename.ext by invoking PC/2 
  162. with the following commandline option: 
  163.  
  164. PC2 [-Profile Filename.ext] or 
  165.  
  166. PC2 [/Profile Filename.ext] 
  167.  
  168. where Filename.ext conforms to a filename of a PC/2 profile. Both FAT and HPFS 
  169. filename naming convention is accepted. A few sample configuration files are 
  170. provided in this package. 
  171.  
  172. As the default, the Popup-Menu appears if you double-click once on the Desktop, 
  173. if no option or the following option is specified: 
  174.  
  175. PC2 [-DoubleClick] or 
  176.  
  177. PC2 [/DoubleClick] 
  178.  
  179. You may select a single-click instead, by invoking PC/2 with the following 
  180. commandline option: 
  181.  
  182. PC2 [-SingleClick] or 
  183.  
  184. PC2 [/SingleClick] 
  185.  
  186. Please be sure not to combine both click behavior options. Of course the 
  187. options changing the click behavior and the configuration filename options may 
  188. be combined. 
  189.  
  190. Because some people use PC/2 as a WPS replacement, PC/2 contains a Menuitem to 
  191. ShutDown OS/2. By selecting this entry, it is safe to power off your PS/2 or PC 
  192. after all disk activity has been stopped, although no windows are closed. If 
  193. you run PC/2 as a WPS replacement and may want to start the WPS either by 
  194. starting PMSHELL.EXE from a command prompt or by starting a PMSHELL Menuitem 
  195. with PC/2. You then can follow the WPS initialization by heavy disk access and 
  196. buildup of your Desktop with objects. PC/2 requires to know the Desktop (in 
  197. technical terms the window handle of the Desktop) to be able to catch mouse 
  198. button 1 clicks. If you start the WPS the Desktop changes too. Therefor PC/2 
  199. checks regularily (about every 2.5 seconds) if the Desktop has changed, so you 
  200. may have to wait a little bit, after the WPS was started, that PC/2 recognizes 
  201. mouse clicks again.. 
  202.  
  203. I would strongly recommend to start PC/2 during OS/2 boot. If you don't want to 
  204. use the default profile, don't forget to add /Profile Filename.exe to the 
  205. Parameters entryfield in the Settings of PC/2. 
  206.  
  207. The reason why I wrote this utility was primarily, that many programs installed 
  208. on a system require many folders and icons on the Desktop. But to start a 
  209. program, I don't want to open and close folders, so I made shadows on the 
  210. Desktop messing it up. The solution I prefer is to click on the Desktop, 
  211. getting immediately a menu and selecting the application from this menu. So 
  212. PC/2 may help you to start your programs quickly, without needing to open and 
  213. close folders. 
  214.  
  215. <Backward>                 <Forward> 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 5. Concepts of PC/2 ΓòÉΓòÉΓòÉ
  219.  
  220. The basic idea behind PC/2 is to have an configurable Popup-Menu available, to 
  221. start programs quicky, without having to open and close folders. 
  222.  
  223. The Popup-Menu, popped up when you click the left mouse button anywhere on the 
  224. Desktop (just like the right one for shutdown), consists of so-called items. An 
  225. item may be a Submenu, which contains further items, or the title of an 
  226. Application. A Submenu contains a little arrow right beside the title of the 
  227. Submenu. 
  228.  
  229. You can imagine this Popup-Menu as a tree, with applications as leaves and 
  230. Submenus as nodes. PC/2 allows you to freely build your own tree. To do so you 
  231. have to click on the Desktop with the left mouse button and to select PC/2 
  232. Setup  Configure PC/2. A dialog box appears, where you can add, modify or 
  233. remove Submenus and Applications. The listbox displays all Submenus and 
  234. Applications of one level (like a cut through the tree). Of course you may 
  235. change this level up and down. 
  236.  
  237. Once you have configured your tree of Submenus and Applications, just press Ok 
  238. to take them into effect and save them to the profile or Cancel to take them 
  239. into effect without saving. 
  240.  
  241. <Backward>                 <Forward> 
  242.  
  243.  
  244. ΓòÉΓòÉΓòÉ 6. Help for starting a program via PC/2 ΓòÉΓòÉΓòÉ
  245.  
  246. After you have configured the PC/2 Popup-Menu, you click on the Desktop with 
  247. the left mouse button, select the Application you want to start and click on 
  248. it. The Application will be started as if you were clicking on an icon. 
  249.  
  250. One advantage starting an Application this way is, that you can manipulate many 
  251. parameters on how the Application is started, one thing you can't do with many 
  252. icons. F.e. you can start it invisible (useful for a backup program), making it 
  253. only visible by selecting it from the tasklist. You may also specify the size 
  254. of the Application or to start it in the background. 
  255.  
  256. You can also start WPS objects, f.e. the Drives object or the Selective 
  257. Install. If you have an WPS object, that represents a seamless WIN-OS2 
  258. application, you may even launch such a session. Be warned! - you have to 
  259. create an WPS Object with MAKEOBJ.CMD first to define an Object ID (Identifier) 
  260. with that Object, to enable PC/2 to get this ID. 
  261.  
  262. To close an Application, select the corresponding option from the Application 
  263. or terminate it from the tasklist. 
  264.  
  265. <Backward>                 <Forward> 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 7. Help for PC/2 Configuration ΓòÉΓòÉΓòÉ
  269.  
  270. In the listbox, all Submenus and Applications of one level (imagine as a cut 
  271. through the tree) are displayed. A Submenu has an arrow right beside it. F.e. 
  272. assume the listbox contains 3 Submenus and 2 Appliations resulting in the 
  273. following Popup-Menu: 
  274.  
  275. You may want to get into the Submenu Prompts. Just select the Submenu Prompts 
  276. an click on the button Level Down >>. The listbox will now be filled with all 
  277. Submenus and Applications of the Submenu Prompts. To get one level up, simply 
  278. press << Level Up. If nothing seems to change, you may be either at the highest 
  279. level (the root of the tree) or at the deapest level (a leaf of the tree) of a 
  280. Submenu. 
  281.  
  282. To configure the Popup-Menu just select an item. 
  283.  
  284. o To change or to remove this item use the buttons Change Entry or Remove 
  285.   Entry. Either a new dialog appears allowing you to change the item, or the 
  286.   item will be removed. 
  287. o To add a Submenu or an Application press the buttons Add Submenu or Add 
  288.   Program. A new dialog is displayed allowing you to add a new Submenu or 
  289.   Application, after pressing Ok in this dialog, the Submenu or Application 
  290.   will be inserted after the selected item, or at the end of the list if no 
  291.   item is selected. 
  292. o To resort a Submenu press the button Resort Menu. A new dialog is displayed 
  293.   allowing you to resort the currently listed Submenu. Press here to get more 
  294.   information about the Resort dialog. 
  295.  
  296. If the listbox is empty, you can't remove or change anything. You also can't 
  297. select any item, but in this case you can add a Submenu or an Application by 
  298. just pressing the buttons, without needing to select an item. 
  299.  
  300. Press Ok to write the configuration to the profile, or press Cancel to keep the 
  301. changes only in memory. Both buttons will dismiss the dialog. 
  302.  
  303. Example 1    Example 2 
  304.  
  305. <Backward>                 <Forward> 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 7.1. Setup example 1 ΓòÉΓòÉΓòÉ
  309.  
  310. Assume the listbox contains the following items resulting in the following 
  311. Popup-Menu: 
  312.  
  313. You want to remove the Submenu Editors, rename the Submenu Tools to Utilities 
  314. and add a Submenu Demos. 
  315.  
  316.  1. Select the item Editors. You can now press the button Remove Entry to 
  317.     remove the submenu, but only if this Submenu is empty. If it isn't empty, 
  318.     get into this Submenu by pression Level Down >> and remove all items. 
  319.  2. To rename Tools to Utilities select the item Tools and press the button 
  320.     Change Entry. A dialog box appears allowing you to rename this item. 
  321.  3. Select the item, after which you want to insert the new Submenu. Then press 
  322.     the button Add Submenu to add one. A dialog box appears allowing you to 
  323.     enter the title of a new Submenu. 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 7.2. Setup example 2 ΓòÉΓòÉΓòÉ
  327.  
  328. Assume that you have remove all items, leading to an empty listbox. Now you 
  329. want to add the Applications Backup and Terminal. 
  330.  
  331.  1. The listbox is empty, so you can't select any item. Just press the button 
  332.     Add Program and a dialog box appears, allowing you to enter all the data 
  333.     required for the new Application. 
  334.  2. Now the listbox contains the item Backup, select it and press the button 
  335.     Add Program a second time. Again you get a dialog box, where you enter the 
  336.     data for the Application Terminal. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ 8. Help for PC/2 Menu Installation ΓòÉΓòÉΓòÉ
  340.  
  341. This dialog is used to get a name for a Submenu, which is then added to the 
  342. Popup-Menu. You can enter whatever you like, f.e. to make a Submenu that 
  343. contains OS/2 utilities you might enter Utilities. 
  344.  
  345. If you have choosen in the previous dialog to change the name of a Submenu, 
  346. then overwrite the pre-entered text. 
  347.  
  348. Press Ok to accept, or press Cancel to ignore the data you entered. 
  349.  
  350. Examples 
  351.  
  352. <Backward>                 <Forward> 
  353.  
  354.  
  355. ΓòÉΓòÉΓòÉ 8.1. Menu installation examples ΓòÉΓòÉΓòÉ
  356.  
  357. Assume you have entered the following Submenu Titles: 
  358.  
  359. Title                 Purpose 
  360.  
  361. Prompts               You want to add a Submenu named Prompts, that contains 
  362.                       OS/2 and DOS, fullscreen and windowed command prompts. 
  363.  
  364. Spreadsheets          You want to add a Submenu named Spreadsheets for your 
  365.                       spreadsheet program like Lotus 123/G or Excel. 
  366.  
  367.  
  368. ΓòÉΓòÉΓòÉ 9. Help for PC/2 Program Installation ΓòÉΓòÉΓòÉ
  369.  
  370. This dialog is used to get the title, the path and filename, the working 
  371. directory and parameters of a Menuitem, which is then added to the Popup-Menu. 
  372. Additionally you can fine-tune the appearance of the program you want to add to 
  373. the Popup-Menu. However the standard selections should provide a basis that is 
  374. sufficient for most applications. 
  375.  
  376. Sometimes you want that you can enter a commandline parameter before an 
  377. application is started, f.e. assume that you want to be prompted for a text 
  378. file just before your text-editor is invoked. PC/2 allows you to be prompted 
  379. for commandline parameters in addition to static parameters before the 
  380. application is launched. Press on Commandline Parameters to find out more about 
  381. this feature. 
  382.  
  383. The standard file dialog is opened, if you pressed File Find. Then you can 
  384. easily find the program you want to add, the data of this program are inserted 
  385. automatically. If a batch file was selected, the batch file will be inserted as 
  386. a commandline parameter of a command processor. 
  387.  
  388. Alternatively PC/2 supports also Drag & Drop. You can f.e. use a Drives Object 
  389. to select one application to add to PC/2. Then drag it into a free area within 
  390. the dialog and drop it. PC/2 will insert the entryfields and application type 
  391. correspondingly. 
  392.  
  393. You may also add WPS Objects, either manually or by Drag & Drop. If you insert 
  394. an WPS Object correctly (I know this is a little bit particular) you may start 
  395. your objects via the PC/2 Popup Menu. To add WPS Objects you must know the 
  396. Object ID (Identifier), either for the preinstalled Objects from OS2_20.RC or 
  397. the Object ID defined with installation of one WPS Object by MAKEOBJ.CMD. 
  398.  
  399. If you have choosen in the previous dialog to change the data of a Program, 
  400. then overwrite or change the options you want. 
  401.  
  402. Press Ok to accept, or press Cancel to ignore the data you entered. 
  403.  
  404. For more information click on one of the following items: 
  405.  
  406. o Program Data 
  407. o Program Type 
  408. o Program Style 
  409. o User defined Size & Position 
  410.  
  411. Examples 
  412.  
  413. <Backward>                 <Forward> 
  414.  
  415.  
  416. ΓòÉΓòÉΓòÉ 9.1. Program installation examples ΓòÉΓòÉΓòÉ
  417.  
  418. Assume you want to add Lotus 123/G: 
  419.  
  420. Fieldname             You would enter 
  421.  
  422. Program Title:        Lotus 123/G 
  423.  
  424. Path and Filename:    c:\123g\123g.exe 
  425.  
  426. Working Directory:    c:\123g 
  427.  
  428. Parameters:           (none) 
  429.  
  430. Lotus 123/G is a Presentation Manager application so you would select 
  431. Presentation Manager as program type. The program style may be Maximized, 
  432. because more information is visible. The priority may be left at the default 
  433. selection No Change. 
  434.  
  435. Assume you want to add the WPS Object System Clock (located in the folder OS/2 
  436. System  System Setup): 
  437.  
  438. Fieldname             You would enter 
  439.  
  440. Program Title:        System Clock 
  441.  
  442. Path and Filename:    <WP_CLOCK> 
  443.  
  444. Working Directory:    (n/a) 
  445.  
  446. Parameters:           (n/a) 
  447.  
  448. The System Clock is a WPS Object, so WPS Object is selected as the program 
  449. type. You may have to look into the file OS2_20.RC to get the defined name of 
  450. preinstalled WPS Objects. Most settings are not available for WPS Objects. 
  451.  
  452. Assume you want to add the WPS Object seamless WIN-OS2 Clock. First you must 
  453. create an WPS Object with a known Object ID (Identifier) with MAKEOBJ.CMD, a 
  454. small REXX-utility supplied with PC/2. To do so, start MAKEOBJ.CMD and supply 
  455. the Object ID <WP_WIN_CLOCK> when you're asked to. Then open the newly created 
  456. Object Settings and change them as you usually do, when you want to make an 
  457. Object for a seamless WIN-OS2 session of the WIN-OS2 clock. After you have 
  458. created the WIN-OS2 clock object, you can drag it into this dialog of PC/2: 
  459.  
  460. Fieldname             You would enter 
  461.  
  462. Program Title:        Clock 
  463.  
  464. Path and Filename:    <WP_WIN_CLOCK> 
  465.  
  466. Working Directory:    (n/a) 
  467.  
  468. Parameters:           (n/a) 
  469.  
  470. The seamless WIN-OS2 Clock is a WPS Object, so WPS Object is used as the 
  471. program type. Assuming that you created the seamless WIN-OS2 clock object as 
  472. outlined before, then the Object ID is <WP_WIN_CLOCK>. If you had an WPS Object 
  473. before, and you don't know the Object ID, you have to create a new one with 
  474. MAKEOBJ.CMD, to define a known Object ID. 
  475.  
  476. Sorry, this may be a little complicated, but it is the only way I know to get a 
  477. known Object ID and the only way I know to start seamless WIN-OS2 sessions. 
  478.  
  479.  
  480. ΓòÉΓòÉΓòÉ 9.2. Program Data ΓòÉΓòÉΓòÉ
  481.  
  482. For a normal user it is the easiest way to use the following guidelines. 
  483. According to the type of application you add, some fields may not be editable 
  484. or visible: 
  485.  
  486. Fieldname             You would enter 
  487.  
  488. Program Title:        Here you enter the name, under which the program should 
  489.                       appear in the tasklist. For OS/2 and DOS windows, this 
  490.                       will be the title of the window. You may also name the 
  491.                       Objects here, you want to add. 
  492.  
  493. Path and Filename:    Here you enter the fully qualified path and filename. 
  494.                       F.e. you might enter c:\os2\cmd.exe to obtain an OS/2 
  495.                       command prompt, or c:\os2\mdos\qbasic.exe to start the 
  496.                       basic interpreter. 
  497.  
  498.                       Here you also enter the name of WPS Objects. WPS Objects 
  499.                       are referred either by their defined Object ID (Identity) 
  500.                       f.e. <WP_DRIVES> or <WP_INST> for preinstalled Objects, 
  501.                       of f.e. <WP_USER_CALC> or <WP_WIN_PBRUSH> for Objects 
  502.                       installed by the user with MAKEOBJ.CMD, a REXX-utility 
  503.                       supplied with PC/2. Preinstalled WPS Objects have usually 
  504.                       a defined name, you may need to take a look into the file 
  505.                       OS2_20.RC to get further information. 
  506.  
  507.                       PC/2 can only launch WPS Objects named by their defined 
  508.                       ID, so be carefull to get either the correct ID from 
  509.                       OS2_20.RC or to define an Object with a known ID with 
  510.                       MAKEOBJ.CMD For a user installed Objects, you can freely 
  511.                       use any name, preferably a descriptive name in the form 
  512.                       <WP_xxxx>. 
  513.  
  514.                       Sorry, this may be a little complicated, but it is the 
  515.                       only way I know to get a known Object ID and the only way 
  516.                       I know to start seamless WIN-OS2 sessions. You can't use 
  517.                       the Program Template to create Objects if you want them 
  518.                       to add to PC/2, because PC/2 can't obtain the Object ID 
  519.                       of such Objects. 
  520.  
  521. Working Directory:    Here you enter the directory where the EXE, HLP and DLL 
  522.                       files of your application are located. Before the 
  523.                       application is started, a change drive and change 
  524.                       directory call is made, to make this directory the 
  525.                       working directory. 
  526.  
  527. Parameters:           Here you enter the parameters passed to the application. 
  528.                       PC/2 allows you to be asked for commandline parameters 
  529.                       before the application is invoked. Press on Commandline 
  530.                       Parameters to find out more about this feature. Assume 
  531.                       that you want to use VIEW.EXE to view the command 
  532.                       reference, you would enter c:\os2\book\cmdref.inf. 
  533.  
  534. DOS Settings:         If you select as program type a DOS Full-Screen or DOS 
  535.                       Window, a multiline entryfield is displayed where you can 
  536.                       enter the DOS Settings you need. Default, the DOS 
  537.                       Settings IDLE_SECONDS=5 and IDLE_SENSITIVITY are added if 
  538.                       you create a DOS application for the first time. (You 
  539.                       have to spell the DOS Settings exactly as they are 
  540.                       displayed in the standard DOS Settings dialog - even then 
  541.                       some can't be set for whatever reasons there are.) 
  542.  
  543. File Find:            If you click on this button, the standard file dialog of 
  544.                       OS/2 is displayed where you can select the application 
  545.                       you want to install. The application parameters (f.e. 
  546.                       path) will then be inserted automatically in the 
  547.                       corresponding entryfields. 
  548.  
  549. Drag & Drop:          You can alternatively use the Drag & Drop operation to 
  550.                       install one application. Select one application from f.e. 
  551.                       a Drives object or from a filemanager, drag it into the 
  552.                       dialog to any area that accepts it and drop it. The 
  553.                       settings will be adjusted according to the application 
  554.                       you dragged into. You may also drag any WPS Object into 
  555.                       this dialog, but be carefull to verify the name of the 
  556.                       Object, because I don't know how to do this automatically 
  557.                       (you may need to look into OS2_20.RC for the exact 
  558.                       spelling of preinstalled Objects. 
  559.  
  560. For a power user, the data entered may be less. Because the OS/2 API 
  561. DosStartSession() is used to start the application, all rules for this API 
  562. apply as described in the toolkit. Hence you may leave the entryfield Path and 
  563. Filename blank and then select from the Program Type group an OS/2 or DOS 
  564. fullscreen or window, to get a command prompt. 
  565.  
  566. You may also start an appliciation indirectly through a secondary command 
  567. processor by specifying c:\os2\cmd.exe as the Path and Filename and use then 
  568. the /C or /K option of CMD.EXE in the Parameters entryfield. 
  569.  
  570.  
  571. ΓòÉΓòÉΓòÉ 9.3. Program Type ΓòÉΓòÉΓòÉ
  572.  
  573. Here you can select the type of application you want to add. By default, PC/2 
  574. tries to determine the type of an application you installed via the standard 
  575. file dialog or via Drag & Drop. 
  576.  
  577. You generally have to verify, that the Program Type setting corresponds to the 
  578. application you installed, for most programs you can use Determined by WPS if 
  579. you aren't sure. 
  580.  
  581. According to the Program Type that is selected, some settings may not be 
  582. editable or visible. 
  583.  
  584. OS/2 and DOS Fullscreen or Windows are only used, if you want to start a 
  585. command prompt as the application. In this case, you usually enter in the the 
  586. entryfield Path and Filename of the group Program Data the path of the 
  587. corresponding command processor. A advanced technique to select the type of 
  588. command processor only with these radiobuttons is described under the group 
  589. Program Data. 
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 9.4. Program Style ΓòÉΓòÉΓòÉ
  593.  
  594. These selections should be self-explanatory, you can only change one of the 
  595. radiobuttons, but apply as many checkboxes as you want as the Program Style. 
  596. F.e. if you selected Minimized, Invisible and Background, the application will 
  597. be started minimized, in the background and invisible (this may make sense for 
  598. a backup program). 
  599.  
  600.  
  601. ΓòÉΓòÉΓòÉ 9.5. User defined Size & Position ΓòÉΓòÉΓòÉ
  602.  
  603. Here you can use the checkbox to start an application with a preselected size 
  604. and position. If you select the checkbox Size, Position you will be able to 
  605. modify the size the started application should appear. 
  606.  
  607. You can even specifiy postion coordinates outside your display, which may be 
  608. useful if you have the virtual Desktop feature enabled. Some applications 
  609. determine their position self, by overwriting your input with data usually read 
  610. from a profile. PC/2 can't force such applications to move to the position and 
  611. size you entered. 
  612.  
  613.  
  614. ΓòÉΓòÉΓòÉ 10. Help for PC/2 Resort ΓòÉΓòÉΓòÉ
  615.  
  616. This dialog box contains two listboxes, the left one that displays the 
  617. currently available Menuentries and the right one that displays the currently 
  618. resorted Menuentries. Select the first Menuentry from the left listbox and 
  619. press the Reorder button, to resort it to the right listbox. For the next 
  620. Menuentry(ies) repeat this procedure, until the left listbox is empty. 
  621.  
  622. You can cancel the resort before you have done any sort, but you have to resort 
  623. the complete Submenu once you made one resort operation. 
  624.  
  625. All sorted Menuentries in the right listbox can't be started with PC/2 until 
  626. you complete the resort by pressing OK. Warning! - You have to press OK in the 
  627. Confguration Dialog to write the resorted Menuentries structure to the 
  628. configuration file. 
  629.  
  630. <Backward>                 <Forward> 
  631.  
  632.  
  633. ΓòÉΓòÉΓòÉ 11. Help for PC/2 Startup Parameters ΓòÉΓòÉΓòÉ
  634.  
  635. PC/2 allows you to replace the commandline parameters of your application 
  636. completly or partly. 
  637.  
  638. F.e. assume you have a TCP/IP communications package installed on your system. 
  639. You also have added an Menuitem that start a file transfer program named FTP. 
  640. FTP requires as a parameter the name of the host you want to connect to. To 
  641. prompt you for this parameter immediately before FTP is started, you would 
  642. modify the parameters entryfield of the PC/2 Program Installation dialog like 
  643. [Please enter host address] 
  644.  
  645. Further assume that you selected the Menuitem FTP from the Popup-Menu. Just 
  646. before FTP is started, a dialog box is displayed, requesting the host address 
  647. from you. F.e. you will type ftp-os2.nmsu.edu, then the file transfer program 
  648. will be invoked as if you typed FTP ftp-os2.nmsu.edu from a commandline. 
  649.  
  650. Generally the syntax for the commandline parameters is: 
  651.  
  652. Parameter(s) 1 [Text] Parameter(s) 2 
  653.  
  654. Assume you typed FirstFile.doc as the first and ThirdFile.doc as the second 
  655. parameter. You will be asked by a dialog box, what to replace [Text] with. 
  656. Assume you entered MyFile.doc then the program will be invoked with the 
  657. commandline parameters FirstFile.doc MyFile.doc ThirdFile.doc. The string 
  658. [Text] would have been replaced by MyFile.doc. Of course both parameters may be 
  659. omited, both may contain more than one parameter or only one of them may 
  660. present. Omiting [Text] would start the application without asking you for a 
  661. commandline parameter prior. 
  662.  
  663. PC/2 allows you to edit commandline parameters similar to the WPS (open the 
  664. Settings notebook of any application, position the cursor into the Parameters 
  665. entryfield and press F1 or Help to get further information). 
  666.  
  667. Press Ok to accept the parameters you entered, or press Cancel to replace the 
  668. commandline parameters by an empty string. 
  669.  
  670. <Backward>                 <Forward> 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 12. Help for PC/2 Desktop Setup ΓòÉΓòÉΓòÉ
  674.  
  675. A sliding Focus ensures, that the window under the mouse pointer is always the 
  676. active window (the one that has a highlighted frame). If you move the pointer 
  677. over another window, PC/2 recognizes the pointer movements, and tries to 
  678. activate the window currently under the mouse pointer. The windows will behave 
  679. similar to X-Windows, but the active window is always fully displayed. To 
  680. enable this feature, just check the checkbox named Sliding Focus. 
  681.  
  682. A virtual Desktop is a Desktop enhancement that expands you display. F.e. 
  683. assume that you are running OS/2 on an XGA-2 at a resolution of 1024 * 768 
  684. pixels. Your display has then 1024 columns and 768 rows of pixels, giving you a 
  685. Desktop where application windows can be seen. We will call this the physical 
  686. Desktop. Of course you can start windows outside this Desktop, but you won't be 
  687. able to see them. 
  688.  
  689. PC/2 allows you to expand this Desktop, so that you can move the physical 
  690. Desktop to see the windows you couldn't see before. We will call this 
  691. enhancement the virtual Desktop. Simply speaking, imagine the virtual Desktop 
  692. as an 3 * 3 array of Desktops, with the physical Desktop you now can see in the 
  693. middle. Now imagine, that you can move your physical Desktop around within the 
  694. larger virtual Desktop. F.e. assume that you move the physical Desktop left, 
  695. all windows you have started will move right, so some disappear in the right 
  696. side  and some appear on the left side of your display. 
  697.  
  698. That's just that what PC/2 does for you. If you move your mouse pointer on the 
  699. leftmost column of your display (column 0), all windows move rightwards, as the 
  700. physical Desktop moves leftwards within the virtual Desktop. The same principle 
  701. is used on the rightmost columns and the top and bottom rows. If you move your 
  702. mouse pointer into a corner of your display, the Desktop even will move in two 
  703. directions, leading to a horizontal and a vertical movement. 
  704.  
  705. Of course you can only move your physical Desktop in one direction, as long as 
  706. this movement keeps the physical Desktop within the virtual Desktop. Using this 
  707. feature, you expand your physical Desktop to a 9-fold virtual Desktop. Just 
  708. check the Virtual Desktop checkbox to enable this feature and its options. 
  709.  
  710. By default, OS/2's Desktop is not moved, until you check the Move Desktop 
  711. checkbox. PC/2 has to know the name of this Desktop, so you have to ensure that 
  712. you type its name in the entryfield. Under OS/2 2.0 its usually named OS/2 2.0 
  713. Desktop, but it changes under OS/2 2.1 to Desktop, if you haven't installed it 
  714. over an existing OS/2 2.0 system. Also ensure that you translate is into your 
  715. national language, if you don't use an English OS/2 version. 
  716.  
  717. If you prefer to click, before the physical Desktop is moved, select the 
  718. checkbox Click to Move. After you move your mouse pointer over the surrounding 
  719. rows or columns you have to click, either a single or double click according to 
  720. the commandline option, to move the physical Desktop. 
  721.  
  722. You may also want an overview window, that contains the current layout of the 
  723. virtual Desktop. Select the checkbox Overview Window to enable this feature. 
  724.  
  725. You can use the listbox Virtual Desktop Scroll Percentage to select the 
  726. percentage of the display dimensions the physical Desktop should move for a 
  727. single movement. You can select between 25, 50, 75 and 100 %, with 100 % being 
  728. the default one. 
  729.  
  730. Press Ok to accept the configuration and save it into an INI file, or press 
  731. Cancel to ignore any changes you made. If your INI file is corrupted, PC/2 
  732. assumes default values, which you then can edit and save to a new INI file. 
  733.  
  734. <Backward>                 <Forward> 
  735.  
  736.  
  737. ΓòÉΓòÉΓòÉ 13. Help for PC/2 Errors ΓòÉΓòÉΓòÉ
  738.  
  739. PC/2 can't verify all user input for validity, so some user input may cause 
  740. some PC/2 functions to fail. In this case, a message box is displayed 
  741. containing the module and the sourcecode linenumber that failed. Also a error 
  742. message is displayed containing which error occured and what should be done to 
  743. resolve the problem. 
  744.  
  745. F.e. you might have configured to start the program VIEW.EXE by writing 
  746. c:\os3\view.exe in the entryfield Path and Filename in the Program Installation 
  747. dialog. This of course leads to an error, because when OS/2 tries to start this 
  748. item, it can't find the directory \os3\ simply because it should read \os2\. A 
  749. message box is displayed saying an error occured and that the user input should 
  750. be corrected. 
  751.  
  752. The messagebox has three buttons that may be pressed: 
  753.  
  754. Button                Result 
  755.  
  756. Abort                 PC/2 will be terminated and all unsaved data will be 
  757.                       lost. You have to restart PC\2 again. This button should 
  758.                       be the last one you select. 
  759.  
  760. Retry                 The error is ignored, you may need to correct your data 
  761.                       entered in the entryfields. 
  762.  
  763. Ignore                The error is ignored, you may need to correct your data 
  764.                       entered in the entryfields. 
  765.  
  766. <Backward>                 <Forward>