home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / INIUTIL3.ZIP / INIUTIL.HLP (.txt) < prev    next >
OS/2 Help File  |  1990-06-10  |  24KB  |  894 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Extended Help For INI File Management ΓòÉΓòÉΓòÉ
  3.  
  4. The INI File Manager allows you to perform administrative functions upon your 
  5. OS2 System INI files.  These files are identified in your config.sys file in 
  6. the PROTSHELL statement.  You may not realize it, but the two system INI files 
  7. are necessary to operate OS2 properly. 
  8.  
  9. The following Topics may be selected from this menu: 
  10.  
  11.  Overview:      Purpose and function 
  12.  Anomalies:     (Bugs) 
  13.  
  14.  Action Bar Items 
  15.  
  16.  o File 
  17.  o Appls/Data 
  18.  o Grps/Pgms 
  19.  o Colors 
  20.  o Help 
  21.  
  22.  Dialog Panels 
  23.  
  24.  o Group List Display 
  25.  o Program List Display 
  26.  o Open User INI 
  27.  o Backup System INIs 
  28.  o Backup System INI is Running 
  29.  o About 
  30.  o Appl/Data 
  31.  o Installed Programs Detail Edit 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 1.1. Purpose and Function ΓòÉΓòÉΓòÉ
  35.  
  36. The original purpose of this utility was to provide a way to backup the running 
  37. OS2 INI files.  If the running INI files became damaged, then the PROTSHELL 
  38. statement in the config.sys file could be modified to point at the backups. 
  39.  
  40. Additionally, I have the task of trying to get people up to speed with OS2 in 
  41. our shop and I find myself spending a lot of time updating other people's 
  42. installed program lists.  I wanted a utility that could extract group and 
  43. program definitions and reload them to other user's INI files. 
  44.  
  45. I also got really tired of explaining that when you start a program in a window 
  46. that there is no way of telling it to maximize on startup.  So rather than 
  47. continue to explain that you couldn't do this very sensible thing, I wrote the 
  48. program details update routines to allow the user to modify some of the things 
  49. that the Program Properties update routines don't allow you to get to. 
  50.  
  51. Finally, I got tired of showing people how to reproduce the questionable but 
  52. mysteriously popular color settings that I use.  So, I wrote the color save and 
  53. restore routines. 
  54.  
  55. I hope you find this utility helpful, but (here comes the disclaimer) I am in 
  56. no way responsible for any damages the use of this utility may cause. 
  57.  
  58. If you have any suggestions or comments, I'd like to hear them.  The best way 
  59. to find me is through Compuserve 75600,237. 
  60.  
  61. Dave Lester 06/04/90 
  62.  
  63.  
  64. ΓòÉΓòÉΓòÉ 2. Commercial Announcement ΓòÉΓòÉΓòÉ
  65.  
  66. I hope you find this utility helpful, but (here comes the disclaimer) I am in 
  67. no way responsible for any damages the use of this utility may cause. You are 
  68. free to use this utility at your own risk with no obligation to me, the author, 
  69. for only a short period of time.  If you find this utility as helpful as I 
  70. have, you should send me money to demonstrate your appreciation. Your 
  71. appreciation should rule your generosity.  For example, let's say that you use 
  72. this utility to propigate standard installed programs for 20 users at your 
  73. company's location.  At $.50 a shot, you (or your company) might be moved to 
  74. send me a check for $10.  I'll take it, no problem. 
  75.  
  76. For those of you so inclined, send me money or checks at: 
  77.  
  78.  Dave Lester 
  79.  Box 461 
  80.  4 N. 3rd St. 
  81.  New Freedom, Pa. 17349 
  82.  
  83.  If you have any suggestions or comments, I'd like to hear them.  The best way 
  84.  to find me is through Compuserve 75600,237. 
  85.  
  86.  Dave Lester 06/04/90 
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 3. Anomalies (Bugs) ΓòÉΓòÉΓòÉ
  90.  
  91. I wish that this utility were perfect, but it's not.  Most of the problems are 
  92. centered around the fact that the OS2 treatment of the installed program list 
  93. does not really follow the intentions of the control blocks used.  Most of the 
  94. problems you will find occur while using the program details edit function.  In 
  95. particular, they are: 
  96.  
  97. The initial window position and size parameters are not usable.  The control 
  98. block for this purpose in PROGDETAILS is of type SWP.  The implication is that 
  99. you can do the same things with the SWP control block that you can do with a 
  100. WinSetWindowPos call.  You can't.  The SWP.fs field seems only to accept the 
  101. values that you can define with XYF_ constants.  I have disabled the Size and 
  102. Move radio buttons on the program details edit panel until I can find a way to 
  103. make them work properly. 
  104.  
  105. The environmental string edit function on program details is similarly 
  106. disabled.  This circumvention causes me more pain than you will ever know. The 
  107. Combo Box processing that I coded took about as much time as all the rest 
  108. combined.  The sad truth about the environment string processing is that 
  109. neither PrfAddProgram nor PrfChangeProgram can handle environment string 
  110. processing as documented.  In the PROGDETAILS control block you are supposed to 
  111. pass a PSZ that points to an array of environmental strings terminated with an 
  112. extra '\0'.  I did that, but the Prf calls never handled them properly. The 
  113. first string would come through followed by garbage. 
  114.  
  115.  
  116. ΓòÉΓòÉΓòÉ 4. Action Bar ΓòÉΓòÉΓòÉ
  117.  
  118. Surprise...The Action Bar allows you to select the utility functions. 
  119.  
  120.  
  121. ΓòÉΓòÉΓòÉ 4.1. Action Item File ΓòÉΓòÉΓòÉ
  122.  
  123. Surprise...The file menu item allows you to select functions that operate at 
  124. the file level. 
  125.  
  126. The following items may be selected from the File menu: 
  127.  
  128.  o Open INI File 
  129.  o Backup System INIs 
  130.  o Exit 
  131.  
  132.  
  133. ΓòÉΓòÉΓòÉ 4.1.1. Open INI File ΓòÉΓòÉΓòÉ
  134.  
  135. Select this menu item to open an existing user extracted or backup INI file. If 
  136. you attempt to select the current running INI files, open will fail.  (If you 
  137. could open the running system INIs, you could just use COPY to back them up.) 
  138.  
  139.  
  140. ΓòÉΓòÉΓòÉ 4.1.2. Backup System INI Files ΓòÉΓòÉΓòÉ
  141.  
  142. Select this menu item to backup the running System INI files to files named 
  143. OS2SV.INI and OS2SYSSV.INI. 
  144.  
  145.  
  146. ΓòÉΓòÉΓòÉ 4.1.3. Exit ΓòÉΓòÉΓòÉ
  147.  
  148. Select this menu item to exit the utility. 
  149.  
  150.  
  151. ΓòÉΓòÉΓòÉ 4.2. Action Item Appls/Data ΓòÉΓòÉΓòÉ
  152.  
  153. The original intent was to allow free form edit and display of all application, 
  154. key, and data components.  However, I don't think I have the wherewithall to 
  155. really make that happen.  So all you may do is display application and key 
  156. combinations. 
  157.  
  158. The following items may be selected from the Appls/Data menu: 
  159.  
  160.  o OS2 INI 
  161.  o OS2SYS INI 
  162.  o USER INI 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 4.2.1. OS2 INI ΓòÉΓòÉΓòÉ
  166.  
  167. This selection allows you to look at all of the application and key names in 
  168. the running OS2.INI (or equivalent as named on the PROTSHELL statement.) 
  169.  
  170.  
  171. ΓòÉΓòÉΓòÉ 4.2.2. OS2SYS INI ΓòÉΓòÉΓòÉ
  172.  
  173. This selection allows you to look at all of the application and key names in 
  174. the running OS2SYS.INI (or equivalent as named on the PROTSHELL statement.) 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ 4.2.3. USER INI ΓòÉΓòÉΓòÉ
  178.  
  179. This selection allows you to look at all of the application and key names in 
  180. any INI file that was created using OS2 profile management calls.  The file 
  181. name must end in .INI . 
  182.  
  183.  
  184. ΓòÉΓòÉΓòÉ 4.3. Action Item Grps/Pgms ΓòÉΓòÉΓòÉ
  185.  
  186. The Groups and Programs unload/reload functions may be accessed from this menu 
  187. selection.  These functions allow you to extract installed programs from a 
  188. running INI and reload them to other users' systems.  In that way, you can 
  189. replicate a given installed program environment for any number of users without 
  190. having to go through a long manual process.  You can also run the reload 
  191. function from a full INI backup file.  Just use the OS2SV.INI dataset. 
  192.  
  193. The program details selections allow you to edit installed program attributes. 
  194. (Even some that are not available from the Program Properties selection 
  195. provided with OS2.)  In particular, you may specify start minimized and start 
  196. maximized for widowed (VIO) programs.  You may also elect to have installed 
  197. programs be invisible to the end user, but actually still reside on the start 
  198. program list for a group. 
  199.  
  200. The following items may be selected from the Grps/Pgms menu: 
  201.  
  202.  o Extract from system 
  203.  o Reload to system 
  204.  o System program details 
  205.  o User program details 
  206.  
  207.  
  208. ΓòÉΓòÉΓòÉ 4.3.1. Extract from system ΓòÉΓòÉΓòÉ
  209.  
  210. Use this selection to extract installed programs and groups from your running 
  211. system and right them to another INI file.  The target INI file may be used to 
  212. reload the extracted groups and program entries to your own or someone else's 
  213. running system. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ 4.3.2. Reload to system ΓòÉΓòÉΓòÉ
  217.  
  218. Use this selection to reload to the running INI groups and programs that were 
  219. previously extracted to user INI files. 
  220.  
  221.  
  222. ΓòÉΓòÉΓòÉ 4.3.3. System program details ΓòÉΓòÉΓòÉ
  223.  
  224. Use this selection to edit the running system's installed program list.  You 
  225. can specify many things that aren't allowed using the OS2 program properties 
  226. dialog. 
  227.  
  228.  
  229. ΓòÉΓòÉΓòÉ 4.3.4. User program details ΓòÉΓòÉΓòÉ
  230.  
  231. Use this selection to edit the program lists of previously created INI extracts 
  232. and backups. 
  233.  
  234.  
  235. ΓòÉΓòÉΓòÉ 4.4. Action Item Colors ΓòÉΓòÉΓòÉ
  236.  
  237. The Colors menu selection allows you to select either to backup system colors 
  238. to OS2CLR.INI or to restore from a OS2CLR.INI or OS2SV.INI backup file. 
  239.  
  240. Sorry, but the Colors routines aren't done yet.  That's why the action bar 
  241. selection is disabled. 
  242.  
  243. The following items may be selected from the Colors menu: 
  244.  
  245.  o Backup colors 
  246.  o Restore colors 
  247.  
  248.  
  249. ΓòÉΓòÉΓòÉ 4.4.1. Backup Colors ΓòÉΓòÉΓòÉ
  250.  
  251. Use this selection to create an OS2CLR.INI backup file containing information 
  252. from your running system. 
  253.  
  254.  
  255. ΓòÉΓòÉΓòÉ 4.4.2. Restore Colors ΓòÉΓòÉΓòÉ
  256.  
  257. Use this selection to restore the running system colors from a previously 
  258. created OS2CLR.INI file. 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 4.5. Action Item Help ΓòÉΓòÉΓòÉ
  262.  
  263. The Help menu item allows you access to the Help subsystem.  This utility 
  264. provides a full implementation of the OS2 IPF facility.  That means that you 
  265. can get field level help at any time by positioning on the field or menu item 
  266. an pressing PF1.  Extended help may be requested by pressing PF2 at any time. 
  267. (See Keys help.) 
  268.  
  269. The following items may be selected from the Help menu: 
  270.  
  271.  o Help for help 
  272.  o Extended help 
  273.  o Keys help 
  274.  o Help index 
  275.  o About 
  276.  
  277.  
  278. ΓòÉΓòÉΓòÉ 4.5.1. Help for Help ΓòÉΓòÉΓòÉ
  279.  
  280. This selection gives you information regarding the use of the help subsystem. 
  281.  
  282.  
  283. ΓòÉΓòÉΓòÉ 4.5.2. Extended Help ΓòÉΓòÉΓòÉ
  284.  
  285. This selection invokes the help subsystem and will provide general help for the 
  286. INI File Management Utility. 
  287.  
  288.  
  289. ΓòÉΓòÉΓòÉ 4.5.3. Keys Help ΓòÉΓòÉΓòÉ
  290.  
  291. This selection will present you with information regarding the use of the 
  292. keyboard in the INI File Management Utility. 
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 4.5.4. Help Index ΓòÉΓòÉΓòÉ
  296.  
  297. The help information for the INI File Management Utility has been indexed to 
  298. some extent by topic.  This selection will invoke the help subsystem and 
  299. present that index. 
  300.  
  301.  
  302. ΓòÉΓòÉΓòÉ 4.5.5. About ΓòÉΓòÉΓòÉ
  303.  
  304. This selection will present a Logo panel that displays the utility version 
  305. number and generation date. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 5. Dialog Panels ΓòÉΓòÉΓòÉ
  309.  
  310. Dialog panels allow you to manipulate the execution of the utility. 
  311.  
  312.  
  313. ΓòÉΓòÉΓòÉ 5.1. Group List Display ΓòÉΓòÉΓòÉ
  314.  
  315. The group list display panel is used to allow you to choose which group you 
  316. wish to process.  The actual process is either backup to an INI or restore from 
  317. an INI. 
  318.  
  319. The following controls are active in the group list display panel: 
  320.  
  321.  o Enter 
  322.  o Cancel 
  323.  o Group List 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 5.1.1. Enter on Group List ΓòÉΓòÉΓòÉ
  327.  
  328. The Enter control may be used to process a selected item in the group list box 
  329. from the Group List Display Panel. If no group list item is selected, the enter 
  330. key does nothing. 
  331.  
  332.  
  333. ΓòÉΓòÉΓòÉ 5.1.2. Cancel on Group List ΓòÉΓòÉΓòÉ
  334.  
  335. The Cancel control will terminate group list processing and return to the 
  336. calling function without processing the selected group list item from the Group 
  337. List Display Panel. 
  338.  
  339.  
  340. ΓòÉΓòÉΓòÉ 5.1.3. Group List ΓòÉΓòÉΓòÉ
  341.  
  342. The group list control enables you to select an installed group to process. 
  343. You select by clicking on the item you want to select.  Double clicking the 
  344. item performs the function of selecting the item and hitting the Enter control 
  345. on the Group List Display Panel. 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ 5.2. Program List Display ΓòÉΓòÉΓòÉ
  349.  
  350. The program list display panel is used to allow you to choose one or more 
  351. programs you wish to process.  The actual process is either backup to an INI or 
  352. restore from an INI. 
  353.  
  354. The following controls are active in the program list display panel: 
  355.  
  356.  o Enter 
  357.  o Cancel 
  358.  o Program List 
  359.  
  360.  
  361. ΓòÉΓòÉΓòÉ 5.2.1. Enter on Program List ΓòÉΓòÉΓòÉ
  362.  
  363. The Enter control may be used to process the selected item(s) in the program 
  364. list box from the Program List Display Panel. If no program list item is 
  365. selected, the enter key does nothing. 
  366.  
  367.  
  368. ΓòÉΓòÉΓòÉ 5.2.2. Cancel on Program List ΓòÉΓòÉΓòÉ
  369.  
  370. The Cancel control will terminate program list processing and return to the 
  371. calling function without processing the selected program list item(s) from the 
  372. Program List Display Panel. 
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ 5.2.3. Program List ΓòÉΓòÉΓòÉ
  376.  
  377. The program list control enables you to select installed program(s) to process 
  378. from the Program List Display Panel. You select by clicking on the item(s) you 
  379. want to select.  Double clicking the item does not perform the function of 
  380. selecting the item and hitting the Enter control.  You must click the Enter 
  381. control (or press the Enter key.)  Clicking on an already selected list item 
  382. will deselect that item. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 5.3. Open a User INI File ΓòÉΓòÉΓòÉ
  386.  
  387. The Open INI dialog panel allows you to specify the target or source user INI 
  388. file with which to process an extract or reload.  You should have a mouse in 
  389. order to work with this dialog properly. 
  390.  
  391. The following controls are active in the Open INI dialog: 
  392.  
  393.  o Enter 
  394.  o Cancel 
  395.  o INI Name 
  396.  o Drive List 
  397.  o Directory List 
  398.  o File List 
  399.  
  400.  
  401. ΓòÉΓòÉΓòÉ 5.3.1. Enter on Open INI File ΓòÉΓòÉΓòÉ
  402.  
  403. The Enter control will cause open to process the INI file displayed in the INI 
  404. Name entry box on the Open INI dialog panel. If the INI Name entry box is 
  405. empty, the enter key does nothing. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 5.3.2. Cancel on Open INI File ΓòÉΓòÉΓòÉ
  409.  
  410. The Cancel control will abort the open process for the INI file displayed in 
  411. the INI Name entry box on the Open INI dialog panel. If the INI Name entry box 
  412. is empty, the enter key does nothing. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 5.3.3. File Name on Open INI File ΓòÉΓòÉΓòÉ
  416.  
  417. The File Name entry box control specifies the specific file name to open on the 
  418. Open INI dialog panel. You may input the name manually or use the mouse to 
  419. select an existing INI file from the File List box. 
  420.  
  421.  
  422. ΓòÉΓòÉΓòÉ 5.3.4. Drive List on Open INI File ΓòÉΓòÉΓòÉ
  423.  
  424. The drive list control allows you to change the drive to search for or create a 
  425. user INI file on the Open INI dialog panel. A list of the available drives is 
  426. displayed.  Double clicking an entry in the list changes to the drive that the 
  427. entry specifies and reloads the directory and file lists for the current 
  428. directory on that drive. 
  429.  
  430.  
  431. ΓòÉΓòÉΓòÉ 5.3.5. Directory List on Open INI File ΓòÉΓòÉΓòÉ
  432.  
  433. The directory list control displays the directories that are available from the 
  434. current directory on the selected drive in the Open INI dialog panel. Double 
  435. clicking an entry in the directory list makes that directory become the current 
  436. directory and reloads the file list control box. 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 5.3.6. File List on Open INI File ΓòÉΓòÉΓòÉ
  440.  
  441. The file list control displays existing INI files in the current working 
  442. directory of the active drive.  Clicking on an item in the file list causes 
  443. that item to be placed in the INI file name entry box on the Open INI dialog 
  444. panel. Double clicking on an item in the file list control causes that item to 
  445. be placed in the INI file name entry box and emulates the Entry control 
  446. function. 
  447.  
  448.  
  449. ΓòÉΓòÉΓòÉ 5.4. Backup System INIs ΓòÉΓòÉΓòÉ
  450.  
  451. The backup system INIs dialog allows you to specify the target drive and 
  452. directory to contain the files OS2SV.INI AND OS2SYSSV.INI.  These files will be 
  453. exact copies of the running system INI files.  They will, however, be a little 
  454. smaller because they will not have incurred update fragmentation. 
  455.  
  456. The following controls are active in the backup system INIs dialog: 
  457.  
  458.  o Enter 
  459.  o Cancel 
  460.  o Drive List 
  461.  o Directory List 
  462.  
  463.  
  464. ΓòÉΓòÉΓòÉ 5.4.1. Enter on Backup System INIs ΓòÉΓòÉΓòÉ
  465.  
  466. The Enter control will cause backup to create files OS2SV.INI and OS2SYSSV.INI 
  467. on the drive and the directory selected in the Backup System INIs panel. 
  468.  
  469.  
  470. ΓòÉΓòÉΓòÉ 5.4.2. Cancel on Backup System INIs ΓòÉΓòÉΓòÉ
  471.  
  472. The Cancel control will exit the backup process without creating INI backups on 
  473. the drive and the directory selected in the Backup System INIs panel. 
  474.  
  475.  
  476. ΓòÉΓòÉΓòÉ 5.4.3. Drive List on Backup System INIs ΓòÉΓòÉΓòÉ
  477.  
  478. The drive list control allows you to change the drive on which the files 
  479. OS2SV.INI and OS2SYSSV.INI will be created in the Backup System INIs panel. You 
  480. may change to one of the available drives by double clicking its list item. 
  481.  
  482.  
  483. ΓòÉΓòÉΓòÉ 5.4.4. Directory List on Backup System INIs ΓòÉΓòÉΓòÉ
  484.  
  485. The directory list control allows you to change the current directory on which 
  486. the files OS2SV.INI and OS2SYSSV.INI will be created in the Backup System INIs 
  487. panel. You may change to one of the available directories by double clicking 
  488. its list item. 
  489.  
  490.  
  491. ΓòÉΓòÉΓòÉ 5.5. Backup INIs Running ΓòÉΓòÉΓòÉ
  492.  
  493. It takes a while to backup the running system INIs using the OS2 profile 
  494. management calls.  I guess this is due to the indexed nature of the data. 
  495. Whatever, I had to create a separate thread to do the backup so that you 
  496. wouldn't have to just sit there like a dummy until it got done.  The backup 
  497. INIs running dialog won't talk to you.  It listens only for the completion of 
  498. the thread created for the backup. I'm afraid that I didn't want to spend a lot 
  499. of time in cosmetic coding, so this dialog (and all the rest in this utility) 
  500. will not let you minimize the application window.  However, there is nothing to 
  501. keep you from activating another session and doing productive work while the 
  502. backup is running. 
  503.  
  504. As long as the backup running dialog panel is showing, the backup is actually 
  505. running.  This will be evidenced by a lot of disk activity since the profile 
  506. calls must write very small blocks. 
  507.  
  508.  
  509. ΓòÉΓòÉΓòÉ 5.6. About ΓòÉΓòÉΓòÉ
  510.  
  511. Since I'm not really sure how much more effort I intend to put into this 
  512. utility, the About dialog is probably not much more than an ego statement on my 
  513. part.  The version number is usually helpful for problem resolution, but things 
  514. being what they are, don't expect it to change. 
  515.  
  516. The following control is active in the About dialog: 
  517.  
  518.  o Enter 
  519.  
  520.  
  521. ΓòÉΓòÉΓòÉ 5.6.1. Enter on About ΓòÉΓòÉΓòÉ
  522.  
  523. The Enter control will exit the About dialog panel. 
  524.  
  525.  
  526. ΓòÉΓòÉΓòÉ 5.7. Appl/Data ΓòÉΓòÉΓòÉ
  527.  
  528. The Appl/Data dialog is pretty much a limited use item.  I had intended to 
  529. allow you to edit Key/Data information by application name.  However, once I 
  530. got into the mechanics of the data editting function, I realized that it 
  531. required a lot more work than I ever intend to give to this project.  As it 
  532. stands now, you can display keynames for any given application name. 
  533.  
  534. The following controls are active in the appl/data dialog: 
  535.  
  536.  o Enter 
  537.  o Cancel 
  538.  o Application List 
  539.  o Key List 
  540.  
  541.  
  542. ΓòÉΓòÉΓòÉ 5.7.1. Enter on Appl/Data ΓòÉΓòÉΓòÉ
  543.  
  544. The Enter control in the Appl/Data panel is really the same as Cancel since the 
  545. data edit part of this function is not enabled.  If you hit Enter, you exit the 
  546. dialog. 
  547.  
  548.  
  549. ΓòÉΓòÉΓòÉ 5.7.2. Cancel on Appl/Data ΓòÉΓòÉΓòÉ
  550.  
  551. The Cancel control exits from the Appl/Data panel. 
  552.  
  553.  
  554. ΓòÉΓòÉΓòÉ 5.7.3. Application List on Appl/Data ΓòÉΓòÉΓòÉ
  555.  
  556. The application list control allows you to select the application name for 
  557. which you wish to see key names on the Appl/Data panel.  By double clicking an 
  558. item in the application name list, you cause the key name list to be loaded 
  559. with keynames that belong to the application. 
  560.  
  561.  
  562. ΓòÉΓòÉΓòÉ 5.7.4. Key List on Appl/Data ΓòÉΓòÉΓòÉ
  563.  
  564. The key list control displays the keys for the application name that was 
  565. selected on the Appl/Data panel. 
  566.  
  567.  
  568. ΓòÉΓòÉΓòÉ 5.8. Installed Program Details ΓòÉΓòÉΓòÉ
  569.  
  570. It's funny that the Installed Program Details edit dialog was almost a second 
  571. thought because it may turn out to be the most useful part of this utility. 
  572. With this dialog you can change a great many things for an installed program 
  573. that you can not change through OS2 program properties dialogs.  In particular, 
  574. you can specify that a program entry is invisible on the group list, a program 
  575. should be started minimized or maximized, and you can set icons for OS2 
  576. windowed and full screen entries. 
  577.  
  578. Starting programs minimized and maximized works for windowed (VIO) programs and 
  579. presentation manager programs that do not modifiy system window position and 
  580. size attributes during program initialization. 
  581.  
  582. Icon settings work only for for windowed (VIO) and OS2 fullscreen programs. 
  583. The icon will only show while the session is minimized.  To tell you the truth, 
  584. I was more than a little surprised that the icon specification is ignored on 
  585. the group list for the installed program. 
  586.  
  587. PoopDoodles!  There is are a couple of problems with the program details edit 
  588. function.  See Bugs. 
  589.  
  590. The following controls are active in the backup system INIs dialog: 
  591.  
  592.  o Enter 
  593.  o Cancel 
  594.  o Title 
  595.  o Path 
  596.  o Parms 
  597.  o Directory 
  598.  o Icon 
  599.  o Full Screen 
  600.  o Window 
  601.  o PM 
  602.  o DOS 
  603.  o Visible 
  604.  o Minimize 
  605.  o Maximize 
  606.  o Size 
  607.  o Move 
  608.  o X Position 
  609.  o CX Position 
  610.  o Y Position 
  611.  o CX Position 
  612.  o Environment Strings 
  613.  
  614.  
  615. ΓòÉΓòÉΓòÉ 5.8.1. Enter on Program Details ΓòÉΓòÉΓòÉ
  616.  
  617. The Enter control in the Program Details panel accepts any changes that you 
  618. have made to input, check, and radio box controls and writes those changes to 
  619. the running system, backup or extract INI file that you are processing. 
  620.  
  621.  
  622. ΓòÉΓòÉΓòÉ 5.8.2. Cancel on Program Details ΓòÉΓòÉΓòÉ
  623.  
  624. The Cancel control in the Program Details panel ignores any changes that you 
  625. have made to input, check, and radio box controls and returns you to the dialog 
  626. that called the program details dialog. 
  627.  
  628.  
  629. ΓòÉΓòÉΓòÉ 5.8.3. Title on Program Details ΓòÉΓòÉΓòÉ
  630.  
  631. The Title input box control in the Program Details panel allows you to change 
  632. the program title that appears on the group list. 
  633.  
  634.  
  635. ΓòÉΓòÉΓòÉ 5.8.4. Path on Program Details ΓòÉΓòÉΓòÉ
  636.  
  637. The Path input box control in the Program Details panel allows you to change 
  638. the path name that will be used to execute the program entry on the group list. 
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ 5.8.5. Parms on Program Details ΓòÉΓòÉΓòÉ
  642.  
  643. The Parms input box control in the Program Details panel allows you to change 
  644. the program parameters that will be passed to the program when it executes. 
  645.  
  646.  
  647. ΓòÉΓòÉΓòÉ 5.8.6. Directory on Program Details ΓòÉΓòÉΓòÉ
  648.  
  649. The Directory input box control in the Program Details panel allows you to 
  650. change the directory that will be made current before the specified program is 
  651. invoked. 
  652.  
  653.  
  654. ΓòÉΓòÉΓòÉ 5.8.7. Icon on Program Details ΓòÉΓòÉΓòÉ
  655.  
  656. The Icon input box control in the Program Details panel allows you to change 
  657. the icon that appears when the specified program is minimized. 
  658.  
  659. Icon settings work only for for windowed (VIO) and OS2 fullscreen programs. 
  660. The icon will only show while the session is minimized.  To tell you the truth, 
  661. I was more than a little surprised that the icon specification is ignored on 
  662. the group list for the installed program. 
  663.  
  664.  
  665. ΓòÉΓòÉΓòÉ 5.8.8. Full Screen on Program Details ΓòÉΓòÉΓòÉ
  666.  
  667. The Full Screen radio control in the Program Details panel allows you to 
  668. specify that the program will be invoked as an OS2 full screen application. 
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 5.8.9. Window on Program Details ΓòÉΓòÉΓòÉ
  672.  
  673. The Win radio control in the Program Details panel allows you to specify that 
  674. the program will be invoked as an OS2 VIO windowed application. 
  675.  
  676.  
  677. ΓòÉΓòÉΓòÉ 5.8.10. PM on Program Details ΓòÉΓòÉΓòÉ
  678.  
  679. The PM radio control in the Program Details panel allows you to specify that 
  680. the program will be invoked as an OS2 Presentation Manager application. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 5.8.11. DOS on Program Details ΓòÉΓòÉΓòÉ
  684.  
  685. The DOS radio control in the Program Details panel allows you to specify that 
  686. the program will be invoked as a DOS full screen application. 
  687.  
  688.  
  689. ΓòÉΓòÉΓòÉ 5.8.12. Visible on Program Details ΓòÉΓòÉΓòÉ
  690.  
  691. The Visible check box control in the Program Details panel allows you to 
  692. specify that the program should not appear on the group list. This will make 
  693. the entry un-invokable by the user, but will be available to certain OS2 start 
  694. session and program calls.  It will, of course, be available to this utility 
  695. for later details editting. 
  696.  
  697.  
  698. ΓòÉΓòÉΓòÉ 5.8.13. Minimize on Program Details ΓòÉΓòÉΓòÉ
  699.  
  700. The Minimize radio control in the Program Details panel allows you to specify 
  701. that the program will be invoked as an OS2 icon. 
  702.  
  703. Starting programs minimized and maximized works for windowed (VIO) programs and 
  704. presentation manager programs that do not modifiy system window position and 
  705. size attributes during program initialization. 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ 5.8.14. Maximize on Program Details ΓòÉΓòÉΓòÉ
  709.  
  710. The Maximize radio control in the Program Details panel allows you to specify 
  711. that the program will be invoked with size maximized. 
  712.  
  713. Starting programs minimized and maximized works for windowed (VIO) programs and 
  714. presentation manager programs that do not modifiy system window position and 
  715. size attributes during program initialization. 
  716.  
  717.  
  718. ΓòÉΓòÉΓòÉ 5.8.15. Size on Program Details ΓòÉΓòÉΓòÉ
  719.  
  720. The Size radio control in the Program Details panel should allow you to specify 
  721. that the size of the window in which the program will be invoked.  It just 
  722. doesn't seem to work, so I have disabled the control. I would like to hear any 
  723. suggestions for this specification.  The control block is type SWP and has the 
  724. fields to specify size and location info, but it appears that the program 
  725. starter function uses the data like XYF_ fields in the start session call. 
  726.  
  727.  
  728. ΓòÉΓòÉΓòÉ 5.8.16. Move on Program Details ΓòÉΓòÉΓòÉ
  729.  
  730. The Move radio control in the Program Details panel has been disabled because 
  731. it doesn't work.  The the discription for the Size control. 
  732.  
  733.  
  734. ΓòÉΓòÉΓòÉ 5.8.17. X on Program Details ΓòÉΓòÉΓòÉ
  735.  
  736. The X input box control in the Program Details panel has been disabled because 
  737. it doesn't work.  The the discription for the Size control. 
  738.  
  739.  
  740. ΓòÉΓòÉΓòÉ 5.8.18. CX on Program Details ΓòÉΓòÉΓòÉ
  741.  
  742. The CX input box control in the Program Details panel has been disabled because 
  743. it doesn't work.  The the discription for the Size control. 
  744.  
  745.  
  746. ΓòÉΓòÉΓòÉ 5.8.19. Y on Program Details ΓòÉΓòÉΓòÉ
  747.  
  748. The Y input box control in the Program Details panel has been disabled because 
  749. it doesn't work.  The the discription for the Size control. 
  750.  
  751.  
  752. ΓòÉΓòÉΓòÉ 5.8.20. CY on Program Details ΓòÉΓòÉΓòÉ
  753.  
  754. The CY input box control in the Program Details panel has been disabled because 
  755. it doesn't work.  The the discription for the Size control. 
  756.  
  757.  
  758. ΓòÉΓòÉΓòÉ 5.8.21. Environment Strings on Program Details ΓòÉΓòÉΓòÉ
  759.  
  760. The Environment String combo box control in the Program Details panel provides 
  761. a way for you to modify the environmental variables that will be available to 
  762. the program when it is executed.  PoopDoodles!  There is a problem with 
  763. environmental string handling.  See Bugs. 
  764.  
  765. You can input a new environmental string into the edit portion of the combo 
  766. box.  Press ALT-Insert to add the string to the stored environmental strings. 
  767.  
  768. You can delete an existing environmental string by loading that string into the 
  769. edit portion of the combo box (use arrow keys or click on a list item) and 
  770. pressing ALT-Delete. 
  771.  
  772. You can edit an existing environmental string by loading it into the edit 
  773. portion of the combo box, using normal key edits, adding it to the list portion 
  774. of the combo box, and going back to delete the original item. 
  775.  
  776. You are not allowed to add duplicate strings to the environment string list. 
  777.  
  778.  
  779. ΓòÉΓòÉΓòÉ 6. Help for Key Assignments ΓòÉΓòÉΓòÉ
  780.  
  781. The list of keys is arranged in groups. 
  782.  
  783. ACCELERATOR KEYS 
  784.  
  785.  F3 
  786.       Exit program 
  787.  
  788.  Program Details Environment Edit Keys 
  789.  
  790.  ALT-Insert 
  791.       Add contents of Combo Edit Box to Environment List 
  792.  
  793.  ALT-Delete 
  794.       Delete contents of Combo Edit Box from Environment List 
  795.  
  796.  HELP KEYS 
  797.  
  798.  F1 
  799.       Get help 
  800.  
  801.  F2 
  802.       Get extended help (from within any help window) 
  803.  
  804.  Alt+F4 
  805.       End help 
  806.  
  807.  F9 
  808.       Go to a list of keys (from within any help window) 
  809.  
  810.  F11 
  811.       Go to the help index (from within any help window) 
  812.  
  813.  Esc 
  814.       Previous Help Panel, or End help if only one panel 
  815.  
  816.  Alt+F6 
  817.       Go to/from help and programs 
  818.  
  819.  Shift+F10 
  820.       Get help for help 
  821.  
  822.  SYSTEM KEYS 
  823.  
  824.  Alt+F6 
  825.       Switch to the next windowed program 
  826.  
  827.  Alt+Esc 
  828.       Switch to the next program, including full-screen programs 
  829.  
  830.  Ctrl+Esc 
  831.       Switch to the Task List 
  832.  
  833.  WINDOW KEYS 
  834.  
  835.  F3 
  836.       Close a window 
  837.  
  838.  F10 
  839.       Go to/from the action bar 
  840.  
  841.  Arrow keys 
  842.       Move among choices 
  843.  
  844.  End 
  845.       Go to the last choice in a pull-down 
  846.  
  847.  Esc 
  848.       Cancel a pull-down or the system menu 
  849.  
  850.  Home 
  851.       Go to the first choice in a pull-down 
  852.  
  853.  PgUp 
  854.       Scroll the contents of the window up one page 
  855.  
  856.  PgDn 
  857.       Scroll the contents of the window down one page 
  858.  
  859.  Underlined letter 
  860.       Move among the choices on the action bar and pull-downs 
  861.  
  862.  Alt+F10 
  863.       Go to/from the action bar 
  864.  
  865.  Alt+F4 or F3 
  866.       Close the window 
  867.  
  868.  Alt+F5 
  869.       Restore the window 
  870.  
  871.  Alt+F7 
  872.       Move the window 
  873.  
  874.  Alt+F8 
  875.       Size the window 
  876.  
  877.  Alt+F9 
  878.       Minimize the window 
  879.  
  880.  Alt+F10 
  881.       Maximize the window 
  882.  
  883.  Ctrl+PgDn or Shift+F8 
  884.       Scroll the contents of the window right one page 
  885.  
  886.  Ctrl+PgUp or Shift+F7 
  887.       Scroll the contents of the window left one page 
  888.  
  889.  Shift+Esc or Alt+Spacebar 
  890.       Go to/from the system menu 
  891.  
  892.  Shift+Esc or Alt 
  893.       Go to/from the system menu of a text window 
  894.