home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / LAN / ATI110.ZIP / INIUPD.DOC < prev    next >
Text File  |  1994-01-02  |  22KB  |  598 lines
  1.  
  2.  
  3.  
  4.           INIUPDate - A Network INI File Update Utility
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.           (c) Copyright Abrams Technologies, 1993-1994.
  15.  
  16.                       536 North Donar Drive
  17.                        Columbia, SC  29223
  18.  
  19.                       Phone: (803) 865-0405
  20.                          CIS: 73632,746
  21.  
  22.  
  23.  
  24.                         Table of Contents
  25.  
  26. Files Listing. . . . . . . . . . . . . . . . . . . . . . . . .  3
  27.  
  28. Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  3
  29.  
  30. Terminology. . . . . . . . . . . . . . . . . . . . . . . . . .  3
  31.  
  32. Command Line Switches. . . . . . . . . . . . . . . . . . . . .  4
  33.      /I-<INIFile>. . . . . . . . . . . . . . . . . . . . . . .  4
  34.      /M-<MasterFile> . . . . . . . . . . . . . . . . . . . . .  5
  35.      /K-<KeyType>. . . . . . . . . . . . . . . . . . . . . . .  6
  36.      /R-<RptFile>. . . . . . . . . . . . . . . . . . . . . . .  6
  37.      /D-<Disp> . . . . . . . . . . . . . . . . . . . . . . . .  7
  38.  
  39. Example Command Lines. . . . . . . . . . . . . . . . . . . . .  7
  40.  
  41. Usage 1:  New Application Setup. . . . . . . . . . . . . . . .  8
  42.  
  43. Usage 2:  Preventing Users From Changing INI File Values . . . 11
  44.  
  45. Usage 3:  Providing User Support . . . . . . . . . . . . . . . 12
  46.  
  47. History. . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  48.  
  49. Coming Attractions . . . . . . . . . . . . . . . . . . . . . . 14
  50.  
  51. Copyright. . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  52.  
  53. Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  54.  
  55. Shareware. . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  56.  
  57. Distribution . . . . . . . . . . . . . . . . . . . . . . . . . 16
  58.  
  59. INIUPDate Registration Form. . . . . . . . . . . . . . . . . . 17
  60.       INIUPDate - A Network INI File Update Utility, Page 3
  61.  
  62. Files Listing
  63. -------------
  64.  
  65.      INIUPD.DOC     Documentation and registration form.
  66.      INIUPD.EXE     INIUPDate program file.
  67.      SYSTEM-D.MAS   Example Duplicate Key file for SYSTEM.INI.
  68.      SYSTEM-S.MAS   Example Singular Key file for SYSTEM.INI.
  69.      PROGMAN.MAS    Example PROGMAN.INI update file.
  70.      WIN.MAS        Example WIN.INI update file.
  71.  
  72. Introduction
  73. ------------
  74.      INIUPDate is a utility designed for Network Administrators
  75. who manage Windows on a Local Area Network (LAN).  Specifically,
  76. INIUPDate provides the following benefits:
  77.  
  78.      *    Easily add new applications to the LAN 
  79.      *    Prevent users from making modifications to INI files
  80.      *    Provide better support to your end users
  81.  
  82.      INIUPDate is a DOS program that modifies an INI file by
  83. comparing the Keys and Values in the INI file to a Master INI
  84. file.  
  85.  
  86. Terminology
  87. -----------
  88.      Example Part of an INI File ---->  [Desktop]
  89.                                  ---->  Wallpaper=marble.bmp
  90.  
  91.      Term           Example
  92.      ----           -------
  93.      Section        [Desktop]
  94.      Key            Wallpaper
  95.      Value          marble.bmp       INIUPDate - A Network INI File Update Utility, Page 4
  96.  
  97. Command Line Switches
  98. ---------------------
  99.  
  100.      INIUPD /I-<INIFile> /M-<MasterFile> /K-<KeyType>
  101.             /R-<RptFile> /D-<Disp>
  102.  
  103.           The /I, /M, and /K switches are required, though they
  104.      may be in any order.  Also, the /K switch may only be an S
  105.      or a D.  The /R and /D switches are optional.
  106.  
  107.      /I-<INIFile>
  108.      ------------
  109.  
  110.           This tells INIUPDate the file you want to modify.  It
  111.      can be WIN.INI or any other application INI file.  There is
  112.      no default file name or extension; you must explicitly enter
  113.      the full path, filename, and extension of the INI file you
  114.      want to modify.  INIUPDate will strip the extension and use
  115.      the path and filename to create a temporary file
  116.      (<INIFile>.$$$) and a backup of the file (<INIFile>.!).  The
  117.      user running the INIUPD.EXE program must have Read, Write,
  118.      Create, and Erase rights to the directory where <INIFile> is
  119.      located.
  120.  
  121.           Example Command Lines:
  122.  
  123.                /I-C:\WINDOWS\WIN.INI
  124.                /I-J:\WINDOWS\EMAIL.INI
  125.  
  126.           Since you are specifying the <INIFile> on the command
  127.      line, you can use environment variables in the <INIFile>. 
  128.      For example:
  129.  
  130.                /I-F:\USERS\%USER%\WIN.INI
  131.       INIUPDate - A Network INI File Update Utility, Page 5
  132.  
  133.      /M-<MasterFile>
  134.      ---------------
  135.  
  136.           This tells INIUPDate the file with the changes you want
  137.      made to <INIFile>.  Again, the full path, filename and
  138.      extension are required.  The <MasterFile> is simply an INI
  139.      File with Values you want applied to <INIFile>.  If the
  140.      Section, Key and Value in the <MasterFile> are not in the
  141.      <INIFile>, they will be added.  If the Section and Key are
  142.      found in the <INIFile>, the Value will be updated to match
  143.      the Value in the <MasterFile>.  The <MasterFile> is not
  144.      limited in the number of sections.  You may have as many
  145.      sections as you want in the <MasterFile>.
  146.  
  147.           Example: WIN.MAS         [Desktop]
  148.                                    IconSpacing=65
  149.                                    IconTitleFaceName=Arial
  150.  
  151.                                    [Extensions]
  152.                                    wri=write.exe ^.wri
  153.                                    hlp=winhelp.exe ^.hlp
  154.  
  155.           Example Command Lines:
  156.  
  157.                /M-F:\WINCFG\WIN.MAS
  158.                /M-F:\WINCFG\PROGMAN.MAS
  159.  
  160.           Notes:    <MasterFile> does not have to have the MAS
  161.                     extension.  You can name the file anything
  162.                     you like.
  163.  
  164.                     Users should only have Read and File Scan
  165.                     rights to the directory where the
  166.                     <MasterFile> is located.  This prevents them
  167.                     from changing the <MasterFile>.       INIUPDate - A Network INI File Update Utility, Page 6
  168.  
  169.      /K-<KeyType>
  170.      -----------
  171.  
  172.           This is probably the most important option because it
  173.      will cause incorrect updates if not used properly.  There
  174.      are two types of Keys in an INI file.
  175.  
  176.      Singular Keys are Keys that may appear only once in a
  177.      Section.  Almost all keys in all INI Files are Singular.
  178.  
  179.      Duplicate Keys are Keys that appear more than once in a
  180.      section.  The two most common (and only ones I know of
  181.      currently) are the "Device=" and "Local=" Keys in the
  182.      "[386Enh]" Section of SYSTEM.INI.
  183.  
  184.      INIUPDate must know what type of Key the <MasterFile> has. 
  185.      If you tell INIUPDate that the <MasterFile> contains
  186.      singular Keys, and you update the SYSTEM.INI, all "Device="
  187.      lines in the SYSTEM.INI will  have a Value equal to the last
  188.      "Device=" statement in the <MasterFile>.
  189.  
  190.      My suggestion to you is to not use this utility on the
  191.      SYSTEM.INI until you fully understand how it works.  If you
  192.      use this utility to update SYSTEM.INI, create two
  193.      <MasterFiles>, SYSTEM-S.MAS and SYSTEM-D.MAS.  Put all
  194.      Sections, Keys and Values that are singular into SYSTEM-
  195.      S.MAS.  Put all Sections, Keys and Values that are duplicate
  196.      (Device= and Local=) into SYSTEM-D.MAS.   See SYSTEM-S.MAS
  197.      and SYSTEM-D.MAS example files that are included.
  198.  
  199.      /R-<RptFile>
  200.      ------------
  201.  
  202.           INIUPDate creates an extensive report as it runs.  If
  203.      you do not tell INIUPDate to send the report to a file, it
  204.      will be sent to the screen.  You must specify the full path
  205.      and filename for the report file.
  206.  
  207.                Examples:
  208.  
  209.                     /R-J:\WINDOWS\WIN.RPT
  210.                     /R-F:\USERS\%USER%\WINDOWS\WIN.RPT
  211.       INIUPDate - A Network INI File Update Utility, Page 7
  212.  
  213.      /D-<Disp>
  214.      ---------
  215.  
  216.           This option only works if you redirect output to a file
  217.      with the /R switch.  The only valid <Disp> value is ON  
  218.      (/R-ON), otherwise it is considered to be OFF.  When ON is
  219.      specified and the /R switch is used, INIUPDate will display
  220.      progress on the screen.  It shows the section it is
  221.      currently updating and which Key it is working on.  This is
  222.      helpful if you have a large <MasterFile> and you want to be
  223.      sure the program is still running.  
  224.  
  225.  
  226. Example Command Lines
  227. ---------------------
  228.  
  229. 1. INIUPD /I-J:\WINDOWS\WIN.INI /M-F:\WINCFG\WIN.MAS /K-S
  230.  
  231.      This example updates the user WIN.INI file using
  232.      F:\WINCFG\WIN.MAS, which has singular keys.  The report
  233.      output is sent to the screen.
  234.  
  235. 2. INIUPD /I-F:\USER\%USER%\PROGMAN.INI /M-F:\WINCFG\PROGMAN.MAS
  236.           /K-S /R-F:\USER\%USER%\PROGMAN.RPT /D-ON
  237.  
  238.      This example updates the user PROGMAN.INI with
  239.      F:\WINCFG\PROGMAN.MAS, which uses singular keys.  The report
  240.      output is sent to F:\USER\%USER%\PROGMAN.RPT and progress of
  241.      INIUPDate is displayed on the screen.
  242.  
  243. 3. INIUPD /I-J:\SYSTEM.INI /M-F:\WINCFG\SYSTEM-D.MAS 
  244.           /K-D /R-J:\SYSTEM.RPT
  245.  
  246.      This example updates SYSTEM.INI using the Master File
  247.      F:\WINCFG\SYSTEM-D.MAS, which has duplicate keys.  Report
  248.      output is sent to J:\SYSTEM.RPT, but INIUPDate progress is
  249.      not displayed on the screen.       INIUPDate - A Network INI File Update Utility, Page 8
  250.  
  251. When to Run INIUPDate
  252. ---------------------
  253.  
  254.      INIUPDate needs to be run before Windows is launched so the
  255. changes it makes to INI files will be in effect when Windows
  256. loads.  There are several ways to do this and you can use
  257. whichever is best for you.
  258.  
  259. Run INIUPDate from a Netware Login script, for example:
  260.  
  261.      IF MEMBER OF "INIUPDATE" THEN BEGIN
  262.         #INIUPD.EXE /I-WIN.INI................
  263.         #INIUPD.EXE /I-PROGMAN.INI ...........
  264.      ENDIF
  265.  
  266. Run INIUPDate from a batch file before loading Windows, for
  267. example:
  268.  
  269.      ECHO OFF
  270.      CLS
  271.      J:
  272.      CD \WINDOWS
  273.      INIUPD.EXE /I-WIN.INI ................
  274.      INIUPD.EXE /I-SYSTEM.INI .............
  275.      WIN.COM
  276.  
  277.  
  278. Usage 1:  New Application Setup
  279. -------------------------------
  280.  
  281.           There are several ways to set up Windows applications
  282.      on a LAN.  Basically, you install the program in a
  283.      directory, add an icon for the users to access it, and add
  284.      or modify one or more INI files.  The following is a simple
  285.      example of how to install a program called EDITOR.
  286.  
  287.      Step 1 -  Install the Application
  288.  
  289.           I install all my Windows applications in the directory
  290.           F:\WINAPPS.  For this application, I installed it in
  291.           the directory F:\WINAPPS\EDITOR.  I then granted users
  292.           rights to the directory so they could execute
  293.           EDITOR.EXE.       INIUPDate - A Network INI File Update Utility, Page 9
  294.  
  295.      Step 2 -  Add an Icon for users to run the application
  296.  
  297.           I have a generic Windows group file called LAN
  298.           Applications.  This file is F:\WINCFG\LANAPPS.GRP. 
  299.           Every time the user logs in to the network, this file
  300.           is copied to their personal Windows directory
  301.           (J:\WINDOWS).  This way, when I update
  302.           F:\WINCFG\LANAPPS.GRP, all users will get the update. 
  303.           In this case, I added the icon for EDITOR to the group. 
  304.           When doing this, you need to be sure the PROGMAN.INI
  305.           file for your users has the line
  306.           Group#=J:\WINDOWS\LANAPPS.GRP.
  307.  
  308.      Step 3, Modify all WIN.INI files 
  309.  
  310.           The EDITOR program adds the following line to the
  311.           WIN.INI file in the [Extensions] section
  312.      
  313.                edt=f:\winapps\editor\editor.exe ^.edt
  314.  
  315.           You definitely DO NOT want to edit every WIN.INI file
  316.           to add this line.  INIUPDate was designed to do this
  317.           for you.
  318.  
  319.           All you have to do is create a <MasterFile> with the
  320.           desired lines you want added to each user WIN.INI file. 
  321.           The <MasterFile> is an ASCII file; you can use any
  322.           editor to create it.  The format of the <MasterFile> is
  323.           the same as for a normal INI file.  The <MasterFile> in
  324.           this case looks like this:
  325.  
  326.                [Extensions]
  327.                edt=f:\winapps\editor\editor.exe ^.edt
  328.  
  329.           Once created, I save the file as F:\WINCFG\WIN.MAS. 
  330.           All modifications I want to make to WIN.INI, I put in
  331.           the file WIN.MAS.  Master files are not limited to a
  332.           particular application.
  333.  
  334.      INIUPDate - A Network INI File Update Utility, Page 10
  335.  
  336.           I choose to update user INI files each time the log in. 
  337.           I use a batch file called WINUPD.BAT which is run after
  338.           the system login script exits.  The line in the Netware
  339.           login script to do this is:
  340.  
  341.                EXIT "WINUPD.BAT"
  342.  
  343.           The WINUPD.BAT file looks like this
  344.  
  345.                ECHO OFF
  346.                CLS
  347.                J:
  348.                CD \WINDOWS
  349.                INIUPD /I-WIN.INI /M-F:\WINCFG\WIN.MAS 
  350.                       /K-S /R-WIN.RPT /D-ON
  351.                WIN
  352.                LOGOUT
  353.  
  354.           This looks at the user J:\WINDOWS\WIN.INI file and
  355.           compares it to the F:\WINCFG\WIN.MAS file.  All lines
  356.           in F:\WINCFG\WIN.MAS not in J:\WINDOWS\WIN.INI are
  357.           added to J:\WINDOWS\WIN.INI in the appropriate Section. 
  358.           If the line is already in the J:\WINDOWS\WIN.INI file,
  359.           INIUPDate updates the line to match the line in
  360.           F:\WINCFG\WIN.MAS.
  361.  
  362.           In this example, the following line is added to every
  363.           user's [Extensions] Section of their WIN.INI file when
  364.           they log in:
  365.  
  366.                edt=f:\winapps\editor\editor.exe ^.edt      INIUPDate - A Network INI File Update Utility, Page 11
  367.  
  368. Usage 2:  Preventing Users From Changing INI File Values
  369. --------------------------------------------------------
  370.  
  371.      If you ever want to prevent a user from making a change to
  372. the INI file, just set up the value you desire in a <MasterFile>.
  373. When the user logs in and INIUPDate is run, the user INI file
  374. will be changed.  In some cases, this does not prevent a user
  375. from making the change, but it does only allow the change to be
  376. active for the current session when a change is made.  Most users
  377. will probably not want to keep making a change every day and they
  378. will probably cease making current session changes.
  379.  
  380. Example:
  381.  
  382.           Suppose you want to put restrictions in PROGMAN.INI so
  383.      that the File, Run option is not available.  To do this, you
  384.      would add a [Restrictions] Section to progman.ini.  The Key
  385.      would be NoRun and the Value would be 1.  It would look like
  386.      this:
  387.  
  388.                [Restrictions]
  389.                NoRun=1
  390.  
  391.           Again, modifying every progman.ini file would be quite
  392.      time consuming.  Instead, I created the <MasterFile>
  393.      F:\WINCFG\PROGMAN.MAS.  In it, I included the two lines
  394.      shown above.  When the user logs in to the server, the
  395.      following line is run:
  396.  
  397.      INIUPD /I-J:\WINDOWS\PROGMAN.INI /M-F:\WINCFG\PROGMAN.MAS    
  398.             /K-S /R-J:\WINDOWS\PROGMAN.RPT /D-ON
  399.  
  400.           Even if the user modifies PROGMAN.INI with an editor,
  401.      the next time they log in it will be put back to the way it
  402.      is in PROGMAN.MAS.  I log the user out when they exit
  403.      Windows, so they must log back in to re-load it.  In logging
  404.      back in, INIUPDate is run again.
  405.      INIUPDate - A Network INI File Update Utility, Page 12
  406.  
  407. Usage 3:  Providing User Support
  408. --------------------------------
  409.  
  410.      INIUPDate allows you to make changes to user INI files that
  411. help the user out.  Sometimes the user does not know how to make
  412. the changes or there is no way for the user to make the changes.
  413.  
  414. Example:
  415.  
  416.           Suppose you want to change the default screen font. 
  417.      The default is small and hard to read.  I have found that
  418.      using Arial, Bold, 8pt is a lot better looking.  There is no
  419.      way for the user to change this, so it must be added to the
  420.      WIN.INI file manually.  The following lines change the
  421.      screen font:
  422.  
  423.           [Desktop]
  424.           IconTitleFaceName=Arial
  425.           IconTitleStyle=1
  426.           IconTitleSize=8
  427.  
  428.           Suppose you also want to change where users must click
  429.      on icons to make the area bigger.  You can do that by adding
  430.      the following lines:
  431.  
  432.           [Desktop]
  433.           DoubleClickWidth=4
  434.           DoubleClickHeight=4
  435.  
  436.           Finally, you want to let users print to a file rather
  437.      than a port.  You do this by using the following lines:
  438.  
  439.           [Ports]
  440.           FILE:=J:\WINDOWS\PRINT.FIL
  441.  
  442.      where J:\WINDOWS\PRINT.FIL is the name of the file you want
  443.      users to print to.
  444.  
  445.      INIUPDate - A Network INI File Update Utility, Page 13
  446.  
  447.           To accomplish these changes, make a <MasterFile>.  I
  448.      use the same master file I use to add new applications.  It
  449.      is F:\WINCFG\WIN.MAS and looks like the following:
  450.  
  451.           [Extensions]
  452.           edt=f:\winapps\editor\editor.exe ^.edt
  453.  
  454.           [Desktop]
  455.           IconTitleFaceName=Arial
  456.           IconTitleStyle=1
  457.           IconTitleSize=8
  458.           DoubleClickWidth=4
  459.           DoubleClickHeight=4
  460.  
  461.           [Ports]
  462.           FILE:=J:\WINDOWS\PRINT.FIL      INIUPDate - A Network INI File Update Utility, Page 14
  463.  
  464. History
  465. -------
  466.  
  467. Version             Description
  468. -------             -----------
  469. 1.02 (01/94)   Add support for "duplicate keys" (/K-D Switch).
  470.  
  471. 1.01 (04/93)   Process multiple Sections in INI file.
  472.  
  473. 1.0  (02/93)   Original Version.  Only processed one Section in
  474.                WIN.INI file.
  475.  
  476. Coming Attractions
  477. ------------------
  478.  
  479. 1.   Ability to process multiple INI files while only running
  480.      INIUPD.EXE once.
  481.  
  482. 2.   Ability to add Keys to a section only if the Key does not
  483.      already exist.
  484.  
  485. 3.   Solve the command line "over-crowding" problem.      INIUPDate - A Network INI File Update Utility, Page 15
  486.  
  487. Copyright
  488. ---------
  489.  
  490.      INIUPDate is (c) Copyright Abrams Technologies, 1993-1994.
  491.  
  492.      Other programs mentioned are copyright/trademark/property of
  493.      their respective companies.
  494.  
  495. Warranty
  496. --------
  497.  
  498.      Abrams Technologies make no warranties, either expressed or
  499. implied, pertaining to the functionality, suitability, and usage
  500. of this product.  It is supplied after extensive testing and
  501. usage on LANs with various servers and end-users.  It is intended
  502. as a utility to enhance LAN administration and decrease the
  503. amount of time involved in maintaining INI files on the LAN.
  504.  
  505. Shareware
  506. ---------
  507.  
  508.      INIUPDate is a Shareware software program.  Shareware is a
  509. great concept, but it only works if YOU, the user, register
  510. Shareware programs you are using.  
  511.  
  512.      Shareware (also known as user supported software and other
  513. names) is a concept not readily understood by everyone.  The
  514. authors of Shareware retain all rights to the software under
  515. existing copyright laws while still allowing free distribution. 
  516. This gives the user (YOU) the opportunity to obtain and try out
  517. software (without advance purchase) to see if it fulfills your
  518. personal or business needs.  
  519.  
  520.      Shareware should not be confused with Public Domain software
  521. even though they are often obtained from the same source(s).
  522.    
  523.      If you continue to use INIUPDate after trying it out for 30
  524. days, you are expected to register your copy.  In exchange you
  525. get the latest version and technical support.
  526.      INIUPDate - A Network INI File Update Utility, Page 16
  527.  
  528. Distribution
  529. ------------
  530.  
  531. You are free to distribute this program provided:
  532.           
  533. (1)  No fee is charged, other than normal costs for media and
  534.      distribution.
  535.  
  536. (2)  All files are included:
  537.  
  538.      INIUPD.DOC     Documentation and registration form.
  539.      INIUPD.EXE     INIUPDate program file.
  540.      SYSTEM-D.MAS   Example Duplicate Key file for SYSTEM.INI.
  541.      SYSTEM-S.MAS   Example Singular Key file for SYSTEM.INI.
  542.      PROGMAN.MAS    Example PROGMAN.INI update file.
  543.      WIN.MAS        Example WIN.INI update file.
  544.  
  545.                    INIUPDate Registration Form
  546.  
  547. Make check or money order payable to ABRAMS TECHNOLOGIES.
  548.                             
  549. Remit to:           ABRAMS TECHNOLOGIES
  550.                     536 North Donar Drive
  551.                     Columbia, SC  29223
  552.  
  553.                     Phone: (803) 865-0405, CIS: 73632,746
  554.  
  555. Your Name:______________________________________________________
  556.  
  557. Company Name:___________________________________________________
  558.  
  559. Address:  ______________________________________________________
  560.  
  561.           ______________________________________________________
  562.  
  563.           ______________________________________________________
  564.  
  565.    Server Operating System/Ver: ________________________________
  566.  
  567. Your CompuServe Account Number: ________________________________
  568.  
  569.     INIUpdate Version Number: __________________________________
  570.  
  571. Where did you obtain INIUPD?: __________________________________
  572.  
  573.             PCs or       Price per
  574.             Servers      Machine     Discount
  575.             -------      --------    --------
  576.             1 - 5         $30.00          0 %
  577.             6 - 10        $24.00         20 %
  578.             11+           $18.00         40 %
  579.  
  580.                  Site License   $200.00
  581.  
  582. Qty  x  Price = Subtot + 5% Sales Tax = Total
  583.  
  584. ___  x  _____ = ______ + ____________ = __________
  585.  
  586. Note 1:  Residents of countries outside the U.S.A. and Canada
  587. should remit 10% of Subtotal (quantity x price ea.) to cover
  588. shipping and handling cost.
  589.  
  590. Note 2: All prices are in US Dollars.
  591.  
  592. Comments and suggestions for future releases:
  593.  
  594. ______________________________________________________________
  595.  
  596. _______________________________________________________________
  597.  
  598. _______________________________________________________________