home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / listin.zip / LISTINI.DOC < prev   
Text File  |  1994-12-25  |  6KB  |  137 lines
  1.         LISTINI.CMD - Create A Text File From An INI File
  2.           (c) Copyright 1994-95 by C F S Nevada, Inc. 
  3.  
  4. Purpose
  5. -------
  6.  
  7. This program will read an OS/2 2.1 or WARP Version 3.0 binary INI
  8. file and create a text file for all of the "application" keys and
  9. all of the subordinate keys. Application names and the
  10. subordinate key are listed in alphabetic order.
  11.  
  12. This program is copyrighted 1994-95 by C F S Nevada, Inc. and is
  13. distributed free of charge to the public domain "as is" with no
  14. warranty by either its author, Dick Goran, or by
  15. C F S Nevada, Inc.
  16.  
  17.  
  18. Running LISTINI
  19. ---------------
  20.  
  21. LISTINI is an OS/2 command line program and it has 3 optional
  22. command line parameters. The defaults are:
  23.  
  24.      LISTINI S, LISTINI.SHT, BOTH
  25.  
  26. Each parameter except the last must be followed by a comma.
  27.  
  28. The first parameter indicates whether output should be in short
  29. (the default) or long format. Short format forces each key entry
  30. to be truncated if the value of the key exceeds the capacity of
  31. one "print line". Long format results in all of the key value
  32. being shown in both character and hex format. An example is
  33. included at the end of this document. The selection of long vs.
  34. short format results in the default file extension of the output
  35. file being LNG or SHT respectively, if no output file (2nd
  36. parameter) is specified.
  37.  
  38. The second parameter is the name of the output file to receive
  39. the data. It may be either a file (including any valid disk file
  40. system name) or a printer. If a printer is selected, the output
  41. is formatted by page with headers and page numbering.
  42.  
  43. The third parameter is the name of the Ini file to be listed. Any
  44. value accepted by the REXXUTIL SysIni() function may be
  45. specified. The default is BOTH implying both the OS2SYS.INI and
  46. OS2.INI files will be listed.
  47.  
  48. When BOTH is selected as the Ini file, each output line
  49. containing the "application" name will be preceded with either
  50. the capital letter S or U indicating that the application data
  51. came from the system Ini file (OS2SYS.INI) or the user Ini file
  52. (OS2.INI). It will be preceded by B if the same application
  53. occurs in both the system and user Ini files.
  54.  
  55. The progress of the program is indicated by each application name
  56. being displayed as that entry is processed along with an "in-
  57. process" indicator.
  58.  
  59.  
  60. Requirements
  61. ------------
  62.  
  63. Listini.CMD is an OS/2 REXX program and has been tested under
  64. OS/2 2.1 and Warp Version 3.0. It requires a commercial,
  65. proprietary REXX object module from Quercus Systems - REXXLIB.
  66. REXXLIB.DLL is distributed free of charge with this program with
  67. the expressed consent of Quercus Systems. It is to be used with
  68. C F S Nevada, Inc.'s programs only unless the user purchases and
  69. licenses a copy of REXXLIB from Quercus Systems.
  70.  
  71. REXXLIB.DLL may reside in the same directory as this program or
  72. may me moved to any convenient library that is included in the
  73. user's LIBPATH. Licensed REXXLIB or Personal REXX users may
  74. delete the REXXLIB.DLL file distributed with this program.
  75.  
  76.  
  77. Special Considerations
  78. ----------------------
  79.  
  80. Since the key values for all of the entries in PM_Abstract:Icons
  81. are basically the icon data, over 50K of hex data is not
  82. displayed for these keys. The key length is shown as the correct
  83. value; however, only 72 bytes ('48'x) of the actual icon data is
  84. listed. The word "partial" is appended to the last print line
  85. shown as a reminder that the full icon data has not been printed.
  86.  
  87. The environment variable SET COLORS=NO may be specified to
  88. inhibit all PM_..._Colors application names in the OS2.INI file.
  89. This shortens the output file if the various color combinations
  90. are of no interest.
  91.  
  92.  
  93. Parameter Examples (uppercase is for illustration only)
  94. -------------------------------------------------------
  95.  
  96. To list the contents of the FORBROWSE Ini file on LPT1 in short
  97. format, the command line could be:
  98.  
  99.      LISTINI S, FORBROWS.TXT, C:\PASSPORT\FORBROWS\FORBROWS.INI
  100.  
  101. To list the full contents of OS2SYS.INI on LPT1, the command line
  102. could be:
  103.  
  104.      LISTINI L, LPT1, SYSTEM
  105.  
  106. (Be sure to have a lot of paper in the printer).
  107.  
  108.  
  109. Sample Short & Long Format Output
  110. ---------------------------------
  111.  
  112. 01/24/94 13:39:44          LISTINI.CMD 2.0 - List of BOTH          Page   1
  113.  
  114. Application Name     Key Name             Length       Contents
  115. -------------------  -------------------  -----------  ---------------------
  116.                             (example of short format)
  117. S APPLICATION        TIMEOUT              Len='0004'x  45;.
  118. U ClockProgram 2.2 in WP3
  119.                      Preferences 3        Len='010A'x  '01000400 FFFFE900 'x
  120. U Lock Up Workplace  Lockup_options3      Len='0128'x  '01000100 14003F00 'x
  121. U MEMSIZE            INIPATH              Len='000C'x  F:\os2addon.
  122.  
  123.                             (example of long format)
  124. U ClockProgram 2.2 in WP3
  125.                      Preferences 3        Len=X'010A'
  126.       +0000   | 01000400 FFFFE900 70FF0000 0000FF00 |  ........p.......
  127.       +0010   | 0000FF00 00000000 00000000 23000C00 |  ............#...
  128.       +0020   | 00000000 01000100 5C000000 0F100000 |  ........\.......
  129.       +0030   | 3C000000 68000000 03000000 E4000000 |  <...h...........
  130.       +0040   | 40177003 9423B004 00000000 00000000 |  @.p..#..........
  131.       +0050   | 59044E04 01000000 E4000300 68003C00 |  Y.N.........h.<.
  132.       +0060   | 01000000 FFFF0000 00000000 00000000 |  ................
  133.       +0070   | 00000000 00000000 00000000 00000000 |  ................
  134.       +0080   | same                                |
  135.       +0100   | 00000000 00000000 0000              |  ..........
  136.  
  137.