home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / iniedi12.zip / INIEDIT.ZIP / English.inf (.txt) next >
OS/2 Help File  |  2001-04-12  |  38KB  |  821 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction and Installation ΓòÉΓòÉΓòÉ
  3.  
  4. This is test version of INI editor for binary OS/2 INI and plain-text WIN INI 
  5. files. 
  6.  
  7. Features: 
  8.  
  9.      Edit local INI files (on your computer) and remote INI files (on remote 
  10.       host) 
  11.      Save OS/2 (binary) INI files as WIN (plain-text) INI files and vice 
  12.       versa. 
  13.      Current INI file can be used as template for Rexx script to create new 
  14.       INI file. 
  15.      In Safe Mode, file can't be changed or deleted. 
  16.      Cut/copy Values to Clipboard, and paste from Clipboard. Export/import 
  17.       Applications, Keys and Values to/from file TRANSFER.INI. 
  18.  
  19.  Requirements: 
  20.  
  21.      OS/2 Warp: Version 3 with FP35 and above, Version 4 with FP6 and above. 
  22.      Rexx (RexxUtil.dll version 2.00 is recommended). 
  23.      TCP/IP and rxsock.dll (to enable work with remote INI files). 
  24.  
  25.   CAUTION:
  26.  CHANGES ARE WRITTEN TO INI FILES IMMEDIATELY. Here is NO UNDO function. Wrong 
  27.  entries can cause serious problems ! If you are not sure what you are doing, 
  28.  use Safe mode ! 
  29.  
  30.  Installation 
  31.  
  32.  Files in archive iniedit120.zip: 
  33.  
  34.  INIedit.exe              Program 
  35.  INIedit.ico              Icon for program 
  36.  Inibmp32.dll             Bitmaps 
  37.  INIinst.cmd              Install / UnInstall script 
  38.  ENGLISH.INI              Language file 
  39.  English.inf              Manual (this file) 
  40.  FastIni.dll              Library for fast access to INI files (Freeware - 
  41.                           Author Dennis Bareis). 
  42.  server.zip               Server part of INIserv package (Freeware - Author 
  43.                           Peter Moylan) 
  44.  
  45.  Create empty directory for INI editor and unzip iniedit120.zip there. If you 
  46.  are already using my INI tools, DO NOT unzip iniedit120.zip to INI tools 
  47.  directory - configuration files are different! Run INIinst.cmd, select I to 
  48.  begin installation and follow instructions. 
  49.  
  50.  When finished, copy files FastIni.dll and Inibmp32.dll to directory in 
  51.  LIBPATH. If you already have file FastIni.dll in LIBPATH directory, you can 
  52.  delete this file. 
  53.  
  54.  To uninstall INI editor, run INIinst.cmd, select U and follow instructions. 
  55.  When finished, delete all files in directory where you installed INI editor, 
  56.  and Inibmp32.dll. 
  57.  
  58.  Related Topics: 
  59.  
  60.       Change data between files 
  61.       How to get help 
  62.       Settings 
  63.       INI editor 
  64.       Remote INI files 
  65.       WIN INI files 
  66.       Explanation of terms 
  67.  
  68.  
  69. ΓòÉΓòÉΓòÉ 1.1. Change data between files ΓòÉΓòÉΓòÉ
  70.  
  71. To change data between files and programs, you can: 
  72.  
  73.  Cut and copy Values to Clipboard, paste from Clipboard 
  74.       You can cut or copy Values to Clipboard in ASCII and HEX edit in INI 
  75.       editor, Clipboard contents can be used in ASCII and HEX editing of other 
  76.       Value, or in INI find as search string. 
  77.  
  78.  Export to / Import from TRANSFER.INI 
  79.       When you edit INI file, you can select Application (with all it's Keys 
  80.       and Values) or Key (with Value) and export to file TRANSFER.INI. 
  81.       You can import selected Application (with all it's Keys and Values) or 
  82.       Key (with Value) from file TRANSFER.INI to currently opened INI file. 
  83.  
  84.       Note:  file TRANSFER.INI is created in INI editor working directory. All 
  85.              exports are written to this file. When it grows, you can delete 
  86.              it. It will be created next time when needed. 
  87.  
  88.  
  89. ΓòÉΓòÉΓòÉ 1.2. How to get help ΓòÉΓòÉΓòÉ
  90.  
  91.    1. Status line 
  92.  
  93.            Most of windows and dialogs in INI editor have status line in the 
  94.            bottom of dialog. If you move pointer over control (button, 
  95.            checkbox, radio button, list, entry field ...), you'll see short 
  96.            description of action you can perform if you press this control. 
  97.  
  98.    2. Manual 
  99.  
  100.            Detailed explanation and instruction about INI editor can be found 
  101.            in this manual. 
  102.            Colors and styles used in manual: 
  103.                      Bold - title, some important information ... 
  104.                      Blue - link to related topic in this manual 
  105.                      Red - warning, caution 
  106.                      Pink - button or other control that should be selected to 
  107.                      do described action 
  108.  
  109.    3. Contacting the author 
  110.  
  111.            If you need more help, and can't find it here, or you think some 
  112.            important information is missing in this manual,  contact me. 
  113.  
  114.  
  115. ΓòÉΓòÉΓòÉ 2. Settings ΓòÉΓòÉΓòÉ
  116.  
  117. After you installed INI editor, start it and open Settings submenu from 
  118. PullDown menu (press Alt-S and select Settings), or press  button, to open 
  119. Settings dialog. 
  120.  
  121. General 
  122.  
  123.  Open Files via FileList 
  124.       You can open file via FileList or standard FileOpen dialog. 
  125.  
  126.  Safe mode (no edit) 
  127.       If you select Safe mode, INI files can not be created, changed or 
  128.       deleted. If Safe mode is ON, only Open, Info, Settings, Help and Exit 
  129.       buttons in Main toolbar are enabled, and all buttons in Application and 
  130.       Key toolbar are disabled. 
  131.  
  132.  Size of INI editor 
  133.       You can select width of main INI editor's dialog between 550 pixels and 
  134.       screen width, and height of main INI editor's dialog between 460 pixels 
  135.       and screen height. 
  136.  
  137.  Save position on exit 
  138.       You can select to save position of INI editor on exit. 
  139.  
  140.  Remote connection 
  141.  
  142.  In the list are displayed all remote hosts. On install program will add one 
  143.  default host 127.0.0.1 (localhost), with port number 8000 without password. 
  144.  You can use this host for testing. 
  145.  To set host for connection, select it in the list, and save settings. 
  146.  To add new host, select any in the list and press  button. To change host 
  147.  parameters, select it in the list, change port and/or password and press 
  148.  button. To delete host, select it in the list and press  button. 
  149.  
  150.  Note:  when you add new host or change parameters for existing host, press 
  151.         button to test connection. Program will return message if connection 
  152.         was OK or if there is any error. 
  153.  
  154.  Language and Fonts 
  155.  
  156.  Language 
  157.       You can select one of available Languages from list (only ENGLISH in test 
  158.       version). 
  159.  
  160.  Fonts 
  161.       Press  button and drag and drop selected font on Font area (blue text on 
  162.       white background). Select Proportional font (default font used in INI 
  163.       editor) and Monospaced font (used in HEX display). 
  164.  
  165.  Press  button to save new settings. 
  166.  Press  button to discard changes and load default settings. 
  167.  
  168.  Related topics : 
  169.  
  170.       Default settings 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 2.1. Default settings ΓòÉΓòÉΓòÉ
  174.  
  175. Install procedure creates file INITOOLS.INI in directory where you installed 
  176. INI editor. Default settings are written to this file: 
  177.  
  178.  Open Files via FileList            Checked (open via FileList) 
  179.  
  180.  Display toolbar                    YES 
  181.  
  182.  Safe mode (no edit)                YES 
  183.  
  184.  Size of INI editor                 Width - 550, height - 460 
  185.  
  186.  Save position on exit              YES 
  187.  
  188.  Remote connection                  Host 127.0.0.1  Port 8000  No password 
  189.  
  190.  Fonts                              Proportional - 9.WarpSans, Monospaced - 
  191.                                     10.System VIO 
  192.  
  193.  Language                           ENGLISH 
  194.  
  195.  
  196. ΓòÉΓòÉΓòÉ 3. INI editor ΓòÉΓòÉΓòÉ
  197.  
  198. You can start INI editor: 
  199.  
  200.    1. From Desktop: 
  201.         a. Double-click on INI editor icon 
  202.         b. Drag and drop object (INI file) on INI editor icon 
  203.         c. Double click on INI file 
  204.    2. From command line: 
  205.         a. INIedit.exe 
  206.         b. INIedit.exe File (where File is INI file you want to edit) 
  207.  
  208.  Note:  If you start INI editor without parameter (as described in 1.a. and 
  209.         2.a.), INI editor will open the USER INI file (usually \OS2\OS2.INI) as 
  210.         default INI file. 
  211.  
  212.  Main window follows hierarchical structure of INI file (left to right, and top 
  213.  to bottom) : 
  214.  
  215.      In top left side is list of Applications in INI file, with number of 
  216.       Applications in INI file and display order ( ascending,  descending, 
  217.        no sort). 
  218.      In top right side is list of Keys in selected Application, with number of 
  219.       Keys in selected Application and display order ( ascending,  
  220.       descending,  no sort). 
  221.      In bottom side is Value of selected Key (displayed in ASCII and HEX). 
  222.  
  223.  When you select Application or Key list (by clicking with mouse or pressing 
  224.  Tab button), it's color is changed to blue text on white background. 
  225.  
  226.  Value of selected key can be displayed in ASCII, HEX or ASCII and HEX 
  227.  representation. 
  228.  
  229.  You can select HEX display as readable (with BLANK delimiter between chars) if 
  230.  you select XX XX XX radio button, or fast HEX display (without delimiter) if 
  231.  you select XXXXXX radio button. For longer Value (more than 1,000 bytes) 
  232.  program needs some time to reformat display, so you should select fast HEX 
  233.  display. Program can not display Values longer than 10,000 bytes at once. If 
  234.  Value is longer, you'll see buttons on right side with numbers (1-10000, 
  235.  10001-20000, 20001-30000 ...). Press button to see next or previous group. 
  236.  
  237.  Related Topics: 
  238.  
  239.       FileList 
  240.       Menu 
  241.       Toolbar 
  242.       File operations 
  243.       Remote INI files 
  244.       WIN INI files 
  245.       Application operations 
  246.       Key operations 
  247.       Settings 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 3.1. FileList ΓòÉΓòÉΓòÉ
  251.  
  252. If you selected Open Files via FileList in Settings dialog, then you can create 
  253. list of INI files on your drive(s). 
  254.  
  255. First time you start INI editor, there are only OS2.INI, OS2SYS.INI and INI 
  256. editor's INI files in the FileList. 
  257. To create FileList, select drive(s) you want to scan and press  scan button. If 
  258. you want to scan all drives, press ALL button. If you created new, copied, 
  259. moved or deleted INI file(s), rescan FileList. 
  260.  
  261. If you want to see all (OS/2 and WIN) INI files in FileList, select Show ALL 
  262. INI files. Otherwise, to see only OS/2 INI files select Show only OS/2 INI 
  263. files. 
  264.  
  265. You can access to system files (if you press USER (OS2.INI), SYSTEM 
  266. (OS2SYS.INI) or BOTH button), without searching them in the list. 
  267. To open other file, select it and press  button, or double-click on selected 
  268. file. 
  269. Press  button to open file in standard FileOpen dialog, if you want to open 
  270. other INI file (not in the FileList). 
  271.  
  272. Press  button to cancel this operation and return to main window. 
  273.  
  274. Related Topics: 
  275.  
  276.       Settings 
  277.  
  278.  
  279. ΓòÉΓòÉΓòÉ 3.2. Menu ΓòÉΓòÉΓòÉ
  280.  
  281. File menu (press Alt-F) 
  282.  
  283.  New                      Create new INI file 
  284.  Open                    Open local INI file for editing (submenu) 
  285.                           USER (OS2.INI)                Open the USER INI file 
  286.                                                         (usually \OS2\OS2.INI). 
  287.                           SYSTEM (OS2SYS.INI)           Open the SYSTEM INI 
  288.                                                         file (usually 
  289.                                                         \OS2\OS2SYS.INI). 
  290.                           BOTH                          For querying 
  291.                                                         invocations, both the 
  292.                                                         USER and SYSTEM INI 
  293.                                                         files will be searched. 
  294.                                                         For setting 
  295.                                                         invocations, the USER 
  296.                                                         INI file will be 
  297.                                                         written to. 
  298.                           Other                         Open other INI file 
  299.  Remote                   Open remote INI file for editing 
  300.  Save                     Save INI file 
  301.  OS/2->WIN                Save current OS/2 INI file as WIN INI file 
  302.  Info                     Show Information about INI file 
  303.  Local->Remote            Copy selected file to remote host 
  304.  Remote->Local            Copy selected file to local machine 
  305.  Delete                   Delete INI file 
  306.  Rexx script              Write Rexx script to create INI file - use current 
  307.                           file as template 
  308.  Exit                     Exit INI editor 
  309.  
  310.  Note:  if Safe mode is ON, New, Save and Delete menu items are DISABLED. 
  311.  
  312.  Application menu (press Alt-A, or double-click on selected Application) 
  313.  
  314.  New App                  Create new Application 
  315.  Copy App                 Copy selected Application (with all it's Keys and 
  316.                           Values) to other Application in this file (change 
  317.                           Application name) 
  318.  Delete App               Delete selected Application (with all it's Keys and 
  319.                           Values) 
  320.  Export App               Export selected Application (with all it's Keys and 
  321.                           Values) to file TRANSFER.INI 
  322.  Import App               Import Application from file TRANSFER.INI 
  323.  Sort                    Sort Applications in list (submenu) 
  324.                           Ascending -                 Sort Applications in 
  325.                                                         ascending order 
  326.                           Descending -                Sort Applications in 
  327.                                                         descending order 
  328.                           No sort -                   Don't sort Applications 
  329.  
  330.  Note:  if Safe mode is ON, all Application menu items are DISABLED. 
  331.  
  332.  Key menu (press Alt-K, or double-click on selected Key) 
  333.  
  334.  New Key                  Create new Key 
  335.  Copy Key                 Copy selected Key to other Key in this Application 
  336.                           (change Key name) 
  337.  Copy to App              Copy selected Key to other Application in this file 
  338.  Edit Key                 Edit selected Key's Value (in ASCII mode) 
  339.  HEXedit Key              Edit selected Key's Value (in HEX mode) 
  340.  Delete Key               Delete selected Key 
  341.  Export Key               Export selected Key to file TRANSFER.INI 
  342.  Import Key               Import Key from file TRANSFER.INI 
  343.  Sort                    Sort Keys in list (submenu) 
  344.                           Ascending -                 Sort Keys in ascending 
  345.                                                         order 
  346.                           Descending -                Sort Keys in descending 
  347.                                                         order 
  348.                           No sort -                   Don't sort Keys 
  349.  
  350.  Note:  if Safe mode is ON, all Key menu items are DISABLED. 
  351.  
  352.  Settings menu (press Alt-S) 
  353.  
  354.  Settings                 Configure INI editor (open Settings dialog) 
  355.  Safe mode ON             Set safe mode to ON (editing is disabled) 
  356.  Safe mode OFF            Set safe mode to OFF (editing is enabled) 
  357.  
  358.  Help menu (press Alt-H) 
  359.  
  360.  INI editor               Show help for INI editor 
  361.  About                    Information about program version and author 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 3.3. Toolbar ΓòÉΓòÉΓòÉ
  365.  
  366. File toolbar: 
  367.  
  368. Create new INI file 
  369. Open local INI file for editing 
  370. Open remote INI file for editing 
  371. Save selected file 
  372. Save current OS/2 INI file as WIN INI file 
  373. Information about selected file 
  374. Write Rexx script - use selected file as template 
  375. Copy local file to remote host or Copy remote file to local machine 
  376. Delete selected file 
  377.  
  378. Safe mode is ON (editing is disabled) or Safe mode is OFF (editing is enabled) 
  379. Configure INI editor (open Settings dialog) 
  380.  
  381. Show help 
  382. Exit INI editor 
  383.  
  384. Note:  if Safe mode is ON, only Open, Info, Settings, Help and Exit buttons are 
  385.        enabled. 
  386.  
  387.  Application toolbar: 
  388.  
  389.  Create new Application 
  390.  Copy selected Application (with all it's Keys and Values) to new Application 
  391.  in this file 
  392.  Export selected Application (with all it's Keys and Values) to file 
  393.  TRANSFER.INI 
  394.  Import Application from file TRANSFER.INI 
  395.  
  396.  Delete selected Application (with all it's Keys and Values) 
  397.  
  398.  Note:  if Safe mode is ON, all Application buttons are DISABLED. 
  399.  
  400.  Key toolbar: 
  401.  
  402.  Create new Key 
  403.  Copy selected Key to new Key in this Application 
  404.  Copy selected Key to other Application in this file 
  405.  Edit value of selected Key - ASCII 
  406.  Edit value of selected Key - HEX 
  407.  Export selected Key to file TRANSFER.INI 
  408.  Import Key from file TRANSFER.INI 
  409.  
  410.  Delete selected Key 
  411.  
  412.  Note:  if Safe mode is ON, all Key buttons are DISABLED. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 3.4. File operations ΓòÉΓòÉΓòÉ
  416.  
  417. Select action from PullDown menu (press Alt-F to open file submenu), or press 
  418. button in Main toolbar. 
  419.  
  420. When you edit WIN INI files, there are some specific options and limitations 
  421. (see WIN INI files section for more details). 
  422.  
  423.  New local INI file 
  424.       Create new INI file. File must have at least one Application, each 
  425.       Application must have at least one Key, and each Key must have a Value. 
  426.       When you create new file, INI editor writes one App, Key, Val to new 
  427.       file. 
  428.  Open local INI file 
  429.       Open local INI file for editing. File can be opened via FileList or 
  430.       standard FileOpen dialog. 
  431.  Open remote INI file 
  432.       Open INI file on remote host for editing. 
  433.  Save 
  434.       Save INI file - you can change file name and save opened INI file under 
  435.       new name. 
  436.  OS/2->WIN 
  437.       Save current OS/2 INI as WIN INI file - press this button after you 
  438.       finished editing of WIN INI file. 
  439.  Info 
  440.       Show some Information about current INI file - file name, path, size (in 
  441.       bytes), last change date and time, file attributes, total number of 
  442.       Applications and Keys in file. 
  443.  Delete 
  444.       Delete current INI file. USER and SYSTEM INI files can't be deleted (in 
  445.       fact, they can be deleted, but INI editor doesn't allow to do this). 
  446.  Rexx script 
  447.       Write Rexx script to create INI file - use all Values from current file. 
  448.       Later, you can run this Rexx script and create identical INI file as 
  449.       current. 
  450.  Copy local file to remote host 
  451.       Copy local file to remote host. 
  452.  Copy remote file to local machine 
  453.       Copy remote file to local machine. Button is visible if you are connected 
  454.       to remote host and opened file is on remote host. 
  455.  Exit 
  456.       Exit INI editor. 
  457.  
  458.  Related Topics : 
  459.  
  460.       Settings 
  461.       Menu 
  462.       Toolbar 
  463.       Remote INI files 
  464.       WIN INI files 
  465.  
  466.  
  467. ΓòÉΓòÉΓòÉ 3.5. Application operations ΓòÉΓòÉΓòÉ
  468.  
  469. Select action from PullDown menu (press Alt-Ato open Application submenu), or 
  470. double-click on selected Application in Application list, or press button in 
  471. Application toolbar. 
  472.  
  473. Note:  if Safe mode is ON, all Application operations are DISABLED. 
  474.  
  475.   New Application 
  476.       Create new Application. Each Application must have at least one Key, and 
  477.       each Key must have a Value. When creating new Application, INI editor 
  478.       writes one App, Key, Val. 
  479.   Copy Application 
  480.       Copy selected Application to other Application in this file (change 
  481.       Application name) with all it's keys and Values 
  482.   Delete Application 
  483.       Delete selected Application with all it's keys and Values 
  484.   Export Application 
  485.       Export selected Application to file TRANSFER.INI with all it's keys and 
  486.       Values 
  487.  Import Application 
  488.       Import Application from file TRANSFER.INI 
  489.  
  490.  Sort Applications in list (submenu) - available only in PopUp menu 
  491.       Sort Applications in ascending order 
  492.       Sort Applications in descending order 
  493.       Don't sort Applications 
  494.  
  495.       Note:  Applications are only sorted for display - no changes are written 
  496.              to INI file. 
  497.  
  498.  
  499. ΓòÉΓòÉΓòÉ 3.6. Key operations ΓòÉΓòÉΓòÉ
  500.  
  501. Select actopn from PullDown menu (press Alt-K to open Key submenu), or 
  502. double-click on selected Key in Key list, or press button in Key toolbar. 
  503.  
  504. Note:  if Safe mode is ON, all Key operations are DISABLED. 
  505.  
  506.   New Key 
  507.       Create new Key. Each Key must have a Value. When creating new Key, INI 
  508.       editor writes one Key, Val in current Application. 
  509.   Copy Key 
  510.       Copy selected Key and it's Value to other Key in this Application (change 
  511.       Key name) 
  512.  Copy to App 
  513.       Copy selected Key and it's Value to other Application in this file 
  514.   Edit Key 
  515.       Edit selected Key's Value (in ASCII mode). See Edit Value for more 
  516.       information. 
  517.  HEXedit Key 
  518.       Edit selected Key's Value (in HEX mode). See Edit Value for more 
  519.       information. 
  520.  Delete Key 
  521.       Delete selected Key and it's Value 
  522.  Export Key 
  523.       Export selected Key and it's Value to file TRANSFER.INI 
  524.  Import Key 
  525.       Import Key from file TRANSFER.INI 
  526.  
  527.  Sort Keys in list (submenu) - available only via PopUp menu 
  528.       Sort Keys in ascending order 
  529.       Sort Keys in descending order 
  530.       Don't sort Keys 
  531.  
  532.       Note:  Keys are only sorted for display - no changes are written to INI 
  533.              file. 
  534.  
  535.  Related Topics : 
  536.  
  537.       Edit Value 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 3.6.1. Edit Value ΓòÉΓòÉΓòÉ
  541.  
  542. Warning: INI editor CAN NOT EDIT Value longer than 10,000 bytes. 
  543.  
  544. When you select Key, in bottom side of INI editor's main window is displayed 
  545. Value in ASCII and HEX. If Value has NULL byte ['00'x], you'll see text NULL in 
  546. top right corner of ASCII display. 
  547.  
  548. Edit Value - ASCII 
  549. If you select Edit from PopUp menu, or press  button, Edit dialog is opened. In 
  550. Title bar is displayed Key name (with NULL! text if Value has NULL byte 
  551. ['00'x]. If Value has NULL byte ['00'x], it is changed to BLANK byte ['FF'x] in 
  552. ASCII display). 
  553.  
  554. Note:  If you select Trailing NULL, NULL byte ['00'x] will be added at the end 
  555.        of Value. This byte may be needed for certain values to function 
  556.        properly. 
  557.        If Value has NULL byte ['00'x], it is changed to BLANK ['FF'x] when you 
  558.        edit value in ASCII mode. Changed Value will be saved (except trailing 
  559.        NULL). It is RECOMMENDED to edit Value in HEX mode, if it has NULL byte! 
  560.  
  561.  Edit Value - HEX 
  562.  If you select HEX edit from PopUp menu, or press  button, HEX Edit dialog is 
  563.  opened. In Title bar is displayed Key name. On top side is Value displayed in 
  564.  ASCII. On right side is list with ASCII and HEX Values (to help you in HEX 
  565.  editing). 
  566.  
  567.  Actions in Edit 
  568.  Delete Value (if you delete Value, and press  button, Key will be deleted too) 
  569.  Cut Value to Clipboard (Value is deleted) 
  570.  Copy Value to Clipboard 
  571.  Paste Value from Clipboard - it's added at the end of existing Value 
  572.  
  573.  In HEX edit you can also: 
  574.  Refresh Value, without writing changes 
  575.  Reset changes and display original (loaded) Value 
  576.  
  577.  To replace existing Value with Value from Clipboard, press button, then 
  578.  button. 
  579.  To append Value with Value from Clipboard to existing Value, press only 
  580.  button. 
  581.  
  582.  When finished with editing, press button to save changes, or  button to close 
  583.  Edit dialog without saving changes. 
  584.  
  585.  Related Topics: 
  586.  
  587.       Key operations 
  588.  
  589.  
  590. ΓòÉΓòÉΓòÉ 4. Remote INI files ΓòÉΓòÉΓòÉ
  591.  
  592. server.zip is part of freeware INIserve package by PeterMoylan. The latest 
  593. version of this software can be found at http://eepjm.newcastle.edu.au/os2/ 
  594.  
  595. If you want to edit INI files on remote host, INI editor will work as client. 
  596. The server part (in package server.zip) should go on the machine with the INI 
  597. files to be edited. For evaluation purposes, you can put both parts on the same 
  598. machine (even in the same directory if you prefer). For more information, read 
  599. file iniserve.inf in the server package (server.zip). 
  600.  
  601. After you unzipped server.zip, start INIserv.exe on remote host and set host 
  602. parameters in Settings (host name or number, port number and password). Select 
  603. host in the list and save settings. 
  604. To open remote INI file, press  button, select drive, directory and file to 
  605. edit, and press  button to open INI file, or  button to return to main window. 
  606. When you open remote INI file, in lower right corner of main window you can see 
  607. port name or number of remote host (or text 'Local', if you opened local INI 
  608. file on your machine). 
  609.  
  610. When you work with remote INI file, you can perform all actions like with local 
  611. INI file (add, copy, delete Applications and Keys, edit Value in ASCII and HEX 
  612. mode, etc), except Create new INI file and delete INI file. 
  613. Press button to copy INI file from remote host to local machine. 
  614. Press button to copy INI file from local machine to remote host. 
  615.  
  616. Note:  to enable work with remote INI files, required is also file rxsock.dll 
  617.        (in \TCPIP\DLL directory). 
  618.  
  619.  Related Topics: 
  620.  
  621.       Settings 
  622.       INI editor 
  623.       File operations 
  624.  
  625.  
  626. ΓòÉΓòÉΓòÉ 5. WIN INI files ΓòÉΓòÉΓòÉ
  627.  
  628. WIN INI files are used with most of WIN-OS/2 (and some of OS/2) programs. WIN 
  629. INI file is plain-text file with following structure: 
  630.  
  631.      Lines beginning with [ and ending with ] are Applications (also called 
  632.       Sections). For example: [Section] 
  633.      Character = is separator between key and value in line. For example: 
  634.       Key=Value. All lines with key and value between Application (Section) and 
  635.       next Application (Section) or end of file are part of this Application 
  636.       (Section). 
  637.      Lines beginning with ; are comments and program does not read application 
  638.       (section), key or value in this line. 
  639.  
  640.  If you want to open WIN INI file via FileList, select Show ALL INI files 
  641.  radiobutton in FileList dialog. 
  642.  
  643.  To view/edit WIN INI file, INI editor converts it to OS/2 INI file (it's name 
  644.  is WIN__OS2.INI and it is always saved in INI editor working directory). All 
  645.  changes are written to WIN_OS2.INI file. 
  646.  
  647.  You can do all actions on this file as on any other INI file (copy, write Rexx 
  648.  script, create new, copy, delete, export, import applications and keys, edit 
  649.  keys ...). When displayed, applications (sections) and keys are not sorted - 
  650.  they are displayed in order as in file. 
  651.  
  652.  When you view/edit WIN INI files here are some limitations: 
  653.  
  654.    1. Lines beginning with comment ; in WIN INI files are lost. Commented keys 
  655.       and values (for example:;Key=Value) can be edited as normal keys and/or 
  656.       values (Key=Value). 
  657.    2. Only when key and value are in ONE line, INI editor can read it 
  658.       correctly. 
  659.    3. To save changes in original WIN INI file, you have to convert it to 
  660.       OS2_WIN.INI file (in INI editor working directory). To do this select 
  661.       OS/2->WIN item in File menu, or press  button. Then you can copy 
  662.       OS2_WIN.INI file to original WIN INI file. If there is NULL byte ['00'x] 
  663.       in value, it is converted to BLANK byte ['FF'x]. 
  664.  
  665.  Note:  you have to copy manually OS2_WIN.INI to original WIN INI file. 
  666.  
  667.  Related Topics: 
  668.  
  669.       INI editor 
  670.       File operations 
  671.  
  672.  
  673. ΓòÉΓòÉΓòÉ 6. Limitations and troubleshooting ΓòÉΓòÉΓòÉ
  674.  
  675. Limitations 
  676.  
  677.      INI editor can view/edit WIN INI files with some limitations: 
  678.  
  679.         1. Lines beginning with comment ; in WIN INI files are lost. Commented 
  680.            keys and values (for example: ;Key=Value) can be edited as normal 
  681.            keys and/or values (Key=Value). 
  682.         2. Only when key and value are in ONE line, INI editor can read it 
  683.            correctly. 
  684.         3. To save changes in original WIN INI file, you have to convert it to 
  685.            OS2_WIN.INI file (in INI editor working directory) and then save 
  686.            OS2_WIN.INI file as original WIN INI file. 
  687.  
  688.      In ASCII and HEX edit (in INI editor) Value longer than 10,000 bytes can 
  689.       not be edited. 
  690.  
  691.      If Value has NULL byte ['00'x], NULL byte ['00'x] is changed to BLANK 
  692.       byte ['FF'x] in ASCII display - NO DATA IS CHANGED IN INI FILE. 
  693.  
  694.      If Value has NULL byte ['00'x], and you  edit Value in ASCII mode:  , 
  695.       NULL byte ['00x] is changed to BLANK byte ['FF'x] - CHANGED DATA IS 
  696.       WRITTEN TO INI FILE. 
  697.       If Value has NULL byte, edit Value in HEX mode ! 
  698.  
  699.  If you find bug in program, or if DrRexx screen pop up with SYNTAX ERROR 
  700.  message, try this: 
  701.  
  702.    1. READ THE MANUAL please, maybe you'll find some useful information:-). 
  703.  
  704.    2. If INI editor is still running, open Settings dialog, and press default 
  705.       settings button, exit program and start it again. 
  706.  
  707.    3. If INI editor is not running, start Install/UnInstall procedure 
  708.       (INIinst.cmd). Select Install. 
  709.  
  710.    4. Delete INITOOLS.INI file in INI editor directory and start INI editor. 
  711.       Program will load default settings. You will loose your settings, but 
  712.       programs should work. 
  713.  
  714.    5. Visit my Home page to see if there is any bug fix or update. 
  715.  
  716.    6. Send me a message with following information: 
  717.  
  718.         a. OS/2 Version (and FixPack) you are using, 
  719.         b. Rexx Version ("classic" or Object Rexx), 
  720.         c. INI editor Version, 
  721.         d. description of bug or error, and SYNTAX ERROR message from DrRexx 
  722.            dialog. 
  723.  
  724.       I will try to help you and correct error. 
  725.  
  726.  
  727. ΓòÉΓòÉΓòÉ 7. Explanation of terms ΓòÉΓòÉΓòÉ
  728.  
  729. INI file 
  730.  
  731. The name of the INI file which you would like to work with. OS/2 saves a big 
  732. part of its configuration in the files OS2.INI and OS2SYS.INI. Therefore, many 
  733. of the changes you might make to the WPS will involve changing some entries in 
  734. these INI files. The basic structure of OS/2 INI files is hierarchical, 
  735. consisting of the following elements and order: 
  736.  
  737.    1. Application 
  738.       The application name or some other meaningful value with which you would 
  739.       like to store keywords (some sort of data). Applications are the main 
  740.       entries. Each application must have at least one Key. 
  741.  
  742.    2. Key 
  743.       The name of a keyword which is used to hold data. Each Key must have a 
  744.       Value. 
  745.  
  746.    3. Value 
  747.       The Value to associate with the keyword of the specified application. 
  748.       (Note that a lot of Values - but not all - include a trailing NULL byte 
  749.       ['00'x]). This byte may be needed for certain values to function 
  750.       properly. It should not be discarded when values are modified. 
  751.  
  752.  INI file should be a file specification, or one of the following: 
  753.  
  754.  USER      The USER INI file (usually \OS2\OS2.INI). This is the default. 
  755.  SYSTEM    The SYSTEM INI file (usually \OS2\OS2SYS.INI). 
  756.  BOTH      For querying invocations, both the USER and SYSTEM INI files will be 
  757.            searched. For setting invocations, the USER INI file will be written 
  758.            to. 
  759.  
  760.  WIN INI files 
  761.  
  762.  Used with most of WIN-OS/2 (and some of OS/2) programs. WIN INI file is 
  763.  plain-text file with following structure: 
  764.  
  765.      Lines beginning with [ and ending with ] are Applications (also called 
  766.       Sections). For example: [Section] 
  767.      Character = is separator between key and value in line. For example: 
  768.       Key=Value 
  769.      Lines beginning with ; are comments and program does not read application 
  770.       (section), key or value in this line. 
  771.  
  772.  
  773. ΓòÉΓòÉΓòÉ 8. Copyright and contact ΓòÉΓòÉΓòÉ
  774.  
  775.  Author         Goran Ivankovic 
  776.  Address        Ulica Josipa Poduje 8 
  777.                 HR-52100 Pula 
  778.                 Croatia 
  779.  email          duga1@pu.hinet.hr 
  780.  Home page      http://www.os2world.com/goran/ 
  781.  
  782.  INI editor is free software but it is not public domain.. The author retains 
  783.  all copyright to the application and all files within it. 
  784.  
  785.  You may use INI editor yourself and you may distribute it to others so long as 
  786.  all files are left unchanged. You may not distribute INI editor in any way 
  787.  which leads to your making a profit from it. This means that you can only 
  788.  charge enough to cover the costs of media, postage etc. involved in 
  789.  distribution. Also you may not use it as an incentive to buy something else. 
  790.  If you are in any doubt you should contact the author. 
  791.  
  792.  The author's permission must be obtained before INI editor is included on a 
  793.  magazine disc and P.D. libraries. You should, as a matter of courtesy, inform 
  794.  the author when you are planning to distribute the application and send one 
  795.  copy of magazine disc to the author. 
  796.  
  797.  Copyright and Trademarks 
  798.  
  799.      OS/2 is Trademark of International Bussines Machines Corporation 
  800.      DrDialog is Copyright of International Bussines Machines Corporation 
  801.      FastIni.dll is Copyright of Dennis Bareis 
  802.      iniserv.zip is Copyright of Peter Moylan 
  803.  
  804.  STANDARD DISCLAIMER 
  805.  
  806.  The author makes no representations about the accuracy or suitability of this 
  807.  material for any purpose. It is provided "as is", without any express or 
  808.  implied warranties. The author will assume no liability for damages either 
  809.  from the direct use of this product or as a consequence of the use of this 
  810.  product. 
  811.  
  812.  
  813. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  814.  
  815.  Author         Goran Ivankovic 
  816.  Address        Ulica Josipa Poduje 8 
  817.                 HR-52100 Pula 
  818.                 Croatia 
  819.  email          duga1@pu.hinet.hr 
  820.  Home page      http://www.os2world.com/goran/ 
  821.