home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / i / icfd170b.zip / ICF.DOC < prev    next >
Text File  |  1992-04-13  |  181KB  |  6,589 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                             ICF
  19.  
  20.                                 Inventory Capture Facility
  21.  
  22.                                         March, 1992
  23.  
  24.  
  25.  
  26.                                  LanTelligence Corporation
  27.                                       P.O. Box 144242
  28.                                    Miami, FL 33114-4242
  29.  
  30.                                       (305) 598-6453
  31.  
  32.  
  33.  
  34.        Copyright LanTelligence Corporation, 1992 All rights reserved.
  35.  
  36.        No part of this publication may be reproduced, or transmitted in
  37.        any form or by any means without the written permission of
  38.        LanTelligence Corporation. The software described by this publi-
  39.        cation is furnished under a license agreement, and may be used or
  40.        copied only in accordance with the terms of that agreement.
  41.  
  42.        The manual and associated software is sold with no warranties,
  43.        expressed or implied, regarding its use or fitness for any par-
  44.        ticular purpose. The information in this manual is subject to
  45.        change without notice and does not represent a commitment on the
  46.        part of LanTelligence Corporation.
  47.  
  48.  
  49.  
  50.  
  51.        dBASE is a registered trademark of Ashton-Tate/Borland
  52.        Lotus is a registered trademark of Lotus Corporation
  53.        IBM is a registered trademark of International Business Machines
  54.        Corporation
  55.        OS/2 is a registered trademark of International Business Machines
  56.        Corporation
  57.  
  58.  
  59.                                   TABLE  OF  CONTENTS
  60.  
  61.  
  62.  
  63.                   1. Introduction....................................1
  64.                  1.1. Organization of this manual....................1
  65.                  1.2. Quick-start (power-user) guide.................2
  66.                    1.2.1. Getting started............................2
  67.                    1.2.2. Running ICF................................3
  68.                    1.2.3. Using Options..............................4
  69.                    1.2.4. Using option values........................4
  70.                    1.2.5. Saving information in a file...............5
  71.                    1.2.6. Using ICF on a LAN.........................6
  72.                    1.2.7. Making options permanent...................6
  73.                    1.2.8. Modifying ICF input files..................7
  74.  
  75.                   2. ICF Guide.......................................8
  76.                  2.1. Overview.......................................8
  77.                  2.2. Versions of ICF................................9
  78.                    2.2.1. DOS Version................................9
  79.                    2.2.2. OS/2 Version...............................9
  80.                    2.2.3. Other versions.............................9
  81.                  2.3. Installation...................................9
  82.                  2.4. Starting ICF..................................10
  83.                  2.5. Techniques....................................11
  84.                    2.5.1. Scanning for Software Programs............11
  85.                      2.5.1.1. Overview of program scan operations...11
  86.                      2.5.1.2. Program scan commands.................12
  87.                      2.5.1.3. Recognizing programs..................13
  88.                      2.5.1.4. Capturing non-recognizable programs...13
  89.                    2.5.2. Collecting Physical Configuration Data....14
  90.                      2.5.2.1. The ASK command and /Ask option.......14
  91.                      2.5.2.2. ID Fields.............................17
  92.                  2.6. Using ICF Commands............................18
  93.                    2.6.1. Commands Summary..........................18
  94.                    2.6.2. File Scan Operations......................18
  95.                  2.7. Using ICF Options.............................20
  96.                    2.7.1. Options Summary...........................20
  97.                    2.7.2. Option Specification Methods..............25
  98.                      2.7.2.1. Command Line..........................26
  99.                      2.7.2.2. Environment Variable..................26
  100.                      2.7.2.3. In a File.............................26
  101.                      2.7.2.4. Cumulative Process Effects............27
  102.                    2.7.3. Shortcut Options..........................27
  103.                    2.7.4. Summary of Options by group...............28
  104.                      2.7.4.1. Drive Options Summary.................28
  105.                      2.7.4.2. File scan options.....................28
  106.                      2.7.4.3. Testing options.......................29
  107.                  2.8. Environment Variables.........................30
  108.                    2.8.1. Environment Variable "ICF"................31
  109.                    2.8.2. ICF Environment Variable "ICFINI".........31
  110.                  2.9. Experimental Features.........................32
  111.                  2.10. Hints........................................32
  112.  
  113.  
  114.                  2.11. ICF Input Files..............................33
  115.                    2.11.1. Program Input Files......................34
  116.                    2.11.2. Microchannel board Input Files...........35
  117.                  2.12. ICF Output Files.............................36
  118.                    2.12.1. Output File Naming.......................36
  119.                    2.12.2. Output File Structures...................38
  120.                    2.12.3. Status Command Output File Structure.....40
  121.  
  122.                   3. Command Reference..............................48
  123.                  3.1. Ask Command...................................48
  124.                  3.2. Auto Command..................................48
  125.                  3.3. Diskspace Command.............................50
  126.                  3.4. Files Command.................................51
  127.                  3.5. Help Command..................................53
  128.                  3.6. Programs Command..............................53
  129.                  3.7. Status Command................................54
  130.  
  131.                   4. Options Reference..............................60
  132.                  4.1. Alldisks Option...............................60
  133.                  4.2. Allext Option.................................60
  134.                  4.3. Append Option.................................61
  135.                  4.4. Ascii Option..................................61
  136.                  4.5. Ask Option....................................62
  137.                  4.6. Attrs Option..................................62
  138.                  4.7. Autodays Option...............................63
  139.                  4.8. Autorun Option................................64
  140.                  4.9. Autorunfile Option............................65
  141.                  4.10. Autospace Option.............................66
  142.                  4.11. Banner Option................................67
  143.                  4.12. Batch Option.................................67
  144.                  4.13. Bigfiles Option..............................68
  145.                  4.14. Bigfilesize Option...........................68
  146.                  4.15. Break Option.................................68
  147.                  4.16. Cls Option...................................69
  148.                  4.17. Colon Option.................................69
  149.                  4.18. Companyname Option...........................70
  150.                  4.19. Computerid Option............................70
  151.                  4.20. Dbase Option.................................71
  152.                  4.21. Desc Option..................................71
  153.                  4.22. Descend Option...............................72
  154.                  4.23. Domains Option...............................72
  155.                  4.24. Dosearch Option..............................72
  156.                  4.25. Drives Option................................73
  157.                  4.26. Entiredisk Option............................73
  158.                  4.27. Escape Option................................74
  159.                  4.28. Filename Option..............................74
  160.                  4.29. Findexts Option..............................76
  161.                  4.30. Findextsval Option...........................76
  162.                  4.31. Floppy Option................................77
  163.                  4.32. Force Option.................................77
  164.                  4.33. Forceglobal Option...........................77
  165.                  4.34. Hide Option..................................78
  166.                  4.35. Id Option....................................78
  167.  
  168.  
  169.                  4.36. Indir Option.................................79
  170.                  4.37. Ismca Option.................................79
  171.                  4.38. Landrives Option.............................80
  172.                  4.39. Landriveso Option............................80
  173.                  4.40. Lotus Option.................................80
  174.                  4.41. Miscid1 Option...............................81
  175.                  4.42. Miscid2 Option...............................81
  176.                  4.43. Modemid Option...............................82
  177.                  4.44. Monitorid Option.............................82
  178.                  4.45. Needdir Option...............................82
  179.                  4.46. Needfile Option..............................83
  180.                  4.47. Needspace Option.............................83
  181.                  4.48. Noalignext Option............................84
  182.                  4.49. Nodescend Option.............................85
  183.                  4.50. Nofilesdefault Option........................85
  184.                  4.51. Nomsg Option.................................85
  185.                  4.52. Nonumber Option..............................86
  186.                  4.53. Noreadmsg Option.............................87
  187.                  4.54. Normal Option................................87
  188.                  4.55. Noshowdir Option.............................88
  189.                  4.56. Nostatus Option..............................88
  190.                  4.57. Outdir Option................................90
  191.                  4.58. Outdirnov Option.............................90
  192.                  4.59. Overwrite Option.............................90
  193.                  4.60. Pause Option.................................91
  194.                  4.61. Printerid Option.............................91
  195.                  4.62. Proginfo Option..............................91
  196.                  4.63. Progslimit Option............................92
  197.                  4.64. Protected Option.............................92
  198.                  4.65. Quiet Option.................................92
  199.                  4.66. Recslimit Option.............................93
  200.                  4.67. Recsnotify Option............................93
  201.                  4.68. Ringbell Option..............................93
  202.                  4.69. Saveids Option...............................94
  203.                  4.70. Servers Option...............................94
  204.                  4.71. Servertypes Option...........................94
  205.                  4.72. Showdir Option...............................94
  206.                  4.73. Size Option..................................95
  207.                  4.74. Sizek Option.................................95
  208.                  4.75. Skipdrives Option............................96
  209.                  4.76. Smallfiles Option............................97
  210.                  4.77. Smallfilesize Option.........................97
  211.                  4.78. Sorte Option.................................97
  212.                  4.79. Spacechar Option.............................98
  213.                  4.80. Timestamp Option.............................98
  214.                  4.81. Totals Option................................98
  215.                  4.82. Totext Option................................99
  216.                  4.83. Userid Option................................99
  217.                  4.84. Username Option.............................100
  218.  
  219.  
  220.                                  LIST  OF  TABLES
  221.  
  222.  
  223.  
  224.                   Physical equipment fields (part 1)................15
  225.  
  226.                   Physical equipment fields (part 2)................16
  227.  
  228.                   Physical equipment screen editing keys............16
  229.  
  230.                   ICF Commands Summary..............................18
  231.  
  232.                   ICF Options Summary...............................25
  233.  
  234.                   Drive options summary.............................28
  235.  
  236.                   Options for testing...............................30
  237.  
  238.                   ICF environment variables.........................30
  239.  
  240.                   Values for ICFINI environment variables...........31
  241.  
  242.                   Structure of program input files..................35
  243.  
  244.                   Structure of microchannel input files.............36
  245.  
  246.                   Output file options...............................36
  247.  
  248.                   Standard file extensions..........................37
  249.  
  250.                   Standard file names...............................37
  251.  
  252.                   Field description data types......................38
  253.  
  254.                   Output file structures by command.................40
  255.  
  256.                   Output file structure for STATUS command..........41
  257.  
  258.                   STATUS command output field ID's..................44
  259.  
  260.                   Packed field values...............................47
  261.  
  262.                   Autorun criteria..................................49
  263.  
  264.                   STATUS command groups.............................58
  265.  
  266.                   File attribute codes..............................63
  267.  
  268.                   Autorun criteria..................................64
  269.  
  270.                   ID option fields..................................78
  271.  
  272.                   Values for /Nomsg option..........................86
  273.  
  274.  
  275.  
  276.                   Timestamp option fields...........................98
  277.                                    ICF REFERENCE MANUAL
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.                                  ______________                                 . INTRODUCTION
  285.  
  286.  
  287.                                               _                                               
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.     1.1. ORGANIZATION OF THIS MANUAL
  295.  
  296.        This manual is divided into several chapters:
  297.  
  298.          Chapter 1 includes this introduction, as well as a quick-start guide
  299.          for "power users". If you're anxious to use ICF without doing much
  300.          reading, skip to the next section and you should find enough informa-
  301.          tion to get started.
  302.  
  303.          Chapter 2 consists of a more in-depth overview and guide of what ICF
  304.          can do,  with detailed information intended to provide the ICF in-
  305.          staller / administrator with techniques and strategies for accomplish-
  306.          ing  the PC inventory-collection function.
  307.  
  308.          Chapter 3 is a reference of all ICF commands.
  309.  
  310.          Chapter 4 is a reference of all ICF options.
  311.  
  312.  
  313.        The reference portion of this manual, chapters 3 and 4, lists the com-
  314.        mands and options of ICF in alphabetical order. Each command and option
  315.        is explained using the following format:
  316.  
  317.  
  318.  
  319.  
  320.     SYNTAX
  321.        If the command or option has a special syntax, other than the default
  322.        syntax, it is shown here. The default syntax for ICF commands and options
  323.        is described in the section Starting ICF on page 10.
  324.  
  325.     DESCRIPTION
  326.        This describes the command or option in detail.
  327.  
  328.     VALID FOR
  329.        Many commands and options are only valid during certain situations:
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                            Page 1
  336.                                    ICF REFERENCE MANUAL
  337.  
  338.  
  339.  
  340.          Some commands only work with certain operating systems.
  341.  
  342.          Some options only work with some commands.
  343.  
  344.  
  345.        If the particular command or option is valid under certain conditions,
  346.        then those conditions are described here.
  347.  
  348.     EXAMPLES
  349.        In many cases examples are shown to demonstrate the use and syntax  of
  350.        the command or option.
  351.  
  352.  
  353.  
  354.        NOTE:  In all examples the ICF program is referred to as ICF.EXE, even
  355.        though ICF is distributed as uniquely named executable programs de-
  356.        pending on the target operating system (i.e. the DOS version is
  357.        ICFDOS.EXE and the OS/2 version is ICFOS2.EXE). In sites where only
  358.        one operating system is in use, it is common to rename the .EXE file
  359.        to ICF.EXE to make things simple.
  360.  
  361.  
  362.  
  363.  
  364.  
  365.     SEE ALSO
  366.        A list of other topics is given to obtain information on related sub-
  367.        jects.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.     1.2. QUICK-START (POWER-USER) GUIDE
  374.  
  375.  
  376.  
  377.     1.2.1. GETTING STARTED
  378.  
  379.        Getting ICF started is as simple as copying the required files to a hard
  380.        drive or another floppy disk. Use the program version appropriate for the
  381.        operating system in use:1
  382.  
  383.          ICFDOS.EXE     used for DOS versions 2.x and above
  384.          ICFOS2.EXE     used for OS/2 versions 1.2 and above
  385.                         
  386.  
  387.        1 Throughout this manual the ICF program is referred to simply as "ICF",
  388.        implying an executable file name of ICF.EXE. Many ICF users rename
  389.        ICFDOS.EXE or ICFOS2.EXE to ICF.EXE to simplify calling the program. We
  390.        do not recommend this in environments where both versions are used.
  391.  
  392.  
  393.  
  394.                                            Page 2
  395.                                    ICF REFERENCE MANUAL
  396.  
  397.  
  398.  
  399.  
  400.        ICF uses input files to provide data for identifying software and hard-
  401.        ware. These files are named ICFPROG1.DBF and ICFMCA1.DBF respectively. If
  402.        you want to enable automatic recognition of software packages and micro-
  403.        channel boards, these files are required by ICF. They should be located
  404.        either in the current directory when ICF is started, or the directory
  405.        specified in the /Indir option.
  406.  
  407.        If you plan on using the HELP command, the ICFHELP1.DBF and ICFHELP2.DBF
  408.        files must also be located in the current or /Indir-specified directory.
  409.  
  410.  
  411.     1.2.2. RUNNING ICF
  412.  
  413.        To start ICF, type  the appropriate command on the command line followed
  414.        by any required options. Some examples illustrate this:
  415.  
  416.        ICF
  417.           This by itself produces an error message since no command was
  418.           given after the program name.
  419.  
  420.        ICF HELP
  421.           Displays a list of help topics available. To access help the files
  422.           ICFHELP1.DBF and ICFHELP2.DBF must be in the current directory, or
  423.           the directory specified by the /Indir option. If ICF cannot find
  424.           them an error message is displayed.
  425.  
  426.        ICF HELP STATUS
  427.           Displays a list of all help subjects with the word "STATUS" ap-
  428.           pearing anywhere in the topic name. In this example "STATUS" is
  429.           considered a parameter of the HELP command.
  430.  
  431.        ICF FILES
  432.           Displays a directory of all files in all directories on all local
  433.           drives. It is important to note that the FILES and PROGRAMS com-
  434.           mand can have a file specification parameter after the command,
  435.           but if one is not specified then all files are assumed.
  436.  
  437.        ICF FILES D
  438.           Same as above, but only looks at drive D:
  439.  
  440.        ICF PROGRAMS
  441.           Performs a program scan of all directories on all drives and iden-
  442.           tifies recognized software. For this command to function the
  443.           ICFPROG1.DBF file must be in the current directory or the direc-
  444.           tory specified by the /Indir option.
  445.  
  446.        ICF STATUS
  447.           Performs a complete status, similar to a configuration report, of
  448.           installed hardware and software and displays the results on the
  449.  
  450.  
  451.  
  452.  
  453.                                            Page 3
  454.                                    ICF REFERENCE MANUAL
  455.  
  456.  
  457.  
  458.           screen. The STATUS command includes the program scan performed by
  459.           the PROGRAMS command.
  460.  
  461.  
  462.  
  463.     1.2.3. USING OPTIONS
  464.  
  465.        Options are used to fine-tune the operation of ICF. Include them after
  466.        the command and any parameters of the command.
  467.  
  468.        ICF FILES BAK /RINGBELL
  469.           Find all files and all drives with the text "BAK" anywhere in the
  470.           file name. The bell is sounded when the scan is complete.
  471.  
  472.  
  473.  
  474.  
  475.        NOTE: Unlike DOS, ICF by default uses a quicker method of specifying
  476.        file names to search for. Any text included as parameters to the FILES
  477.        or PROGRAMS command is not treated as a file name, but as text that
  478.        can appear anywhere in the name or extension. There are ways to re-
  479.        store normal DOS-like behavior. For more information refer to the sec-
  480.        tion File Scan Operations on page 18.
  481.  
  482.  
  483.  
  484.  
  485.        ICF FILES *.EXE /LANDRIVESO /PAUSE
  486.           Searches for and displays all files with an .EXE extension. The
  487.           search is limited to LAN drives only, and the display is paused
  488.           every time the screen fills up.
  489.  
  490.  
  491.  
  492.     1.2.4. USING OPTION VALUES
  493.  
  494.        For options that have values, separate the value from the option with a
  495.        "=
  496.        or ":" as shown in the examples:
  497.  
  498.        ICF FILES /DBASE /FILENAME=FILEDATA
  499.           All local drives are scanned and every file is recorded in a Dbase
  500.           formatted file (.DBF). The name of the output file is
  501.           FILEDATA.DBF.
  502.  
  503.        ICF FILES /DBASE /FILENAME=FILEDATA /LANDRIVES /SKIPDRIVES=RW
  504.           Same as above but LAN drives are included in the search
  505.           (/Landrives). Drives R: and W: are skipped.
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.                                            Page 4
  513.                                    ICF REFERENCE MANUAL
  514.  
  515.  
  516.  
  517.        ICF STATUS /ASCII /OVERWRITE /OUTDIR=Z:\ICF
  518.           A status command is performed, with output being saved to an Ascii
  519.           comma-delimited file. Since the /Filename option was not given the
  520.           default STATUS file name of ICFINV will be used.  If the file al-
  521.           ready exists, it will be overwritten. The file is saved in the di-
  522.           rectory Z:\ICF.
  523.  
  524.  
  525.  
  526.     1.2.5. SAVING INFORMATION IN A FILE
  527.  
  528.        Some of the examples above specify that output should be saved to a file.
  529.        ICF normally displays the results of a command on the screen. To save
  530.        this to a file, use one of the following methods:
  531.  
  532.          Use DOS redirection to save the output exactly as it appears on the
  533.          screen.
  534.  
  535.          Use the /Dbase option to save the output in a structured Dbase .DBF
  536.          file.
  537.  
  538.          Use the /Lotus option to save the output in a .WK1 spreadsheet.
  539.  
  540.          Use the /Ascii option to save the output in a comma-delimited file.
  541.  
  542.  
  543.  
  544.        ICF FILES E:\TOOLS >FILELIST.TXT
  545.           Does a directory of all files in all directories starting with the
  546.           E:\TOOLS directory, and uses DOS redirection to save the results
  547.           in a text file.
  548.  
  549.        ICF FILES E:\TOOLS >FILELIST.TXT /DBASE
  550.           Same as above, but saves the data in a Dbase file.
  551.  
  552.        ICF PROGRAMS D /ASCII
  553.           Searches all files in all directories on drive D:, recognizes and
  554.           saves programs to an Ascii comma-delimited file. This file can be
  555.           easily imported into virtually any software package for further
  556.           analysis.
  557.  
  558.        ICF PROGRAMS /ASCII /OVERWRITE
  559.           Same as above but the /Overwrite option permits ICF to overwrite
  560.           an existing output file. Since the /Filename option wasn't speci-
  561.           fied, a default file name is used.
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.                                            Page 5
  572.                                    ICF REFERENCE MANUAL
  573.  
  574.  
  575.  
  576.        ICF PROGRAMS /ASCII /APPEND
  577.           Appends new data to an already existing output file. If one does
  578.           not exist it is created.2
  579.  
  580.        ICF FILES *:\*.BAK /LOTUS
  581.           Saves a record of all files found with a .BAK extension, in all
  582.           directories and all drives, in a Lotus 1-2-3 worksheet using the
  583.           .WK1 file format.
  584.  
  585.  
  586.  
  587.     1.2.6. USING ICF ON A LAN
  588.  
  589.        To use ICF on computers attached to a LAN, use the /Indir and /Outdir op-
  590.        tions as appropriate.
  591.  
  592.        ICF PROGRAMS /INDIR=Z:\ICF /OUTDIR=L:\ICFDATA /DBASE
  593.           Saves a record of all programs found on all local drives. Data
  594.           used for recognizing programs are read from files located in the
  595.           Z:\ICF directory. The output .DBF file is written to the
  596.           L:\ICFDATA directory.
  597.  
  598.        ICF FILES *.BAT /OUTDIR=S:\SAVE /FILENAME=$TEMP /ASCII
  599.           Using the /Filename option instructs ICF not to use the standard
  600.           file name and use a unique name instead. The $TEMP value results
  601.           in a file name in the form ICFnnnnn.ASC, where nnnnn is a number
  602.           generated automatically by ICF to ensure that the file name does
  603.           not conflict with existing files in the output directory.
  604.  
  605.  
  606.  
  607.     1.2.7. MAKING OPTIONS PERMANENT
  608.  
  609.        As you can see, there are quite a few options available for fine-tuning
  610.        the operation of ICF. In order to make the task of specifying options
  611.        easier, they may be placed in environment variables and/or ICF.INI files.
  612.  
  613.        ICF will upon startup look for an environment variable called ICF
  614.        (appropriate, isn't it?). Any options included are added to those speci-
  615.        fied on the command line. For example:
  616.  
  617.        SET ICF=/INDIR:S:\ICF\FILES /OUTDIR:Z:\ /DBASE /OVERWRITE
  618.           will create an environment variable called ICF and set it to the
  619.           options shown. Thus any future ICF commands will automatically in-
  620.           herit these options in addition to those on the command line.
  621.  
  622.  
  623.                         
  624.  
  625.        2 The /Append option is not functional when /Lotus is used to save output
  626.        in a .Wk1 spreadsheet.
  627.  
  628.  
  629.  
  630.                                            Page 6
  631.                                    ICF REFERENCE MANUAL
  632.  
  633.  
  634.  
  635.        A text file called ICF.INI can be created in which other options may be
  636.        placed. Each option should be placed on a line by itself, and the / char-
  637.        acter preceding the option is not necessary. ICF expects to find the
  638.        ICF.INI file in the current directory. This operation can be changed how-
  639.        ever - for more information refer to Options Specification Methods on
  640.        page 25.
  641.  
  642.        All of these methods are additive, permitting the ICF administrator to
  643.        predefine system-wide options and save time in creating workstation cop-
  644.        ies of complex command lines.
  645.  
  646.  
  647.     1.2.8. MODIFYING ICF INPUT FILES
  648.  
  649.        ICF does not provide a built-in mechanism for modifying its own input
  650.        files. However, all input files are in standard Dbase .DBF files and can
  651.        be either natively processed by many popular database programs, or im-
  652.        ported into other database programs (i.e. Paradox), modified, and then
  653.        exported back to the .DBF file.
  654.  
  655.  
  656.  
  657.        NOTE: In all cases the exact structure of the input files must be
  658.        maintained.
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.                                            Page 7
  690.                                    ICF REFERENCE MANUAL
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.                                   ___                                  IDE
  698.  
  699.  
  700.                                     _                                     
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.     2.1. OVERVIEW
  708.  
  709.        ICF is the Inventory Capture Facility. It is a very powerful and flexible
  710.        program that searches for and collects data on a variety of computer sys-
  711.        tem components. Some of its capabilities include:
  712.  
  713.          It is available for DOS and OS/2 operating systems. No matter who wins
  714.          the great operating system wars, you know what's on your PC's.
  715.  
  716.          It can search for and list files on all drives, local and remote, and
  717.          use any number of filtering options when searching, including file at-
  718.          tributes, size, name, etc.
  719.  
  720.          It can search for and report all software packages, including both pre-
  721.          defined packages as well as custom software. The database for pre-de-
  722.          fined software is user-defined, allowing new programs to be added. ICF
  723.          can also, upon request, capture a record of all software programs re-
  724.          gardless of whether or not they have been defined in the recognition
  725.          database.
  726.  
  727.          On microchannel computers it can report on all boards installed.
  728.  
  729.          It can analyze and report on system parameters, including DOS version,
  730.          name, memory (normal, extended, expanded), CMOS data, mouse informa-
  731.          tion, etc.
  732.  
  733.          It can record physical or stand-alone components that cannot automati-
  734.          cally be recognized.
  735.  
  736.          It can completely automate the collection of data and save information
  737.          on shared LAN drives.
  738.  
  739.          It can run standalone and store data files on floppy disks.
  740.  
  741.          It can gather network (LAN) information.
  742.  
  743.          It can perform a quick "pre-check" to determine whether or not changes
  744.          have actually been made to the configuration of a PC, and then decide
  745.  
  746.  
  747.  
  748.                                            Page 8
  749.                                    ICF REFERENCE MANUAL
  750.  
  751.  
  752.  
  753.          to perform a full configuration data collection. This feature allows
  754.          ICF to be run every day and not impact the user unless the workstation
  755.          configuration has changed.
  756.  
  757.          It is easy to use, command-line driven, and flexible with hundreds of
  758.          options to fine-tune operation.
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.     2.2. VERSIONS OF ICF
  766.  
  767.  
  768.  
  769.     2.2.1. DOS VERSION
  770.  
  771.        The DOS version of ICF supports DOS versions 2.x and above. The name of
  772.        the executable as shipped on the distribution disk is ICFDOS.EXE.
  773.  
  774.  
  775.     2.2.2. OS/2 VERSION
  776.  
  777.        ICF is available in an OS/2 version that runs on OS/2 1.1, 1.2, 1.3 and
  778.        2.0. The name of the executable is ICFOS2.EXE.
  779.  
  780.  
  781.     2.2.3. OTHER VERSIONS
  782.  
  783.        Other versions of ICF may be in development, or may be custom developed
  784.        by request. Contact LanTelligence Corporation for information.
  785.  
  786.  
  787.  
  788.  
  789.  
  790.     2.3. INSTALLATION
  791.  
  792.        How ICF is installed depends on the following factors:
  793.  
  794.          Whether ICF is to be used on a LAN or on standalone PC's
  795.  
  796.          What operating system is used
  797.  
  798.          What network operating system is used
  799.  
  800.  
  801.        Installation is simple. ICF only needs its own executable file to run -
  802.        there are no overlays or secondary programs.  When permanently installing
  803.        ICF on LAN-connected computers, ICF can be installed in the AUTOEXEC.BAT
  804.  
  805.  
  806.  
  807.                                            Page 9
  808.                                    ICF REFERENCE MANUAL
  809.  
  810.  
  811.  
  812.        file, or it can be placed in the login script or profile of the network
  813.        operating system so that it runs automatically.
  814.  
  815.        ICF can just as easily be used as a standalone configuration-gathering
  816.        tool. In this case you probably would want to simply copy the required
  817.        ICF version onto a floppy disk and carry it from PC to PC.
  818.  
  819.        ICF uses several data files for the input recognition database. If you
  820.        plan on performing automatic software and microchannel board recognition
  821.        then the ICFPROG1.DBF and ICFMCA1.DBF files should be copied to the di-
  822.        rectory where ICF resides. If the directory where these files are placed
  823.        is not the current directory when ICF is run, the /Indir option must be
  824.        used so ICF can find them. For more information on these files refer to
  825.        ICF Input Files on page 33.
  826.  
  827.  
  828.  
  829.  
  830.  
  831.     2.4. STARTING ICF
  832.  
  833.     SYNTAX
  834.        ICF is run from the DOS prompt and the syntax is as follows:
  835.  
  836.        ICF <command> <command parameters> <options>
  837.  
  838.        The <command> may be any valid command for ICF. The <command parameters>
  839.        are command-specific options that restrict ICF operation to certain func-
  840.        tions. <Options> is a list of options separated by spaces. Options must
  841.        be prefixed with the / or - characters.
  842.  
  843.     EXAMPLES
  844.        ICF FILES
  845.           List all files (directory information) on all drives. By default
  846.           (if no file specification appears after the FILES command) ICF
  847.           searches all files in all directories.
  848.  
  849.        ICF FILES D:\SAMPLES /NODESCEND
  850.           The FILES command operates only on the included parameter
  851.           (D:\SAMPLES) . ICF will not descend directories.
  852.  
  853.        ICF STATUS MEM
  854.           Perform the STATUS command, which results in collection of various
  855.           PC configuration information. The parameter MEM of the STATUS com-
  856.           mand indicates that instead of reporting on all status categories,
  857.           only information related to the PC's memory configuration is re-
  858.           ported. For more information on STATUS categories refer to page
  859.           58.
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.                                           Page 10
  867.                                    ICF REFERENCE MANUAL
  868.  
  869.  
  870.  
  871.     SEE ALSO
  872.        Commands Summary, Options Summary, Options Specification Methods
  873.  
  874.  
  875.  
  876.  
  877.  
  878.     2.5. TECHNIQUES
  879.  
  880.  
  881.  
  882.     2.5.1. SCANNING FOR SOFTWARE PROGRAMS
  883.  
  884.        This section deals with an overview, strategies and alternatives for
  885.        scanning computers for software packages. ICF offers several commands
  886.        that result in a program scan operation being performed:
  887.  
  888.          The PROGRAM command performs a program scan of the computer.
  889.  
  890.          The STATUS command may perform a program scan, depending on which pa-
  891.          rameters and options are used.
  892.  
  893.          The AUTO command may also result in a program scan being performed.
  894.          This command first determines if the configuration has been changed
  895.          since the last STATUS command has been run. If it has then another
  896.          STATUS is performed.
  897.  
  898.  
  899.        In addition, there are several different strategies you may want to pur-
  900.        sue when searching for programs:
  901.  
  902.          You can limit the data ICF captures by only recording recognized soft-
  903.          ware.
  904.  
  905.          You can instruct ICF to record information for unrecognized software.
  906.  
  907.          You can do a combination of the two.
  908.  
  909.  
  910.  
  911.  
  912.        2.5.1.1. OVERVIEW OF PROGRAM SCAN OPERATIONS
  913.  
  914.        ICF will start a program scan operation when any of the events described
  915.        above occur.  It will perform a standard file scan operation in order to
  916.        search for software.  This means that ICF will, by default, scan all lo-
  917.        cal drives and directories - which files and drives are searched, and
  918.        whether LAN drives are included, are controlled by the many options re-
  919.        garding how file scan operations are performed. Refer to File Scan
  920.        Operations on page 18 for more information.
  921.  
  922.  
  923.  
  924.  
  925.                                           Page 11
  926.                                    ICF REFERENCE MANUAL
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.        HINT:  When running ICF in a "production" environment, you may want to
  934.        prevent users from limiting the ICF search to individual drives and/or
  935.        directories. They can do this by setting the ICF environment variable
  936.        or using the ICF.INI file to contain the appropriate options. In order
  937.        to override this, use the /Alldisks or /Entiredisk options in your
  938.        batch file or logon script. In addition, the /Forceglobal option is a
  939.        shortcut option that automatically specifies both /Alldisks and
  940.        /Entiredisk. These options override any "filtering" options set previ-
  941.        ously. Refer to the reference section for more information.
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.        2.5.1.2. PROGRAM SCAN COMMANDS
  950.  
  951.        The ICF commands that result in a program scan are PROGRAMS, STATUS, and
  952.        AUTO. The PROGRAMS command is specifically used for searching for softw-
  953.        are on a computer. The STATUS command performs a variety of configura-
  954.        tion-gathering functions, of which the program scan is one of them. The
  955.        AUTO command results in a STATUS command being performed if ICF deter-
  956.        mines it is appropriate to run it (based on whether the configuration has
  957.        changed since the last STATUS was performed). These commands are dis-
  958.        cussed in detail in the Command Reference section starting on page 48.
  959.  
  960.        Note that the STATUS command has optional parameters that follow it on
  961.        the command line. These parameters fine-tune the operations that will be
  962.        performed by the STATUS command, and it is possible to either explicitly
  963.        request that a program scan be performed or, by using the /Nostatus op-
  964.        tion, to explicitly request a program scan not be performed whenever a
  965.        STATUS is run. A complete list of categories/groups  that may be used as
  966.        parameters to the STATUS command appears on page 58.
  967.  
  968.     EXAMPLES
  969.        ICF STATUS PRO /ASCII
  970.           The PRO parameter specifically requests a program scan to be per-
  971.           formed. If parameters are used with STATUS, only those operations
  972.           requested are performed and all other collection groups are omit-
  973.           ted. Output will be saved in an Ascii file.
  974.  
  975.        ICF STATUS /NOSTATUS=PRO
  976.           This is the opposite of the above command. Since no parameters
  977.           were specified, ICF will collect information on all STATUS groups,
  978.           except any groups specified by the /NOSTATUS option. In this case
  979.           the program scan is skipped.
  980.  
  981.  
  982.  
  983.  
  984.                                           Page 12
  985.                                    ICF REFERENCE MANUAL
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.        2.5.1.3. RECOGNIZING PROGRAMS
  993.  
  994.        When a program scan is performed, ICF looks at any file name that has an
  995.        .EXE or .COM extension, indicating it is an executable program. A file is
  996.        considered recognized if it has an entry in the ICFPROGn.DBF file (where
  997.        n is a number from 1 to 9). If a matching file is found it is recorded
  998.        with the file name, path, and description of the software.
  999.  
  1000.  
  1001.  
  1002.        HINT:  If you desire more identification for each program in addition
  1003.        to the name, path and description, use the /Proginfo option. This will
  1004.        result in collecting the file size, date and time as well.
  1005.  
  1006.  
  1007.  
  1008.  
  1009.        By default ICF uses only the file name for comparison. The COMPMETHOD
  1010.        field in the ICFPROGn.DBF file can have an "S" in it, which will instruct
  1011.        ICF to compare file sizes as well. While the file date and time could po-
  1012.        tentially be used, the file size is a more reliable method of verifying
  1013.        the identity of a program, especially when checking for the presence of
  1014.        viruses3.
  1015.  
  1016.  
  1017.  
  1018.        2.5.1.4. CAPTURING NON-RECOGNIZABLE PROGRAMS
  1019.  
  1020.        ICF provides a method for performing what is called after-the-fact pro-
  1021.        gram recognition.  This approach involves recording the file names and
  1022.        other information for non-recognized programs (.EXE and .COM files) in
  1023.        addition to recognized programs. These lists of program files can later
  1024.        be merged and compared, enabling a convenient way of identifying new
  1025.        software packages to add to the recognition database.
  1026.  
  1027.        To do this,  the /Findexts option is used. This instructs ICF to save all
  1028.        files with an .EXE or .COM file extension, as the example below illus-
  1029.        trates:
  1030.  
  1031.  
  1032.  
  1033.  
  1034.                         
  1035.  
  1036.        3 While ICF does not perform virus checking, a potential strategy would
  1037.        be to make special note of unrecognized software with file names that
  1038.        should be recognized. The change in file size would indicate either a
  1039.        different version of the program or the presence of a virus.
  1040.  
  1041.  
  1042.  
  1043.                                           Page 13
  1044.                                    ICF REFERENCE MANUAL
  1045.  
  1046.  
  1047.  
  1048.        ICF PROGRAMS C /FINDEXTS /ASCII /FILENAME:PROGDATA
  1049.           Perform a program scan on drive C:, searching all files and direc-
  1050.           tories, saving the file name and software product description in
  1051.           an Ascii file named Progdata.
  1052.  
  1053.        Even more file types an be recorded by using the /Findextsval option. As
  1054.        a value to this option you provide a comma-separated list of file exten-
  1055.        sions. Any files with an extension in this list will also be recorded:
  1056.  
  1057.        ICF PROGRAMS /FINDEXTS /FINDEXTSVAL:FON,OVL /LOTUS
  1058.           A program scan is performed on all local drives, recording all
  1059.           files with an extension .COM, .EXE, .FON, or .OVL. Recorded infor-
  1060.           mation is saved in a .WK1 formatted file.
  1061.  
  1062.  
  1063.  
  1064.     2.5.2. COLLECTING PHYSICAL CONFIGURATION DATA
  1065.  
  1066.        ICF permits data to be manually entered in order to record information
  1067.        representing physical (stand-alone) equipment and user identification.
  1068.        There are 2 alternative methods that accomplish this:
  1069.  
  1070.          The ASK command and /Ask option present an edit screen in which infor-
  1071.          mation can be manually entered4. This information can optionally be
  1072.          saved in a disk file on the user's workstation.
  1073.  
  1074.          Special ID fields can be used to provide this information to ICF right
  1075.          on the command line. While the data cannot be saved using this approach
  1076.          (it needs to be re-specified each time ICF is run), it offers the
  1077.          flexibility of sending information to ICF using batch file parameters.
  1078.  
  1079.  
  1080.  
  1081.  
  1082.        2.5.2.1. THE ASK COMMAND AND /ASK OPTION
  1083.  
  1084.        The data entry screen that records this information is presented whenever
  1085.        the ASK command or /Ask option is specified.
  1086.  
  1087.          The ASK command is used to present the edit screen to enter this infor-
  1088.          mation. Any changes made while editing are automatically saved. Once
  1089.          the edit screen is exited, ICF does not perform any other operation and
  1090.          exits to the operating system.
  1091.  
  1092.          The /Ask option is used in conjunction with the STATUS or AUTO com-
  1093.          mands. When specified, the edit screen is presented and then a configu-
  1094.          ration run is performed (depending on other options specified with the
  1095.                         
  1096.  
  1097.        4 These are mutually exclusive features. The /Ask option is used with the
  1098.        STATUS and AUTO commands, while the ASK command is used by itself.
  1099.  
  1100.  
  1101.  
  1102.                                           Page 14
  1103.                                    ICF REFERENCE MANUAL
  1104.  
  1105.  
  1106.  
  1107.          particular command given). Any changes made while editing are not saved
  1108.          automatically -- the /Saveids option must be specified for this to oc-
  1109.          cur.
  1110.  
  1111.  
  1112.        If changes are saved, they are stored in a special file normally called
  1113.        C:\AUTORUN.DAT. This file may be named differently or located in a dif-
  1114.        ferent drive/directory if the /Autorunfile option is used. If you want to
  1115.        protect the file from deletion or editing, the /Hide option will mark the
  1116.        file as Hidden, System, and Read-only by setting the appropriate file at-
  1117.        tributes.
  1118.  
  1119.        The following information can be entered:
  1120.  
  1121.  
  1122.  
  1123.         FIELD NAME    DESCRIPTION
  1124.  
  1125.         User ID       ID of computer user
  1126.  
  1127.         User Name     Name of computer user
  1128.  
  1129.         Location      Can be room, company, floor, dept, etc.
  1130.  
  1131.         Notes 1       Any notes
  1132.  
  1133.         Notes 2       Any notes
  1134.  
  1135.         Equipment     Up to 8 ID and description fields representing physi-
  1136.         ID's          cal (stand-alone) equipment. 5
  1137.  
  1138.  
  1139.          Table   -                1   Physical equipment fields (part 1)
  1140.  
  1141.  
  1142.  
  1143.        For the Equipment ID's shown in the table above, each can consist of the
  1144.        fol   ing fields:          low
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.                         
  1155.  
  1156.        5 While this was designed for recording separate equipment, of course it
  1157.        can also be used for user-defined purposes as well.
  1158.  
  1159.  
  1160.  
  1161.                                                15                                          Page 
  1162.                                    ICF REFERENCE MANUAL
  1163.  
  1164.  
  1165.  
  1166.  
  1167.      FIELD    DESCRIPTION
  1168.  
  1169.      Type     Typically P=Printer, M=Modem, C=Computer, etc.
  1170.  
  1171.      Make     Brand of equipment
  1172.  
  1173.      Model    Model description of equipment
  1174.  
  1175.      Serial   Serial number of item
  1176.  
  1177.  
  1178.          Table     Physical equipment fields (part 2)                 -                2
  1179.  
  1180.  
  1181.  
  1182.  
  1183.        When ICF sees the ASK command or /Ask option, the edit screen appears.
  1184.  
  1185.  
  1186.        The following keys are available for use when editing this data:
  1187.  
  1188.  
  1189.  
  1190.      KEYS              ACTION
  1191.  
  1192.         , SHIFT-TAB     TAB               moves cursor between fields
  1193.      and ENTER
  1194.  
  1195.      Arrow keys        moves cursor between letters
  1196.  
  1197.      Home, End         moves cursor to start / end of field
  1198.  
  1199.      CTRL-W            saves entered information
  1200.  
  1201.      ESC               aborts any changes made
  1202.  
  1203.  
  1204.          Table     Physical equipment screen editing keys                 -                3
  1205.  
  1206.  
  1207.  
  1208.  
  1209.     SEE ALSO
  1210.        Ask Option, Ask Command, Saveids Option, Autorunfile Option, Hide Option
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.                                                16                                          Page 
  1221.                                    ICF REFERENCE MANUAL
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.        2.5.2.2. ID FIELDS
  1229.  
  1230.        In order to accommodate the automatic capture of inventory information
  1231.        that is not a physical part of the computer, ICF provides a number of
  1232.        special "ID" fields. These are specified on the command line using the
  1233.        appropriate option and any value as a parameter to the option. The op-
  1234.        tions are only valid for the STATUS and AUTO commands. Like any other op-
  1235.        tion, these can be issued on the command line, or stored in a batch file,
  1236.        environment variable, or ICF.INI file.
  1237.  
  1238.        Unlike the ASK command and /Ask option, using these options will prevent
  1239.        you from being able to save the information. Every time ICF is run they
  1240.        will have to be included again. They are useful, however, for batch files
  1241.        and stand-alone inventory collection.
  1242.  
  1243.        The syntax for each option is:
  1244.  
  1245.        /<option name>=<string>
  1246.  
  1247.  
  1248.     EXAMPLES
  1249.        /PRINTERID=LASERJET
  1250.  
  1251.        /COMPUTERNAME=JIMSPC
  1252.  
  1253.        /MODEMID=HAYES1200
  1254.  
  1255.        Whenever one of these options is given, ICF will include its field iden-
  1256.        tifier and value in the output file when the Status command is performed.
  1257.        Refer to Output File Structures on page 38 to see what field identifiers
  1258.        are associated with each option.
  1259.  
  1260.        Following is a list of the available options.
  1261.  
  1262.          /Computerid
  1263.          /Miscid1
  1264.          /Miscid2
  1265.          /Modemid
  1266.          /Monitorid
  1267.          /Printerid
  1268.          /Userid
  1269.          /Username
  1270.          /Computername
  1271.          /Companyname
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.                                           Page 17
  1280.                                    ICF REFERENCE MANUAL
  1281.  
  1282.  
  1283.  
  1284.     SEE ALSO
  1285.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  1286.        Option, Monitorid Option, Userid Option, Username Option, Computername
  1287.        Option, Companyname Option, Printerid Option
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.     2.6. USING ICF COMMANDS
  1294.  
  1295.  
  1296.  
  1297.     2.6.1. COMMANDS SUMMARY
  1298.  
  1299.        Following is a summary of ICF commands.
  1300.  
  1301.  
  1302.      COMMAND      DESCRIPTION
  1303.  
  1304.      Files        Gather information about specified files
  1305.  
  1306.      Status       Gather status and inventory collection information
  1307.  
  1308.      Auto         Automatic version of Status command
  1309.  
  1310.      Programs     Gather program information
  1311.  
  1312.      Diskspace    Collect statistics on disk space
  1313.  
  1314.      Help         Display help on specified topics
  1315.  
  1316.  
  1317.          Table 4 -  ICF Commands Summary
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.     SEE ALSO
  1324.        Files Command, Status Command, Auto Command, Programs Command, Diskspace
  1325.        Command, Help Command
  1326.  
  1327.  
  1328.  
  1329.     2.6.2. FILE SCAN OPERATIONS
  1330.  
  1331.        The FILES and PROGRAMS commands perform file scan operations - basically
  1332.        they scan disk drives for files. Following are the rules outlining how
  1333.        these operations are carried out, illustrated with examples.
  1334.  
  1335.  
  1336.  
  1337.  
  1338.                                           Page 18
  1339.                                    ICF REFERENCE MANUAL
  1340.  
  1341.  
  1342.  
  1343.  
  1344.     EXAMPLES
  1345.        By default ICF always searches all directories on all local drives. To
  1346.        extend the search to LAN (remote) drives, the following options may be
  1347.        used:
  1348.  
  1349.          /Landrives     Include LAN drives
  1350.          /Landriveso    Only scan LAN drives
  1351.  
  1352.  
  1353.        ICF FILES /LANDRIVES
  1354.           will search for all files on all drives, local and remote.
  1355.  
  1356.        If you want to restrict the scan to an individual drive, just the drive
  1357.        letter will suffice:
  1358.  
  1359.        ICF FILES D
  1360.           will search for all files on drive D:. Note that the colon is not
  1361.           necessary. Not only is it not necessary, but including a colon ac-
  1362.           tually means something else! The following command:
  1363.  
  1364.        ICF FILES D:
  1365.           tells ICF to search for all files in all directories on drive D:,
  1366.           starting with the current directory. Unlike the previous example
  1367.           where the colon is omitted and the scan starts at the root direc-
  1368.           tory, using a colon performs a "relative" search.
  1369.  
  1370.        Of course, you can specify the directory to start with by including it
  1371.        after the drive designation:
  1372.  
  1373.        ICF PROGRAMS E:\MYPROG
  1374.           will search for all programs on drive E:, starting in the \MYPROG
  1375.           directory. As in the previous examples, nested directories are
  1376.           scanned as well. To prevent directories from being "descended",
  1377.           use the /Nodescend option:
  1378.  
  1379.        ICF PROGRAMS C:\DOS /NODESCEND
  1380.  
  1381.        Finally, let's look at specifying individual files to search for. Unlike
  1382.        normal DOS conventions, simply listing a file name does something
  1383.        slightly different from what you might expect:
  1384.  
  1385.        ICF FILES F:\TEST
  1386.           This command will not search for a file called TEST, but rather
  1387.           for any file with the string "TEST" in it. In DOS terms, it is
  1388.           equivalent to "*TEST*.*" (ignoring the fact that DOS will ignore
  1389.           the second *). This convention makes it easy to search for files.
  1390.  
  1391.        There are probably times, however, where you will want to use the stan-
  1392.        dard DOS convention of specifying file names. The /Dosearch option will
  1393.        accomplish this. The command:
  1394.  
  1395.  
  1396.  
  1397.                                           Page 19
  1398.                                    ICF REFERENCE MANUAL
  1399.  
  1400.  
  1401.  
  1402.  
  1403.        ICF FILES F:\TEST /DOSEARCH
  1404.           will scan only for the file "TEST" in all directories on drive F:,
  1405.           starting in the root directory. If you want to search all drives
  1406.           (local drives by default), replace the drive letter with a "*":
  1407.  
  1408.        ICF FILES *:\TEST
  1409.           will scan for all files containing "TEST" in the file name, on all
  1410.           drives and in all directories.
  1411.  
  1412.        In the special (and probably rare) case where you want to find a file
  1413.        that is precisely one letter long, the following won't work:
  1414.  
  1415.        ICF FILES D
  1416.  
  1417.        since it will scan all files on drive D:, and not for a file called "D".
  1418.        If the latter is what you want, use the /Colon option:
  1419.  
  1420.        ICF FILES D /COLON
  1421.           tells ICF not to use the special "no colon means entire drive"
  1422.           convention and search for a file called "D".
  1423.  
  1424.  
  1425.        MAKING OPTIONS PERMANENT
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.        If you want any of the options shown above to be the default behavior,
  1432.        simply include the options in the ICF environment variable, or the
  1433.        ICF.INI file.
  1434.  
  1435.     SEE ALSO
  1436.        Nodescend Option, Landrives Option, Landriveso Option, Files Command,
  1437.        Programs Command, Environment Variables, ICF.INI File, Nofilesdefault
  1438.        Option
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.     2.7. USING ICF OPTIONS
  1445.  
  1446.  
  1447.  
  1448.     2.7.1. OPTIONS SUMMARY
  1449.  
  1450.        Following is a summary of all the options for ICF.
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.                                           Page 20
  1457.                                    ICF REFERENCE MANUAL
  1458.  
  1459.  
  1460.  
  1461.  
  1462.             OPTION        CATEGORY                  DESCRIPTION
  1463.  
  1464.         Alldisks       File scan      Include all drives
  1465.                        operations
  1466.  
  1467.         Allext         File scan      Include all extensions
  1468.                        operations
  1469.  
  1470.         Append         File output    Append data to output file
  1471.  
  1472.         Ascii          File output    Output data to Ascii comma-delimited
  1473.                                       file
  1474.  
  1475.         Ask            Physical       Full-screen equipment entry screen
  1476.                        equipment
  1477.  
  1478.         Attrs          File scan      Specify attributes to search for
  1479.                        operations
  1480.  
  1481.         Autodays       AUTO command   Number of days to skip between STATUS
  1482.  
  1483.         Autorun        AUTO command   AUTO options
  1484.  
  1485.         Autorunfile    AUTO command   File to save configuration data on lo-
  1486.                                       cal PC
  1487.  
  1488.         Autospace      AUTO command   Amount of disk space change that trig-
  1489.                                       gers STATUS command
  1490.  
  1491.         Banner         Misc           Display misc. message at startup
  1492.  
  1493.         Batch          Shortcut op-   Specifies /Quiet and other options
  1494.                        tion
  1495.  
  1496.         Bigfiles       File scan      Search for large files
  1497.                        operations
  1498.  
  1499.         Bigfilesize    File scan      Specify compare size for /Bigfiles
  1500.                        operations
  1501.  
  1502.         Break          User control   Handling of Ctrl-Break during process-
  1503.                                       ing
  1504.  
  1505.         Cls            Screen out-    Clear screen before starting
  1506.                        put
  1507.  
  1508.         Colon          File scan      Single letter file spec is not a drive
  1509.                        operations     name
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                           Page 21
  1516.                                    ICF REFERENCE MANUAL
  1517.  
  1518.  
  1519.  
  1520.  
  1521.         Companyname    ID field       Specify company name
  1522.  
  1523.         Computerid     ID field       Specify computer id
  1524.  
  1525.         Dbase          File output    Output data to .DBF file
  1526.  
  1527.         Desc           File output    Add description info to STATUS output
  1528.                                       fields
  1529.  
  1530.         Descend        File scan      Process subdirectores
  1531.                        operations
  1532.  
  1533.         Domains        LAN versions   User for LAN-specific versions of ICF
  1534.  
  1535.         Dosearch       File scan      Use normal DOS file search method
  1536.                        operations
  1537.  
  1538.         Drives         File scan      Specify drives to search
  1539.                        operations
  1540.  
  1541.         Entiredisk     File scan      Search entire drive
  1542.                        operations
  1543.  
  1544.         Escape         User control   Permit abort by hitting ESC key
  1545.  
  1546.         Filename       File output    Specify name of output file
  1547.  
  1548.         Findexts       Program scan   Record information for all .COM and
  1549.                                       .EXE files found
  1550.  
  1551.         Findextsval    Program scan   Add other extensions to /Findexts proc-
  1552.                                       essing
  1553.  
  1554.         Floppy         Shortcut op-   Specifies options for saving output to
  1555.                        tion           A:
  1556.  
  1557.         Force          AUTO command   Forces STATUS to be performed
  1558.  
  1559.         Forceglobal    Shortcut op-   Specifies /Alldisks and /Entiredisk
  1560.                        tion           options
  1561.  
  1562.         Hide           AUTO command   Set AUTO file to hidden, system and
  1563.                                       readonly attributes
  1564.  
  1565.         Id             File output    Extra fields are added to STATUS file
  1566.                                       output to identify workstation
  1567.  
  1568.         Indir          File input     Specify input file directory
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.                                                22                                          Page 
  1575.                                    ICF REFERENCE MANUAL
  1576.  
  1577.  
  1578.  
  1579.  
  1580.         Ismca          STATUS com-    Tells ICF computer is microchannel
  1581.                        mand
  1582.  
  1583.         Landrives      File scan      Include LAN drives in search
  1584.                        operations
  1585.  
  1586.         Landriveso     File scan      Only include LAN drives in search
  1587.                        operations
  1588.  
  1589.         Lotus          File output    Output data to .WK1 file
  1590.  
  1591.         Miscid1        ID field       Specify user-defined ID
  1592.  
  1593.         Miscid2        ID field       Specify user-defined ID
  1594.  
  1595.         Modemid        ID field       Specify model ID
  1596.  
  1597.         Monitorid      ID field       Specify monitor ID
  1598.  
  1599.         Needdir        Misc           Make sure directory is present before
  1600.                                       running
  1601.  
  1602.         Needspace      Misc           Make sure enough disk space is avail-
  1603.                                       able before running
  1604.  
  1605.         Noalignext     FILES com-     Do not align extensions when outputting
  1606.                        mand           to screen
  1607.  
  1608.         Nodescend      File scan      Do not descend directory trees
  1609.                        operations
  1610.  
  1611.         Nofilesdefault File scan      FILES and PROGRAMS commands must have
  1612.                        operations     file specs as parameters
  1613.  
  1614.         Nomsg          Output mes-    Specify types of messages that should
  1615.                        sages          not be output
  1616.  
  1617.         Nonumber       Screen out-    Do not number file listings
  1618.                        put
  1619.  
  1620.         Noreadmsg      Output mes-    Do not display file input status mes-
  1621.                        sages          sages
  1622.  
  1623.         Normal         File scan      Search for files that don't have hid-
  1624.                        operations     den, system or readonly attributes set
  1625.  
  1626.         Noshowdir      FILES com-     Do not show <DIR> entries in screen
  1627.                        mand           output
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.                                                23                                          Page 
  1634.                                    ICF REFERENCE MANUAL
  1635.  
  1636.  
  1637.  
  1638.  
  1639.         Nostatus       STATUS com-    Specify status categories to ignore
  1640.                        mand
  1641.  
  1642.         Outdir         File output    Specify output directory
  1643.  
  1644.         Outdirnov      File output    Output directory overrides /Filename
  1645.                                       path
  1646.  
  1647.         Overwrite      File output    Overwrite file if it exists
  1648.  
  1649.         Pause          Screen out-    Pause when screen fills up
  1650.                        put
  1651.  
  1652.         Printerid      ID field       Specify printer ID
  1653.  
  1654.         Proginfo       Program scan   Include additional data when outputting
  1655.                                       program identification information
  1656.  
  1657.         Progslimit     Testing        Specify number of programs to search
  1658.                                       for
  1659.  
  1660.         Protected      File scan      Search for hidden, system or readonly
  1661.                        operations     files
  1662.  
  1663.         Quiet          Output mes-    Do not display status messages
  1664.                        sages
  1665.  
  1666.         Recslimit      Testing        Limit processing to N records
  1667.  
  1668.         Recsnotify     Testing        Display message every N records
  1669.  
  1670.         Ringbell       Misc           Ring bell when processing completes
  1671.  
  1672.         Saveids        ID field       Save data entered for /Ask option
  1673.  
  1674.         Servers        LAN versions   User for LAN-specific versions of ICF
  1675.  
  1676.         Servertypes    LAN versions   User for LAN-specific versions of ICF
  1677.  
  1678.         Showdir        FILES com-     Display <DIR> entries
  1679.                        mand
  1680.  
  1681.         Size           File scan      Specify size of files to search for
  1682.                        operations
  1683.  
  1684.         Sizek          FILES com-     Display screen output file size in K
  1685.                        mand           units
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.                                           Page 24
  1693.                                    ICF REFERENCE MANUAL
  1694.  
  1695.  
  1696.  
  1697.  
  1698.         Skipdrives     File scan      Do not process specified drives
  1699.                        operations
  1700.  
  1701.         Smallfiles     File scan      Search for small files
  1702.                        operations
  1703.  
  1704.         Smallfilesize  File scan      Specify compare size for /Smallfiles
  1705.                        operations
  1706.  
  1707.         Sorte          FILES com-     Sort file names by extension before
  1708.                        mand           output to screen
  1709.  
  1710.         Spacechar      Misc           Specify character to be substituted for
  1711.                                       spaces.
  1712.  
  1713.         Timestamp      File output    Add time and date fields to the output
  1714.                                       file
  1715.  
  1716.         Totals         FILES com-     Display directory totals in screen out-
  1717.                        mand           put
  1718.  
  1719.         Totext         FILES com-     Calculate totals by extension in screen
  1720.                        mand           output
  1721.  
  1722.         Userid         ID field       Specify user ID
  1723.  
  1724.         Username       ID field       Specify user name
  1725.  
  1726.  
  1727.          Table     ICF Options Summary               5 - 
  1728.  
  1729.  
  1730.  
  1731.  
  1732.     SEE ALSO
  1733.        Options Specification Methods
  1734.  
  1735.  
  1736.  
  1737.     2.7.2. OPTION SPECIFICATION METHODS
  1738.  
  1739.        Options can be specified to ICF using any combination of the following
  1740.        methods. The cumulative effect of using more than one technique in a
  1741.        given ICF run is then discussed.
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.                                                25                                          Page 
  1752.                                    ICF REFERENCE MANUAL
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.        2.7.2.1. COMMAND LINE
  1760.  
  1761.        Options can be included with the ICF command on the DOS (or OS/2) command
  1762.        line. The / or - character should be used as a prefix for the options, as
  1763.        shown in the following example:
  1764.  
  1765.        ICF STATUS /ALLDRIVES
  1766.  
  1767.        As many options that can fit on the command line may be included.
  1768.  
  1769.  
  1770.  
  1771.        2.7.2.2. ENVIRONMENT VARIABLE
  1772.  
  1773.        Options can be included in the special environment variable called, ap-
  1774.        propriately enough, "ICF". The DOS or OS/2 SET command is used to create
  1775.        the environment variable:
  1776.  
  1777.        SET ICF=/ALLDRIVES
  1778.  
  1779.        The ICF program will look for this variable and, if found, will read in
  1780.        all options specified.
  1781.  
  1782.  
  1783.  
  1784.        NOTE: Any options that require a value should use the : character to
  1785.        separate the value from the option, as in:
  1786.  
  1787.  
  1788.  
  1789.  
  1790.        SET ICF=/DRIVES:CD
  1791.  
  1792.        If the = character is used, the SET command will be invalid and result in
  1793.        an error message from the operating system.
  1794.  
  1795.  
  1796.  
  1797.        2.7.2.3. IN A FILE
  1798.  
  1799.        Finally, ICF options can be specified in a file called ICF.INI. If this
  1800.        file exists when ICF starts, options will be read in from the file and
  1801.        processed. Options should be specified one per line. A / or - prefix is
  1802.        neither required nor recommended.
  1803.  
  1804.        This file may be located in any of several places. ICF will search the
  1805.        following locations and cumulatively process any ICF.INI files it finds:
  1806.  
  1807.  
  1808.  
  1809.  
  1810.                                           Page 26
  1811.                                    ICF REFERENCE MANUAL
  1812.  
  1813.  
  1814.  
  1815.          ICF will search all LAN drives for a directory named /ICF. If found,
  1816.          any files called ICF.INI are processed. This is equivalent to
  1817.          *:\ICF\ICF.INI. Only first level directories are searched.
  1818.  
  1819.          A directory specified by the ICFINI environment variable
  1820.  
  1821.          The current directory of the local computer
  1822.  
  1823.  
  1824.  
  1825.  
  1826.        NOTE: Processing of ICF.INI files can be specifically controlled by
  1827.        using the ICFINI environment variable. Refer to Environment Variable
  1828.        "ICFINI" for more information.
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.        2.7.2.4. CUMULATIVE PROCESS EFFECTS
  1837.  
  1838.        Since options may be specified using a combination of the above methods,
  1839.        they can override other previously specified options. ICF processes op-
  1840.        tions in the following order:
  1841.  
  1842.        1. Any LAN-based ICF.INI files
  1843.        2. Any ICF.INI files specified by the ICFINI environment variable
  1844.        3. Options specified in the ICF environment variable
  1845.        4. Options specified on the command line
  1846.  
  1847.  
  1848.     SEE ALSO
  1849.        Environment Variables, Environment Variable "ICFINI"
  1850.  
  1851.  
  1852.     2.7.3. SHORTCUT OPTIONS
  1853.  
  1854.        Shortcut Options are options that do nothing more than specify other op-
  1855.        tions. They may be useful because they serve to automatically adjust ICF
  1856.        processing for certain tasks without specifying individual options re-
  1857.        peatedly.
  1858.  
  1859.        Following are the shortcut options available in ICF. Refer to the Options
  1860.        Reference section for details on each.
  1861.  
  1862.          /Floppy
  1863.          /Batch
  1864.          /Forceglobal
  1865.  
  1866.  
  1867.  
  1868.  
  1869.                                           Page 27
  1870.                                    ICF REFERENCE MANUAL
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.     2.7.4. SUMMARY OF OPTIONS BY GROUP
  1877.  
  1878.        Some of the major options can be conveniently discussed as a related
  1879.        group.
  1880.  
  1881.  
  1882.  
  1883.        2.7.4.1. DRIVE OPTIONS SUMMARY
  1884.  
  1885.        There are several options that control which disk drives are included in
  1886.        any "file scan operation". File scan operations are performed by the
  1887.        FILES, STATUS, and PROGRAMS command. Following is a summary of each op-
  1888.        tion. They are also listed in order of precedence (options at the start
  1889.        of the list take precedence over options at the end of the list)
  1890.  
  1891.  
  1892.      OPTION       DESCRIPTION
  1893.  
  1894.      Alldisks     Include all drives
  1895.  
  1896.      Skipdrives   Specify drives to skip
  1897.  
  1898.      Drives       Specify drives to include
  1899.  
  1900.      Landrives    Include LAN drives
  1901.  
  1902.      Landriveso   Include only LAN drives
  1903.  
  1904.  
  1905.          Table 6 - Drive options summary
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.        2.7.4.2. FILE SCAN OPTIONS
  1913.  
  1914.        As discussed in File Scan Operations on page 18,  there are a number of
  1915.        options that control how ICF searches for files. In addition to the drive
  1916.        options above,  others are summarized here
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.                                           Page 28
  1929.                                    ICF REFERENCE MANUAL
  1930.  
  1931.  
  1932.  
  1933.  
  1934.      OPTION            DESCRIPTION
  1935.  
  1936.      Alldisks          Include all drives in scan
  1937.  
  1938.      Descend           Descend directories
  1939.  
  1940.      Nodescend         Do not descend directories
  1941.  
  1942.      Attrs             Search for files with specific attributes
  1943.  
  1944.      Bigfiles          Search for only "big" files
  1945.  
  1946.      Bigfilesize       Set size of "big" files
  1947.  
  1948.      Colon             Specify that a colon is used for drive names
  1949.  
  1950.      Dosearch          Perform regular DOS wildcard processing
  1951.  
  1952.      Entiredisk        Search all directories on each drive
  1953.  
  1954.      Forceglobal       Specify both /Alldisks and /Entiredisk options
  1955.  
  1956.      Nofilesdefault    File spec must be specified on command line
  1957.  
  1958.      Normal            Do not include files with System, Readonly or
  1959.                        Hidden attributes
  1960.  
  1961.      Protected         Include only files with System, Readonly or Hidden
  1962.                        attributes
  1963.  
  1964.  
  1965.          Table 7 - File scan options summary
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.        2.7.4.3. TESTING OPTIONS
  1973.  
  1974.        There are several options intended for testing new implementations and
  1975.        installations of ICF. The administrator can use them to shorten time-con-
  1976.        suming commands. They should not be used in production environments as
  1977.        integrity is sacrificed since ICF output is truncated. The following ta-
  1978.        ble lists the options in this group. For more information refer to each
  1979.        option in the Option Reference section.
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.                                           Page 29
  1988.                                    ICF REFERENCE MANUAL
  1989.  
  1990.  
  1991.  
  1992.  
  1993.         OPTION                           DESCRIPTION
  1994.  
  1995.      Progslimit   Stop ICF execution when a specified number of programs
  1996.                   have been found
  1997.  
  1998.      Recslimit    Stop ICF execution when a specified number of records
  1999.                   have been output
  2000.  
  2001.      Recsnoitfy   Display a message every time a specified number of re-
  2002.                   cords are output
  2003.  
  2004.  
  2005.          Table   -                 8    Options for testing
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.     2.8. ENVIRONMENT VARIABLES
  2015.  
  2016.        ICF will look for and use any of several environment variables when it
  2017.        starts These variables modify the behavior of ICF during certain opera-
  2018.        tions.
  2019.  
  2020.        To specify an environment variable, the DOS (or OS/2) SET command must be
  2021.        used, either from the command line or a batch file. Refer to your operat-
  2022.        ing system manual for more in   mation.                                    for
  2023.  
  2024.        Following are the environment variables used by ICF.
  2025.  
  2026.  
  2027.      ENVIRONMENT                         DESCRIPTION
  2028.        VARIABLE
  2029.  
  2030.      ICF           Use this variable to specify additional options for ICF
  2031.                    to use.
  2032.  
  2033.      ICFINI        Use this variable to specify how ICF searches for
  2034.                    ICF.INI files
  2035.  
  2036.  
  2037.          Table     ICF environment variables               9 - 
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.                                                30                                          Page 
  2047.                                    ICF REFERENCE MANUAL
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.     2.8.1. ENVIRONMENT VARIABLE "ICF"
  2054.  
  2055.        The ICF environment variable may be used to specify additional options to
  2056.        ICF. Other methods for specifying options include using the command line
  2057.        and writing ICF.INI files. To create this variable, use the DOS or OS/2
  2058.        SET command.
  2059.  
  2060.     EXAMPLES
  2061.        SET ICF=/SMALLFILESIZE:100 /BIGFILESIZE:100000
  2062.  
  2063.        SET ICF=/BATCH /FLOPPY
  2064.  
  2065.  
  2066.  
  2067.        NOTE: When writing options that require a value, use the colon (':')
  2068.        character as a separator rather than the '=' character. The SET com-
  2069.        mand will not like multiple ='s in a single line (you'll get an error
  2070.        message).
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.     2.8.2. ICF ENVIRONMENT VARIABLE "ICFINI"
  2078.  
  2079.        The ICFINI environment variable controls how ICF searches for ICF.INI
  2080.        files. Following are the different values that can be assigned to ICFINI.
  2081.  
  2082.  
  2083.         VALUE                         DESCRIPTION
  2084.  
  2085.      NONE         Instructs ICF to avoid searching and reading any
  2086.                   ICF.INI files.
  2087.  
  2088.      NOLAN        Instructs ICF to avoid searching for ICF.INI files
  2089.                   on LAN drives.
  2090.  
  2091.      <pathname    If a '<' character is immediately followed by a
  2092.                   valid pathname, that path is searched for the
  2093.                   ICF.INI file.
  2094.  
  2095.  
  2096.          Table 10 - Values for ICFINI environment variable
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.                                           Page 31
  2106.                                    ICF REFERENCE MANUAL
  2107.  
  2108.  
  2109.  
  2110.     EXAMPLES
  2111.        SET ICFINI=<T:\DEFAULTS
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.     2.9. EXPERIMENTAL FEATURES
  2119.  
  2120.        A few features of ICF are experimental in nature and may be discontinued
  2121.        in future versions. By experimental we don't mean untested or buggy, as
  2122.        they undergo the same testing as other parts of the program. It does im-
  2123.        ply that their inclusion in future releases depends on their reported
  2124.        usefulness to our customers. If a command or option is experimental it
  2125.        will be indicated in the manual in the appropriate reference section.
  2126.  
  2127.     SEE ALSO
  2128.        Totext Option, Allext Option
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.     2.10. HINTS
  2135.  
  2136.        Following are some hints at performing tasks using ICF.
  2137.  
  2138.        SENDING OUTPUT FILES TO A LAN DRIVE
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.        Use the /Filename option to assign a unique name to each output file. For
  2145.        example:
  2146.  
  2147.        ICF STATUS /FILENAME=$COMPID /ASCII
  2148.  
  2149.        would analyze the computer configuration and output the data to a file
  2150.        called xxxxxxx.ASC in the Ascii delimited format. The "xxxxxxxx" is re-
  2151.        placed with the first 8 characters from the Computer ID, assuming one is
  2152.        specified by the /Computerid Option.
  2153.  
  2154.        Use the /ID option to assign each record to the configuration it belongs
  2155.        to. For example:
  2156.  
  2157.        ICF PROGRAMS /ID /DBASE /APPEND
  2158.           would search for and identify programs/software on all drives, and
  2159.           each output record written would include a field specifying the
  2160.           computer ID (assuming one was given by the /Computerid option).
  2161.  
  2162.  
  2163.  
  2164.                                           Page 32
  2165.                                    ICF REFERENCE MANUAL
  2166.  
  2167.  
  2168.  
  2169.        FINDING A FILE YOU LOST
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.        Use the FILES command, possibly with the /Landrives option to include re-
  2176.        mote drives in the search. For example:
  2177.  
  2178.        ICF FILES BUDGET /LANDRIVES
  2179.           will search for all files that have "BUDGET" anywhere in the name
  2180.           (DOS equivalent would be "*BUDGET*.*"), and can have any exten-
  2181.           sion, on all drives, including remote drives.
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.     2.11. ICF INPUT FILES
  2189.  
  2190.        Input files are used by ICF to provide data for recognizing programs and
  2191.        microchannel boards. When the PROGRAMS or STATUS command is used, ICF
  2192.        first looks for these files. If found, a small subset of data is read in
  2193.        from the files in order to provide lookup capabilities when collecting
  2194.        configuration data.
  2195.  
  2196.          For programs, ICF uses files named ICFPROGn.DBF.
  2197.  
  2198.          For microchannel boards, ICF uses files named ICFMCAn.DBF.
  2199.  
  2200.  
  2201.        The "n" is a number from 1 to 9.  When files are scanned for recognizable
  2202.        software, ICF attempts to read input data from ICFPROG1, then ICFPROG2,
  2203.        ICFPROG3, etc., up to ICFPROG9. Any files not found are simply skipped.
  2204.        The same processing occurs with the ICFMCAn.DBF files. This approach al-
  2205.        lows you to add new software programs and boards in one of two ways:
  2206.  
  2207.          New files can be added by simply using a new file name for the input
  2208.          file.
  2209.  
  2210.          Records can be added to an existing input file.
  2211.  
  2212.  
  2213.        The first method permits you to use new versions of input files when we
  2214.        make them available without having to worry about "re-applying" your own
  2215.        custom data to the file.  To create a new file, use any Dbase-compatible
  2216.        database program to create a new file with the same structure as the one
  2217.        shipped with ICF, and then add new records.
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.                                           Page 33
  2224.                                    ICF REFERENCE MANUAL
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.        NOTE: It is imperative that the exact structure of input files is pre-
  2232.        served.
  2233.  
  2234.  
  2235.  
  2236.  
  2237.        To verify that ICF is indeed processing input files, view the messages
  2238.        ICF displays when running. At the start of processing ICF will read the
  2239.        input files and give status messages showing how many input files and re-
  2240.        cords were read.
  2241.  
  2242.  
  2243.     2.11.1. PROGRAM INPUT FILES
  2244.  
  2245.        The structure of program input files is shown below:
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.                                           Page 34
  2283.                                    ICF REFERENCE MANUAL
  2284.  
  2285.  
  2286.  
  2287.  
  2288.          FIELD    FIELD NAME         LENGTH                               DATA                      DESCRIPTION
  2289.          NUMBER                TYPE
  2290.  
  2291.          1      Prodno               5                               N             Reserved for future use.
  2292.  
  2293.          2      Progname             15                               C             The file name of the program.
  2294.  
  2295.          3      Version              8                               C             The version number of the program.
  2296.                                              If this field has a value it will be
  2297.                                              appended to the description when re-
  2298.                                              corded.
  2299.  
  2300.          4      Size           N             The size of the program file.
  2301.  
  2302.          5      Crc32          N             Reserved for future use.
  2303.  
  2304.          6      Compmethod           1                               C             If this field has a "S" in it, the
  2305.                                              size of the found program file must
  2306.                                              match the size recorded in this
  2307.                                              file.
  2308.  
  2309.          7      Dirmethod            1                               C             Reserved for future use.
  2310.  
  2311.          8      Progtype             1                               C             Type of program
  2312.  
  2313.          9      Dirbein              30                               C             Reserved for future use.
  2314.  
  2315.          10     Dirnobein      C     30      Reserved for future use.
  2316.  
  2317.          11     Descrip        C     60      Description of program
  2318.  
  2319.          12     Runcode              1                               C             Reserved for future use.
  2320.  
  2321.          13     Progid         N             Reserved for future use.
  2322.  
  2323.  
  2324.          Table 11 -  Structure of program input files
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.     2.11.2. MICROCHANNEL BOARD INPUT FILES
  2332.  
  2333.        The structure of microchannel board input files is shown below:
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.                                                35                                          Page 
  2342.                                    ICF REFERENCE MANUAL
  2343.  
  2344.  
  2345.  
  2346.  
  2347.         FIELD     FIELD    DATA  LENGTH              DESCRIPTION
  2348.         NUMBER    NAME     TYPE
  2349.  
  2350.         1      Id          C     4       The hex ID number of the board.
  2351.                                          This ID number is used in the nam-
  2352.                                          ing of the ADF option file that ac-
  2353.                                          companies every microchannel board.
  2354.  
  2355.         2      Descrip     C     100     The description of the board.
  2356.  
  2357.         3      Flag        C     1       Reserved for future use.
  2358.  
  2359.         4      Misc        C     10      Reserved for future use.
  2360.  
  2361.  
  2362.          Table    -                12   Structure of microchannel input files
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.     2.12. ICF OUTPUT FILES
  2372.  
  2373.  
  2374.  
  2375.     2.12.1. OUTPUT FILE NAMING
  2376.  
  2377.        ICF sends output to a file when one of the following options is speci-
  2378.        fied:
  2379.  
  2380.  
  2381.      OPTION OUTPUT FILE FORMAT
  2382.  
  2383.      Dbase  output is stored in Dbase format
  2384.  
  2385.      Lotus  output is stored in Lotus 1-2-3 format
  2386.  
  2387.      Ascii  output is stored in Ascii format
  2388.  
  2389.  
  2390.          Table 13 -  Output file options
  2391.  
  2392.  
  2393.  
  2394.  
  2395.        The name of the output file is normally a standard extension, which de-
  2396.        pends on which output file format is used, and a standard name, which de-
  2397.  
  2398.  
  2399.  
  2400.                                                36                                          Page 
  2401.                                    ICF REFERENCE MANUAL
  2402.  
  2403.  
  2404.  
  2405.        pends on the ICF command being performed. Below is a list of the standard
  2406.        extensions used. These cannot be changed:
  2407.  
  2408.  
  2409.      OPTION    STANDARD EXTENSION
  2410.  
  2411.      Dbase     .DBF
  2412.  
  2413.      Lotus     .WK1
  2414.  
  2415.      Ascii     .ASC
  2416.  
  2417.  
  2418.          Table 14 - Standard file extensions
  2419.  
  2420.  
  2421.  
  2422.        The standard names are shown below, controlled by what ICF command is
  2423.        performed (where .ext is one of the standard extensions):
  2424.  
  2425.  
  2426.                        STANDARD FILE NAME
  2427.      COMMAND
  2428.  
  2429.      STATUS or AUTO    ICFINV.ext
  2430.  
  2431.      FILES             ICFFILES.ext
  2432.  
  2433.      PROGRAMS          ICFPROG.ext
  2434.  
  2435.      DISKSPACE         ICFDSKSP.ext
  2436.  
  2437.  
  2438.          Table    -                15   Standard file names
  2439.  
  2440.  
  2441.  
  2442.        CHANGING THE FILE NAME
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.        The /Filename option can be used to change the standard file name as-
  2449.        signed to the output file. This may desired for any of the following rea-
  2450.        sons:
  2451.  
  2452.          It is advantageous to identify the file with the user identification.
  2453.  
  2454.          Output files are stored on a LAN (remote) drive.
  2455.  
  2456.  
  2457.  
  2458.  
  2459.                                                37                                          Page 
  2460.                                    ICF REFERENCE MANUAL
  2461.  
  2462.  
  2463.  
  2464.  
  2465.        Note that in the latter case, if the filename wasn't specified with the
  2466.        Filename option then each file would overwrite a previous one since it
  2467.        would have the same standard name.
  2468.  
  2469.     SEE ALSO
  2470.        Dbase Option, Ascii Option, Lotus Option, Outdir Option, Computerid
  2471.        Option, Userid Option, Username Option, Filename Option
  2472.  
  2473.  
  2474.     2.12.2. OUTPUT FILE STRUCTURES
  2475.  
  2476.        When output is directed to a file for an ICF command, the output file
  2477.        will have a different structure depending on the command. Following is a
  2478.        summary of the file structures. The first column shows the field name,
  2479.        the second column the data type, and the third column the length. Numeric
  2480.        fields have no decimal places unless otherwise indicated. The data types
  2481.        are:
  2482.  
  2483.  
  2484.       DATA   DESCRIPTION
  2485.       TYPE
  2486.  
  2487.         C    character
  2488.  
  2489.         D    date
  2490.  
  2491.         N    numeric
  2492.  
  2493.  
  2494.          Table    -                16   Field description data types
  2495.  
  2496.  
  2497.  
  2498.        Files created using the /Ascii option do not have a structure: the struc-
  2499.        tures given indicate the order of the fields output.
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.                                                38                                          Page 
  2519.                                    ICF REFERENCE MANUAL
  2520.  
  2521.  
  2522.  
  2523.  
  2524.                     DATA
  2525.      FIELD NAME            LENGTH                    TYPE
  2526.  
  2527.  
  2528.      FILES
  2529.      COMMAND
  2530.  
  2531.  
  2532.      Drive           C        3
  2533.  
  2534.      Dirname                 60                     C
  2535.  
  2536.      Filename        C        8
  2537.  
  2538.      Ext             C        3
  2539.  
  2540.      Attrs           C        6
  2541.  
  2542.      Size                    12                     N
  2543.  
  2544.      Date            D        8
  2545.  
  2546.      Time            C        6
  2547.  
  2548.      Server 6                30                     C
  2549.  
  2550.  
  2551.      STATUS
  2552.      COMMAND
  2553.  
  2554.  
  2555.      Id              N        6
  2556.  
  2557.      Value           C       150
  2558.  
  2559.      Desc 7                  30                     C
  2560.  
  2561.  
  2562.      PROGRAMS
  2563.      COMMAND
  2564.  
  2565.  
  2566.      Progno          N        6
  2567.  
  2568.  
  2569.                         
  2570.  
  2571.        6 Valid for special ICF LAN versions only
  2572.  
  2573.          This field only output if /Desc option given.       7
  2574.  
  2575.  
  2576.  
  2577.                                                39                                          Page 
  2578.                                    ICF REFERENCE MANUAL
  2579.  
  2580.  
  2581.  
  2582.  
  2583.      Progname        C       70
  2584.  
  2585.      Filename        C       15
  2586.  
  2587.      Drive           C        3
  2588.  
  2589.      Path            C       100
  2590.  
  2591.      Size            N       12
  2592.  
  2593.      Date            D        8
  2594.  
  2595.      Time            C        6
  2596.  
  2597.      Server 8        C       30
  2598.  
  2599.  
  2600.          Table 17 - Output file structures by command
  2601.  
  2602.  
  2603.  
  2604.        ADDITIONAL FIELDS
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.        Additional fields may be automatically added to each record if the /Id
  2611.        option or the /Timestamp option is specified. Refer to those options in
  2612.        the reference section for more information.
  2613.  
  2614.  
  2615.     SEE ALSO
  2616.        Status Command, Output File Structure, Id Option, Timestamp Option
  2617.  
  2618.  
  2619.     2.12.3. STATUS COMMAND OUTPUT FILE STRUCTURE
  2620.  
  2621.        The structure of the output file when the Status command is used to col-
  2622.        lect PC inventory information is shown below:
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.                         
  2631.  
  2632.        8 Valid for special ICF LAN versions only
  2633.  
  2634.  
  2635.  
  2636.                                           Page 40
  2637.                                    ICF REFERENCE MANUAL
  2638.  
  2639.  
  2640.  
  2641.  
  2642.       FIELD    DATA   LENGTH
  2643.        NAME    TYPE
  2644.  
  2645.      Id         N       6
  2646.  
  2647.      Value      C      150
  2648.  
  2649.      Desc       C          9             30
  2650.  
  2651.  
  2652.          Table    -                18   Output file structure for STATUS command
  2653.  
  2654.  
  2655.  
  2656.        The Id field holds a number used to identify the type of information in
  2657.        the record. For example, the operating system name and version are two
  2658.        different types of information and each has a unique Id assigned.
  2659.  
  2660.        The Value field contains the actual string representing the value of the
  2661.        data item being collected. Any numeric values are always converted to
  2662.        character format prior to storing them in this field.
  2663.  
  2664.        The Desc field is only included in the output file structure if the /Desc
  2665.        option is given. If specified, this field contains a description of the
  2666.        data item stored in the record.
  2667.  
  2668.        This methodology yields a uniform data structure for collecting disparate
  2669.        forms of data. If you write programs to read the files created by the
  2670.        STATUS command, you can easily read the file and simply use lookup tables
  2671.        to refer to what data each record contains. Following is a list of the
  2672.        different ID numbers assigned to each data item. Items followed by (#)
  2673.        have special notes given below:
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.                         
  2690.  
  2691.        9 this field only output if /Desc option given.
  2692.  
  2693.  
  2694.  
  2695.                                                41                                          Page 
  2696.                                    ICF REFERENCE MANUAL
  2697.  
  2698.  
  2699.  
  2700.  
  2701.                                                   DATA
  2702.                ID DESCRIPTION             ID #            NOTES                                                  TYPE
  2703.  
  2704.      Total expanded memory                       number                                            1
  2705.  
  2706.      Expanded memory page frame             2      hex
  2707.  
  2708.      Available expanded memory                   number                                            3
  2709.  
  2710.      Expanded memory version                     number                                            4
  2711.  
  2712.  
  2713.  
  2714.      Mouse type                                  string                                            5
  2715.  
  2716.      Mouse driver version                        number                                            6
  2717.  
  2718.      Mouse IRQ                                   number                                            7
  2719.  
  2720.  
  2721.  
  2722.      Total extended memory                       number                                            8
  2723.  
  2724.      Available memory                            number                                            9
  2725.  
  2726.      Used memory                                 number                                           10
  2727.  
  2728.      Reported memory                       11    number
  2729.  
  2730.  
  2731.  
  2732.      Video adapter                               string                                           12
  2733.  
  2734.      Video display                               string                                           13
  2735.  
  2736.      Video adapter name                    14    string
  2737.  
  2738.  
  2739.  
  2740.      Processor                             17    string
  2741.  
  2742.      CoProcessor                           18    string
  2743.  
  2744.  
  2745.  
  2746.      PC Model code                         19      hex
  2747.  
  2748.      PC Model name                         20    string
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.                                           Page 42
  2755.                                    ICF REFERENCE MANUAL
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.      Number of serial ports                21    number
  2763.  
  2764.      Number of parallel ports              22    number
  2765.  
  2766.      Number of floppy drives               23    number
  2767.  
  2768.  
  2769.  
  2770.      Verify mode                           24    string
  2771.  
  2772.      Drives                                25    string
  2773.  
  2774.      Operating System version              26    string
  2775.  
  2776.      Bios                                  27    string
  2777.  
  2778.  
  2779.  
  2780.      Username ID                           28    string
  2781.  
  2782.      Computer ID                           29    string
  2783.  
  2784.      Company name                          30    string
  2785.  
  2786.  
  2787.  
  2788.      DOS Print TSR                         31    string
  2789.  
  2790.      DOS Append TSR                        32    string
  2791.  
  2792.      Program                               33    packed     1
  2793.  
  2794.      Microchannel board                    34    packed     2
  2795.  
  2796.      Logical disk information              35    packed     3
  2797.  
  2798.  
  2799.  
  2800.      Environment variable                  54    string
  2801.  
  2802.  
  2803.  
  2804.      Printer ID                            55    string
  2805.  
  2806.      Modem ID                              56    string
  2807.  
  2808.      Monitor ID                            57    string
  2809.  
  2810.  
  2811.  
  2812.  
  2813.                                           Page 43
  2814.                                    ICF REFERENCE MANUAL
  2815.  
  2816.  
  2817.  
  2818.  
  2819.      User ID                               58    string
  2820.  
  2821.      Misc ID 1                             59    string
  2822.  
  2823.      Misc ID 2                             60    string
  2824.  
  2825.      Location                              68    string
  2826.  
  2827.  
  2828.  
  2829.      Bus type                              61    string
  2830.  
  2831.      Current date                          63     date
  2832.  
  2833.      Current time                          64    string
  2834.  
  2835.  
  2836.  
  2837.      Text file                             70    packed     4
  2838.  
  2839.      Notes 1                               66    string
  2840.  
  2841.      Notes 2                               67    string
  2842.  
  2843.  
  2844.  
  2845.      Cmos floppy 1 type                   1001   string
  2846.  
  2847.      Cmos floppy 2 type                   1002   string
  2848.  
  2849.      Cmos hard drive 1 type               1003   number
  2850.  
  2851.      Cmos hard drive 2 type               1004   number
  2852.  
  2853.      Cmos base memory                     1005   number
  2854.  
  2855.      Cmos expanded memory                 1006   number
  2856.  
  2857.      Cmos math CoProcessor                1007   string
  2858.  
  2859.  
  2860.          Table 19 - STATUS command output field ID's
  2861.  
  2862.  
  2863.  
  2864.  
  2865.     NOTES
  2866.        Packed values - Some fields have values that are actually a concatenation
  2867.        of strings. The fields that use this method have a data type of "packed"
  2868.        and their contents are described below. Each string in a packed field is
  2869.  
  2870.  
  2871.  
  2872.                                           Page 44
  2873.                                    ICF REFERENCE MANUAL
  2874.  
  2875.  
  2876.  
  2877.        separated from the next by a "token character". By default this character
  2878.        is the caret "^".
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.                                           Page 45
  2932.                                    ICF REFERENCE MANUAL
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.       NAME OF PACKED  SEQUENCE
  2939.           FIELD        NUMBER             DESCRIPTION
  2940.  
  2941.      Programs             1     Product number - number ob-
  2942.      (note 1)                   tained from the ICF input file
  2943.                                 (if one was present) It will be
  2944.                                 zero otherwise. This number
  2945.                                 makes it easy to identify com-
  2946.                                 mon software.
  2947.  
  2948.                           2     Path and file name
  2949.  
  2950.                           3     Program description - comes
  2951.                                 from the ICF input file.
  2952.  
  2953.                           4     File size
  2954.  
  2955.                           5     File date
  2956.  
  2957.                           6     File time
  2958.  
  2959.  
  2960.  
  2961.      Microchannel         1     Product number - number ob-
  2962.      Boards                     tained from the ICF input file
  2963.      (note 2)                   (if one was present) It will be
  2964.                                 zero otherwise. This number
  2965.                                 makes it easy to identify com-
  2966.                                 mon software.
  2967.  
  2968.                           2     Microchannel ID code - read
  2969.                                 from the board itself
  2970.  
  2971.                           3     Board description - comes from
  2972.                                 the ICF input file.
  2973.  
  2974.  
  2975.  
  2976.      Logical Drive        1     Drive number (3=C, 4=D, etc...)
  2977.      Information
  2978.      (note 3)
  2979.  
  2980.                           2     Total disk space
  2981.  
  2982.                           3     Free disk space
  2983.  
  2984.                           4     Used disk space
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.                                                46                                          Page 
  2991.                                    ICF REFERENCE MANUAL
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.      Text Files           1     File name
  2999.      (note 4)
  3000.  
  3001.                           2     File path
  3002.  
  3003.                           3     Text of line
  3004.  
  3005.  
  3006.          Table    -                20   Packed field values
  3007.  
  3008.  
  3009.  
  3010.  
  3011.     SEE ALSO
  3012.        Status Command, Desc Option
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.                                           Page 47
  3050.                                    ICF REFERENCE MANUAL
  3051.  
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.                                 ____________________                                3. COMMAND REFERENCE
  3058.  
  3059.  
  3060.                                 ____________________                                                    
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.     3.1. ASK COMMAND
  3072.  
  3073.     SYNTAX
  3074.        ICF ASK
  3075.  
  3076.     DESCRIPTION
  3077.        This command presents a screen in which you can enter stand-alone or
  3078.        physical equipment to automatically be included in the configuration
  3079.        analysis whenever the STATUS command is performed.
  3080.  
  3081.        Unlike the /Ask option, using this command simply presents a data entry
  3082.        screen for entering information and, upon exiting, immediately exits ICF
  3083.        with no configuration run being performed.
  3084.  
  3085.     SEE ALSO
  3086.        Collecting Physical Config Data, Ask Option
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.     3.2. AUTO COMMAND
  3093.  
  3094.     SYNTAX
  3095.        ICF AUTO <auto parameters> <options>
  3096.  
  3097.     DESCRIPTION
  3098.        This command is used to check if any changes were made to a PC's configu-
  3099.        ration since the last time configuration data was collected. If changes
  3100.        are detected, ICF automatically performs the STATUS command which will
  3101.        result in a new data collection.
  3102.  
  3103.        This process has been carefully designed to permit ICF to quickly perform
  3104.        a "pre-check" of a computer configuration to determine if it's practical
  3105.  
  3106.  
  3107.  
  3108.                                           Page 48
  3109.                                    ICF REFERENCE MANUAL
  3110.  
  3111.  
  3112.  
  3113.        to do a full configuration run. Since a full run could take time
  3114.        (particularly if software packages are inventoried), this feature is ex-
  3115.        tremely powerful. It enables you to have ICF run every day on each com-
  3116.        puter, and it will run very quickly unless it determines a full run is
  3117.        required.
  3118.  
  3119.        Following is a discussion of the events that take place when ICF is used
  3120.        with the AUTO command. Refer to other mentioned topics and options for
  3121.        details.
  3122.  
  3123.        1.     If the /Force option is specified, further checking is not per-
  3124.          formed and a configuration run is performed.
  3125.  
  3126.        2.     ICF looks for a file on a local hard disk called
  3127.          C:\AUTORUN.DAT. This file contains data saved during the last con-
  3128.          figuration run. If the file is not found, ICF does a new run.
  3129.  
  3130.          This file may have different names and/or locations, depending on
  3131.          whether the /Autorunfile option is used. In addition, if the /Hide
  3132.          op     was previ           tion          ously used then the file may be marked as Hidden,
  3133.          System, and Readonly.
  3134.  
  3135.        3.     If the /Autorun option is not specified, ICF will use all the
  3136.          criteria for com   ing the current configuration with the previous                         par
  3137.          one. As soon as a change is detected ICF stops checking and starts a
  3138.          configuration run. Following is the criteria that is checked:
  3139.  
  3140.  
  3141.  
  3142.        LONG   SHORT
  3143.        CODE    CODE               DESCRIPTION
  3144.  
  3145.       CMOS      C    Cmos information
  3146.  
  3147.       BIOS      B    Bios data
  3148.  
  3149.       SPACE     S    Amount of free disk space on drives
  3150.  
  3151.       MAIN      M    General information including memory,
  3152.                      processor
  3153.  
  3154.       DIRS      D    Number of root-level directories
  3155.  
  3156.       DAYS      Y    Number of days since last run
  3157.  
  3158.       IDS       I    ID information entered manually
  3159.  
  3160.       MCA       A    Installed microchannel boards
  3161.  
  3162.  
  3163.               Table 21 - Autorun criteria
  3164.  
  3165.  
  3166.  
  3167.                                                49                                          Page 
  3168.                                    ICF REFERENCE MANUAL
  3169.  
  3170.  
  3171.  
  3172.          For more information on these refer to Autorun Option on page 64.
  3173.  
  3174.        4.     If the /Autorun option is specified, it specifies to ICF the
  3175.          criteria that should be checked. This would likely be a subset of
  3176.          those shown above.
  3177.  
  3178.  
  3179.        When configuration data is being collected, the /Escape option may be
  3180.        used by the user to abort the run. This is useful if the user needs to
  3181.        get on with pressing work and cannot wait for ICF to finish. If /Escape
  3182.        is not specified then the user cannot abort (the /Break option controls
  3183.        Ctrl-Break behavior).
  3184.  
  3185.     EXAMPLES
  3186.        ICF AUTO /DBASE /FILENAME=$TEMP
  3187.           ICF will read the C:\AUTORUN.DAT file and determine if anything
  3188.           has changed in the configuration since the last time ICF performed
  3189.           a STATUS command.  If nothing substantial has changed, it exits to
  3190.           the operating system. Otherwise, a new STATUS command is performed
  3191.           and the C:\AUTORUN.DAT file is updated to reflect the changes. The
  3192.           configuration is saved to a Dbase file and the file name will be
  3193.           uniquely numbered.
  3194.  
  3195.        ICF AUTO DAYS /DBASE /FILENAME=$TEMP /DAYS=15
  3196.           Same as above except ICF will not check all the normal AUTO crite-
  3197.           ria. Since the DAYS parameter was specified, only that is checked.
  3198.           The /Days option indicates that at least 15 days would need to
  3199.           have passed in order to run another STATUS.
  3200.  
  3201.        ICF AUTO /ASCII /FILENAME=$USERID /HIDE /AUTORUNFILE=S:\AR.DAT
  3202.           Since no AUTO parameters were specified, all criteria is evaluated
  3203.           to determine if a STATUS command should be performed. The file
  3204.           used to provide previous configuration data is called S:\AR.DAT
  3205.           and has the system, readonly, and hidden attributes set by ICF to
  3206.           guard against modifications to the file. If a STATUS is run the
  3207.           data is saved to an Ascii file with the same name as the userid of
  3208.           the user.
  3209.  
  3210.  
  3211.     SEE ALSO
  3212.        Autodays Option, Autoid Option, Autorunfile Option, Autospace Option,
  3213.        Autorun Option, Force Option, Hide Option, Escape Option, Break Option
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.     3.3. DISKSPACE COMMAND
  3220.  
  3221.     SYNTAX
  3222.        ICF DISKSPACE <drive letters> <options>
  3223.  
  3224.  
  3225.  
  3226.                                           Page 50
  3227.                                    ICF REFERENCE MANUAL
  3228.  
  3229.  
  3230.  
  3231.  
  3232.     DESCRIPTION
  3233.        This command instructs ICF to report disk space statistics on all local
  3234.        drives in the system. LAN (remote) drives are included if the /Landrives
  3235.        or /Landrives option is specified. If output is sent to the screen, a re-
  3236.        port similar to the example shown below is produced:
  3237.  
  3238.  
  3239.     ===============================================================================
  3240.     DISK SPACE REPORT
  3241.     -------------------------------------------------------------------------------
  3242.     DRIVE     TOTAL SPACE         USED SPACE -- (pct)   FREE SPACE -- (pct)
  3243.  
  3244.     C:         33,296,384         28,772,352   (86.4)         4,524,032   (13.6)
  3245.     D:         88,485,888         88,244,224   (99.7)           241,664   (0.3)
  3246.     E:         88,485,888         71,061,504   (80.3)        17,424,384   (19.7)
  3247.     -------------------------------------------------------------------------------
  3248.     LOCAL     210,268,160        188,078,080   (89.4%)       22,190,080   (10.6%)
  3249.  
  3250.  
  3251.        Output will be directed to a file if one of the file output options is
  3252.        specified: Dbase, Ascii, and Lotus.
  3253.  
  3254.     EXAMPLES
  3255.        ICF DISKSPACE C D
  3256.           A diskspace report is produced for drives C: and D:
  3257.  
  3258.        ICF DISKSPACE /LOTUS /OVERWRITE
  3259.           Disk space statistics is generated for all local drives and the
  3260.           output is sent to a .WK1 worksheet named ICFDSKSP.WK1. If the file
  3261.           exists it is overwritten.
  3262.  
  3263.        ICF DISKSPACE /LOTUS /OVERWRITE /LANDRIVESO
  3264.           Same as above except only LAN drives are processed.
  3265.  
  3266.  
  3267.     SEE ALSO
  3268.        Overview, Landrives Option, Landriveso Option, Dbase Option, Lotus
  3269.        Option, Ascii Option
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.     3.4. FILES COMMAND
  3276.  
  3277.     SYNTAX
  3278.        ICF FILES <filespec1> <filespec2> <filespecn...> /<option1>...
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.                                           Page 51
  3286.                                    ICF REFERENCE MANUAL
  3287.  
  3288.  
  3289.  
  3290.     DESCRIPTION
  3291.        This command searches for files on the computer's disk drives. By default
  3292.        all local drives are searched. For example,
  3293.  
  3294.        ICF FILES
  3295.  
  3296.        will search for all files in all directories on all local drives. If
  3297.        either the /Dbase, /Ascii, or /Lotus options is given then output is di-
  3298.        rected to a file. Refer to ICF Output File Structures on page 38 for in-
  3299.        formation on the file structure. If none of the above options are used, a
  3300.        directory listing is displayed on the screen.
  3301.  
  3302.        There are many options and important rules ICF follows when searching for
  3303.        files, and some of them are different from normal DOS conventions. Refer
  3304.        to File Scan Operations on page 18 for details.
  3305.  
  3306.     EXAMPLES
  3307.        ICF FILES
  3308.           A directory of all files on all local drives, including all direc-
  3309.           tories, will be displayed on the screen.
  3310.  
  3311.        ICF FILES D
  3312.           Same as above but only Drive D: is searched.
  3313.  
  3314.        ICF FILES BAK
  3315.           Searches all local drives and all directories for files with the
  3316.           text "BAK" anywhere in the name. Unlike normal DOS file searching,
  3317.           the following files would be displayed if they existed:
  3318.  
  3319.               TEST.BAK
  3320.               BAKFILE.DAT
  3321.               NEWBAK4
  3322.  
  3323.        ICF FILES /LANDRIVESO /ASCII /OVERWRITE
  3324.           All files on LAN drives only would be searched and output to an
  3325.           Ascii file called ICFFILES.DBF. If the file already exists it is
  3326.           overwritten.
  3327.  
  3328.        ICF FILES \PAYROLL /LANDRIVES /DBASE /FILENAME
  3329.           All files in all directories starting with the \PAYROLL directory
  3330.           are searched, and LAN drives are included. Output is sent to a
  3331.           Dbase file with the name ICFnnnnn.DBF, where nnnnn is a number
  3332.           generated by ICF to ensure the file does not conflict with other
  3333.           existing files.
  3334.  
  3335.  
  3336.     SEE ALSO
  3337.        File Scan Operations
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.                                           Page 52
  3345.                                    ICF REFERENCE MANUAL
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.     3.5. HELP COMMAND
  3355.  
  3356.     SYNTAX
  3357.        ICF HELP <help topic text>
  3358.  
  3359.        This command instructs ICF to display text related to the topic specified
  3360.        on the command line. If no text is included after the HELP command, a
  3361.        list of all available topics is listed. If text is included, only those
  3362.        topics that contain the text are displayed, along with the full help text
  3363.        for each topic.
  3364.  
  3365.        The files ICFHELP1.DBF and ICFHELP2.DBF must be present for this command
  3366.        to function. ICF expects to find them in the current directory, unless
  3367.        the /Indir option is used.
  3368.  
  3369.        To include topic text with embedded spaces, use the "_" (underscore)
  3370.        character in place of each space. ICF will translate these to spaces
  3371.        automatically. If for some reason you wish to use a different character,
  3372.        use the /Spacechar option.
  3373.  
  3374.     SEE ALSO
  3375.        Commands Summary, Indir Option, Spacechar Option
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.     3.6. PROGRAMS COMMAND
  3382.  
  3383.     SYNTAX
  3384.        ICF PROGRAMS <filespec1> <filespec2> <filespecn...> /<option1>...
  3385.  
  3386.        This command searches for "recognized" programs on the computer. A pro-
  3387.        gram is identified by comparing file information with that stored in the
  3388.        ICFPROG1.DBF file. While ICF provides no built-in capability for adding
  3389.        additional program records to the file, since it is a standard Dbase file
  3390.        it can be edited by a large number of standard packages.
  3391.  
  3392.        Typing just the PROGRAMS command will search all directories on all local
  3393.        drives for software. Many options control the specific search behavior -
  3394.        refer to File Scan Operations on page 18 for details.
  3395.  
  3396.        To explicitly narrow the search to specific drives and/or directories,
  3397.        include the path specification after the PROGRAMS command, and before any
  3398.        options, as shown in the example:
  3399.  
  3400.  
  3401.  
  3402.  
  3403.                                           Page 53
  3404.                                    ICF REFERENCE MANUAL
  3405.  
  3406.  
  3407.  
  3408.        ICF PROGRAMS
  3409.           Searches only drive D for programs
  3410.  
  3411.        If no output file option is specified (/Dbase, /Ascii, or /Lotus), then
  3412.        the output is sent to the screen showing what programs have been found
  3413.        and their location, similar to the example shown below:
  3414.  
  3415.  
  3416.     ===============================================================================
  3417.     INVENTORY OF PROGRAMS FOUND ON SELECTED DRIVES/DIRECTORIES
  3418.     -------------------------------------------------------------------------------
  3419.       1. Dos Program ........................ C:\COMMAND.COM
  3420.       2. Ibm Dos ............................ C:\IBMDOS.COM
  3421.       3. Ms-dos ............................. C:\DOS\FDISK.EXE
  3422.       4. Os/2 Program ....................... C:\OS2\SPOOL.EXE
  3423.       5. Magellan 1.0 ....................... D:\MAG\MAGINDEX.EXE
  3424.       6. Hyperaccess/5 ...................... D:\HA\HP5DOS.EXE
  3425.       7. Tapcis ............................. D:\TAP\TAPCIS.EXE
  3426.       8. Paint Brush Program ................ D:\WINDOWS\PBRUSH.EXE
  3427.       9. Managing Your Money Program ........ D:\MYM8\MYM.EXE
  3428.      10. Microsoft C Compiler ............... D:\C600\BIN\C1L.EXE
  3429.      11. Microsoft Windows .................. D:\WINDOWS\SYSTEM\KERNEL.EXE
  3430.  
  3431.  
  3432.         If one of the output files is used, the data is stored in the requested
  3433.        format. Refer to Output File Structures on page 38 for details on what
  3434.        the file structure look like.
  3435.  
  3436.        This command is also performed automatically as part of the STATUS com-
  3437.        mand (unless the /Nostatus option is used to exclude it).
  3438.  
  3439.     SEE ALSO
  3440.        File Scan Operations, Status Command
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.     3.7. STATUS COMMAND
  3447.  
  3448.     SYNTAX
  3449.        Status <status subject list>
  3450.  
  3451.     DESCRIPTION
  3452.        This command collects information describing the configuration of the PC
  3453.        and either displays the information on the screen or sends it to an out-
  3454.        put file. If no filetype option is given then the configuration is dis-
  3455.        played on the screen, and may be redirected to a text file or printer us-
  3456.        ing DOS redirection techniques. A sample report is shown below:
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.                                           Page 54
  3463.                                    ICF REFERENCE MANUAL
  3464.  
  3465.  
  3466.  
  3467.     ===============================================================================
  3468.                                     ID INFORMATION
  3469.     -------------------------------------------------------------------------------
  3470.                                 User ID :  SMITH
  3471.                             Computer ID :  1232,1321
  3472.                                Location :  ROOM 128
  3473.  
  3474.     ===============================================================================
  3475.                                    MAIN INFORMATION
  3476.     -------------------------------------------------------------------------------
  3477.                                    Date :  02/26/92
  3478.                                    Time :  21:17:58
  3479.                               Processor :  386
  3480.                      Coprocessor (Bios) :  NO
  3481.                           PC Model code :  01FC
  3482.                           PC Model name :  PC-AT 3x9 or clone
  3483.                            Serial ports :  2
  3484.                           Printer ports :  1
  3485.                           Floppy drives :  2
  3486.                            Local drives :  ABCDE
  3487.                              OS version :  DOS  5.0
  3488.                               Bios date :  04/09/90
  3489.                                Bus type :  ISA
  3490.  
  3491.     ===============================================================================
  3492.                                    VIDEO INFORMATION
  3493.     -------------------------------------------------------------------------------
  3494.                           Video adapter :  1
  3495.                  Active video subsystem :  VGA with Analog Color Monitor
  3496.                Inactive video subsystem :  No Display
  3497.  
  3498.     ===============================================================================
  3499.                                    CMOS INFORMATION
  3500.     -------------------------------------------------------------------------------
  3501.                                Floppy 1 :  3.5 1.44M
  3502.                                Floppy 2 :  5.25 1.2M
  3503.                       Hard drive 1 type :  47
  3504.                             Base Memory :  640
  3505.                         Expanded Memory :  7168
  3506.  
  3507.     ===============================================================================
  3508.                                   MEMORY INFORMATION
  3509.     -------------------------------------------------------------------------------
  3510.                         Extended memory :  2000
  3511.  
  3512.     ===============================================================================
  3513.                                   PROGRAM INFORMATION
  3514.     -------------------------------------------------------------------------------
  3515.       1. Dos Program ........................ C:\COMMAND.COM
  3516.       2. Ibm Dos ............................ C:\IBMDOS.COM
  3517.       3. Dos Program ........................ C:\DOS\COMMAND.COM
  3518.  
  3519.  
  3520.  
  3521.                                           Page 55
  3522.                                    ICF REFERENCE MANUAL
  3523.  
  3524.  
  3525.  
  3526.       4. Os/2 Program ....................... C:\OS2\SPOOL.EXE
  3527.       5. Magellan 1.0 ....................... D:\MAG\MAGINDEX.EXE
  3528.       6. Hyperaccess/5 ...................... D:\HA\HP5DOS.EXE
  3529.       7. Paint Brush Program ................ D:\WINDOWS\PBRUSH.EXE
  3530.       8. Managing Your Money Program ........ D:\MYM8\MYM.EXE
  3531.       9. Microsoft C Compiler ............... D:\C600\BINP\C1L.EXE
  3532.      10. Microsoft Windows .................. D:\WINDOWS\SYSTEM\KERNEL.EXE
  3533.  
  3534.  
  3535.     ===============================================================================
  3536.                            ENVIRONMENT VARIABLE INFORMATION
  3537.     -------------------------------------------------------------------------------
  3538.     COMSPEC=C:\DOS\COMMAND.COM
  3539.     PROMPT=$p$g
  3540.     PATH=C:\DOS
  3541.     TEMP=C:\DOS
  3542.  
  3543.  
  3544.     ===============================================================================
  3545.                                    DRIVE INFORMATION
  3546.     -------------------------------------------------------------------------------
  3547.     C:         33,296,384         28,772,352   (0.0)         4,524,032   (0.0)
  3548.     D:         88,485,888         88,244,224   (0.0)           241,664   (0.0)
  3549.     E:         88,485,888         71,065,600   (0.0)        17,420,288   (0.0)
  3550.  
  3551.  
  3552.     ===============================================================================
  3553.                               DOS EXTENSIONS INFORMATION
  3554.     -------------------------------------------------------------------------------
  3555.     SHARE
  3556.     Network
  3557.     NLSFUNC
  3558.     HIMEM.SYS
  3559.     KEYB.COM
  3560.  
  3561.  
  3562.     ===============================================================================
  3563.                          SYSTEM CONFIGURATION FILE INFORMATION
  3564.     -------------------------------------------------------------------------------
  3565.  
  3566.     ******** [ CONFIG.SYS File ] ********
  3567.       1. rem DEVICE=C:\DOS\SETVER.EXE
  3568.       2. DEVICE=C:\DOS\HIMEM.SYS
  3569.       3. rem DEVICE=C:\DOS\EMM386.EXE
  3570.       4. rem DOS=HIGH
  3571.       5. FILES=60
  3572.       6. BUFFERS=45
  3573.       7. SHELL=C:\DOS\COMMAND.COM C:\DOS\  /p
  3574.  
  3575.     ******** [ AUTOEXEC.BAT File ] ********
  3576.       1. @ECHO OFF
  3577.  
  3578.  
  3579.  
  3580.                                           Page 56
  3581.                                    ICF REFERENCE MANUAL
  3582.  
  3583.  
  3584.  
  3585.       2. PROMPT $p$g
  3586.       3. PATH C:\DOS
  3587.       4. SET TEMP=C:\DOS
  3588.  
  3589.  
  3590.        If the /Dbase, /Lotus, or /Ascii options are given then the output is di-
  3591.        rected to a file. The format of the output file structure is given in
  3592.        Status Command Output File Structure on page 40.
  3593.  
  3594.     EXAMPLES
  3595.        ICF STATUS
  3596.           Displays on the screen the configuration of the PC.
  3597.  
  3598.        ICF STATUS /DBASE
  3599.           Redirects the configuration data to an output file in the Dbase
  3600.           format.
  3601.  
  3602.        ICF STATUS MCA PRO
  3603.           Performs the status command but only collects information concern-
  3604.           ing microchannel boards (MCA) and programs (PRO). The list of all
  3605.           categories that can be included as parameters to STATUS is shown
  3606.           below:
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.                                           Page 57
  3640.                                    ICF REFERENCE MANUAL
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.          CODE  DESCRIPTION
  3647.  
  3648.          MCA   Microchannel
  3649.  
  3650.          MEM   Memory
  3651.  
  3652.          MOU   Mouse
  3653.  
  3654.          VIO   Video
  3655.  
  3656.          MAI   Main information
  3657.  
  3658.          PRO   Program (software) infor-
  3659.                mation
  3660.  
  3661.          LAN   LAN Information
  3662.  
  3663.          ENV   Environment variables
  3664.  
  3665.          IDI   Id information
  3666.  
  3667.          DSK   Disk information
  3668.  
  3669.          TXT   Text files (i.e.
  3670.                CONFIG.SYS, AUTOEXEC.BAT)
  3671.  
  3672.          CMO   Cmos information
  3673.  
  3674.          SUB   DOS TSR and Subsystem
  3675.                information
  3676.  
  3677.  
  3678.             Table 22 - Status command groups
  3679.  
  3680.  
  3681.  
  3682.  
  3683.     OPTIONS
  3684.        Many options can be used with the STATUS command. An especially useful
  3685.        one is the /Nostatus option, which means "don't collect information on
  3686.        specified categories of information". The categories are shown above and
  3687.        given as a parameter to the option, as shown in the following example:
  3688.  
  3689.        ICF STATUS /NOSTATUS=PRO
  3690.           This tells ICF to skip collecting information for programs, which
  3691.           can be useful since it bypasses what could be a timely disk scan.
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.                                           Page 58
  3699.                                    ICF REFERENCE MANUAL
  3700.  
  3701.  
  3702.  
  3703.     SEE ALSO
  3704.        Status Command Output File Structure, Nostatus Option
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739.  
  3740.  
  3741.  
  3742.  
  3743.  
  3744.  
  3745.  
  3746.  
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.                                           Page 59
  3758.                                    ICF REFERENCE MANUAL
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.                                 ____________________                                4. OPTIONS REFERENCE
  3766.  
  3767.  
  3768.                                 ____________________                                                    
  3769.  
  3770.  
  3771.  
  3772.  
  3773.  
  3774.  
  3775.  
  3776.  
  3777.  
  3778.  
  3779.     4.1. ALLDISKS OPTION
  3780.  
  3781.     DESCRIPTION
  3782.        This option instructs ICF to include all drives in a file scan operation.
  3783.  
  3784.        This option may conflict with related options. The precedence order for
  3785.        ICF options that control what drives are included in a file scan opera-
  3786.        tion are covered in the "ICF Drive Options Summary" topic.
  3787.  
  3788.     SEE ALSO
  3789.        Drive Options Summary, File Scan Operations, Drives Option, Skipdrives
  3790.        Option, Landrives Option, Landriveso Option
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.     4.2. ALLEXT OPTION
  3797.  
  3798.     DESCRIPTION
  3799.        This option specifies that all extensions should be totaled when the
  3800.        /Totext option is given.
  3801.  
  3802.  
  3803.  
  3804.        NOTE: This option is experimental and may be discontinued in future
  3805.        versions of ICF.
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.     SEE ALSO
  3812.        Experimental Features, Totext Option
  3813.  
  3814.  
  3815.  
  3816.                                           Page 60
  3817.                                    ICF REFERENCE MANUAL
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.     4.3. APPEND OPTION
  3827.  
  3828.     DESCRIPTION
  3829.        If a data file is specified (with the DBASE, ASCII, or LOTUS options) and
  3830.        a file already exists with the same name, use of this option will result
  3831.        in data being appended to the existing file. If this option is used and
  3832.        the file doesn't exist, it is created normally.
  3833.  
  3834.  
  3835.  
  3836.  
  3837.        NOTE:  APPEND is not supported for files created with the /Lotus op-
  3838.        tion.
  3839.  
  3840.  
  3841.  
  3842.  
  3843.  
  3844.     SEE ALSO
  3845.        Overwrite Option, Dbase Option, Lotus Option, Ascii Option
  3846.  
  3847.  
  3848.  
  3849.  
  3850.  
  3851.  
  3852.  
  3853.     4.4. ASCII OPTION
  3854.  
  3855.     DESCRIPTION
  3856.        This option instructs ICF to save data in an Ascii file. The file will be
  3857.        comma delimited with quotes used to surround strings.
  3858.  
  3859.        The extension applied to Ascii files is always .ASC. The name of the file
  3860.        depends on the command used and if the /Filename option is specified.
  3861.  
  3862.     SEE ALSO
  3863.        Dbase Option, Lotus Option, Output File Naming
  3864.  
  3865.  
  3866.  
  3867.  
  3868.  
  3869.  
  3870.  
  3871.  
  3872.  
  3873.  
  3874.  
  3875.                                           Page 61
  3876.                                    ICF REFERENCE MANUAL
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.     4.5. ASK OPTION
  3886.  
  3887.     DESCRIPTION
  3888.        This option instructs ICF to present a data entry screen where physical
  3889.        equipment and user identification data can be entered. This screen is
  3890.        presented immediately prior to performing a configuration collection when
  3891.        the STATUS or AUTO commands are used.
  3892.  
  3893.  
  3894.  
  3895.        NOTE:  Any data or changes entered WILL NOT be saved unless the
  3896.        /Saveids option is specified.
  3897.  
  3898.  
  3899.  
  3900.  
  3901.        By using the ASK command instead, the same data entry screen is presented
  3902.        but a STATUS command is not performed. In this case /Saveids does not
  3903.        have to be specified because all entered information is automatically
  3904.        saved.
  3905.  
  3906.     SEE ALSO
  3907.        Collecting Physical Config Data, Saveids Option, Ask Command.
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.     4.6. ATTRS OPTION
  3914.  
  3915.     SYNTAX
  3916.        /Attrs=<file attribute codes>
  3917.  
  3918.     DESCRIPTION
  3919.        This option specifies the file attributes files must have in order to be
  3920.        included in file scan operations. The codes are as follows:
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.  
  3931.  
  3932.  
  3933.  
  3934.                                           Page 62
  3935.                                    ICF REFERENCE MANUAL
  3936.  
  3937.  
  3938.  
  3939.  
  3940.       ATTRIBUTE       MEANING
  3941.          CODE
  3942.  
  3943.                   Readonly          R
  3944.  
  3945.           S       System
  3946.  
  3947.                   Hidden          H
  3948.  
  3949.                   Normal          N
  3950.  
  3951.                   Archive          A
  3952.  
  3953.  
  3954.          Table    -                23   File attribute codes
  3955.  
  3956.  
  3957.  
  3958.     EXAMPLES
  3959.        ICF FILES /ASCII /ATTRS=RS
  3960.  
  3961.     SEE ALSO
  3962.        Protected Option, File Scan Operations, Normal Option
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.     4.7. AUTODAYS OPTION
  3969.  
  3970.     SYNTAX
  3971.        /Autodays=<number of days>
  3972.  
  3973.     DESCRIPTION
  3974.        This option specifies how many days can elapse before the STATUS command
  3975.        is run to perform configuration data collection on the PC. It is only
  3976.        valid when the AUTO command is used. Even if no other changes are de-
  3977.        tected on a given PC, once this many days elapse since the last time con-
  3978.        figuration data was collected a new run is performed.
  3979.  
  3980.        For example,
  3981.  
  3982.        ICF AUTO /AUTODAYS=14
  3983.  
  3984.        will instruct ICF to perform the STATUS command every 14 days.
  3985.  
  3986.     SEE ALSO
  3987.        Auto Command, Autorun Option, Autoid Option, Autorunfile Option,
  3988.        Autospace Option, Force Option
  3989.  
  3990.  
  3991.  
  3992.  
  3993.                                                63                                          Page 
  3994.                                    ICF REFERENCE MANUAL
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.     4.8. AUTORUN OPTION
  4004.  
  4005.     SYNTAX
  4006.        /Autorun=<criteria codes>
  4007.  
  4008.     DESCRIPTION
  4009.        This option specifies a list of criteria to check when ICF compares a
  4010.        current configuration with a previous one, to determine if it is neces-
  4011.        sary to perform another configuration data collection. It is only valid
  4012.        when the AUTO command is used with ICF. If this option is not specified,
  4013.        then all criteria is checked. The list of criteria codes is formed by
  4014.        stringing together codes from the list below. Either the long code or
  4015.        short code can be used (mixtures are ok) and each must be separated from
  4016.        the next with a comma.
  4017.  
  4018.  
  4019.  
  4020.        LONG   SHORT
  4021.        CODE   CODE                  DESCRIPTION
  4022.  
  4023.      CMOS       C    Cmos information
  4024.  
  4025.      BIOS       B    Bios data
  4026.  
  4027.      SPACE      S    Amount of free disk space on drives
  4028.  
  4029.      MAIN       M    General information including memory,
  4030.                      processor
  4031.  
  4032.      DIRS       D    Number of root-level directories
  4033.  
  4034.      DAYS       Y    Number of days since last run
  4035.  
  4036.      IDS        I    ID information entered manually
  4037.  
  4038.      MCA        A    Installed microchannel boards
  4039.  
  4040.  
  4041.          Table    -                 24    Autorun criteria
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.          The CMOS, BIOS, MAIN, and MCA categories should be self-explanatory (we
  4048.          hope!).
  4049.  
  4050.  
  4051.  
  4052.                                                64                                          Page 
  4053.                                    ICF REFERENCE MANUAL
  4054.  
  4055.  
  4056.  
  4057.          The SPACE criteria checks if the amount of free disk space has changed
  4058.          since the last configuration. Every local drive is compared with re-
  4059.          sults stored from the previous collection. By default a change of 2 MB
  4060.          of free space indicates that a new configuration should be captured.
  4061.          This can be changed with the /Autospace option.
  4062.  
  4063.          The DIRS criteria checks if the number of directories has changed on
  4064.          each local drive. Only the directories immediately under the root di-
  4065.          rectory are counted. The addition or deletion of directories may mean
  4066.          that a software package was added or deleted.
  4067.  
  4068.          The IDS criteria compares manually-entered ID and physical component
  4069.          information with previously stored data. This information is entered
  4070.          when the /Ask option or Ask command are used.
  4071.  
  4072.  
  4073.     SEE ALSO
  4074.        Auto Command, Autodays Option, Autoid Option, Autorunfile Option,
  4075.        Autospace Option, Force Option, Ask Option, Ask Command
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.     4.9. AUTORUNFILE OPTION
  4082.  
  4083.     SYNTAX
  4084.        /Autorunfile=<file specification including path>
  4085.  
  4086.     DESCRIPTION
  4087.        The AUTO command checks to see if any changes were made to the PC and, if
  4088.        so, a STATUS command is automatically performed. In order to compare the
  4089.        current configuration with a historical one, ICF saves configuration in-
  4090.        formation in a file on the local PC. While ICF can check shared databases
  4091.        for configuration information, local files are used because:
  4092.  
  4093.          it does not rely on a shared database being available during certain
  4094.          periods of time.
  4095.  
  4096.          accessing a local file is faster, considering that network traffic is
  4097.          avoided as well as time looking up data in an indexed database.
  4098.  
  4099.          this method works on standalone PC's as well as networked PC's.
  4100.  
  4101.  
  4102.        By default, ICF stores the configuration information in a file called
  4103.        C:\AUTORUN.DAT. This option changes the name and path to whatever is
  4104.        specified. If the workstation is a disk workstation, or it is not desired
  4105.        to place this file on a local drive, then this option can be used to re-
  4106.        direct the file to another drive/directory (i.e. a user's private direc-
  4107.        tory on a network).
  4108.  
  4109.  
  4110.  
  4111.                                           Page 65
  4112.                                    ICF REFERENCE MANUAL
  4113.  
  4114.  
  4115.  
  4116.  
  4117.     SEE ALSO
  4118.        Auto Command, Autodays Option, Autorun Option, Autoid Option, Autospace
  4119.        Option, Force Option
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.     4.10. AUTOSPACE OPTION
  4126.  
  4127.     SYNTAX
  4128.        /Autospace=<bytes in K units>
  4129.  
  4130.     DESCRIPTION
  4131.        This option specifies how much the amount of free disk space should
  4132.        change before ICF performs a STATUS command to collect configuration in-
  4133.        formation on the PC. It is only valid when the AUTO command is used with
  4134.        ICF.
  4135.  
  4136.        If this option is not specified then the default of 2 MB is used. By ex-
  4137.        perimenting with this value you can guess when software programs may have
  4138.        been added or deleted to the PC based on the assumption that the amount
  4139.        of free disk space would change considerably. This is of course an as-
  4140.        sumption only, as in some cases the change could be the result of data
  4141.        added or deleted, hard disk maintenance being performed, etc.
  4142.  
  4143.        Every local drive is checked for free space and compared with results
  4144.        from a previous run. Obviously if drives are changed, added or removed
  4145.        then a change will likely occur.
  4146.  
  4147.        Note that the number specified is in K units.
  4148.  
  4149.     EXAMPLES
  4150.        ICF AUTO /AUTOSPACE=4000
  4151.           ICF will perform the STATUS command if the amount of free disk
  4152.           space increased or decreased by 4,000,000 bytes since the last
  4153.           time it was run.
  4154.  
  4155.  
  4156.     SEE ALSO
  4157.        Auto Command, Autodays Option, Autorun Option, Autoid Option, Autorunfile
  4158.        Option, Force Option
  4159.  
  4160.  
  4161.  
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.  
  4169.  
  4170.                                           Page 66
  4171.                                    ICF REFERENCE MANUAL
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.  
  4179.  
  4180.     4.11. BANNER OPTION
  4181.  
  4182.     DESCRIPTION
  4183.        This option specifies an optional "banner line" to be displayed after the
  4184.        ICF program identification line when ICF is run. It can be used to dis-
  4185.        play your company name or other pertinent information.
  4186.  
  4187.        In order to make it easy to specify values with embedded spaces, the '_'
  4188.        (underscore) character is considered a substitute for spaces. ICF will
  4189.        automatically filter these out and replace them with spaces.
  4190.  
  4191.     EXAMPLE
  4192.        BANNER=THE_INVENTORY_COMPANY
  4193.  
  4194.        would produce the banner line to be displayed as...
  4195.  
  4196.        "THE INVENTORY COMPANY"
  4197.  
  4198.        The default space character of _ (underscore character) can be changed by
  4199.        using the /Spacechar option.
  4200.  
  4201.     SEE ALSO
  4202.        Spacechar Option
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.     4.12. BATCH OPTION
  4209.  
  4210.     DESCRIPTION
  4211.        This option is a Shortcut Option. It automatically specifies the follow-
  4212.        ing options:
  4213.  
  4214.          /Quiet
  4215.          /Noreadmsg
  4216.          /Overwrite
  4217.          /Hide
  4218.          /Filetype=Dbase
  4219.  
  4220.        In other words, by including the /Batch option ICF will assume all the
  4221.        above options.
  4222.  
  4223.     SEE ALSO
  4224.        Quiet Option, Noreadmsg Option, Overwrite Option, Hide Option, Filetype
  4225.        Option, Shortcut Options
  4226.  
  4227.  
  4228.  
  4229.                                           Page 67
  4230.                                    ICF REFERENCE MANUAL
  4231.  
  4232.  
  4233.  
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.     4.13. BIGFILES OPTION
  4240.  
  4241.     DESCRIPTION
  4242.        This option specifies that only "big files" are processed in a file scan
  4243.        operation. A big file is defined as a file whose size is greater than
  4244.        that specified by the /Bigfilesize option. If the /Bigfilesize option
  4245.        isn't included, the default size of 500,000 bytes is used.
  4246.  
  4247.     SEE ALSO
  4248.        ICF File Scan Operations, Smallfilesize Option, Bigfilesize Option,
  4249.        Smallfiles Option, Size Option
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.     4.14. BIGFILESIZE OPTION
  4257.  
  4258.     SYNTAX
  4259.        /Bigfilesize=<n>
  4260.  
  4261.     DESCRIPTION
  4262.        This option specifies the file size, in bytes, used for comparison when
  4263.        the BIGFILES option is included. Unless this option is used, ICF uses a
  4264.        default size of 500,000 bytes.
  4265.  
  4266.     SEE ALSO
  4267.        File Scan Operations, Smallfilesize Option, Bigfiles Option, Smallfiles
  4268.        Option, Size Option
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.     4.15. BREAK OPTION
  4275.  
  4276.     SYNTAX
  4277.        /Break=N | Q
  4278.  
  4279.     DESCRIPTION
  4280.        This option controls the processing of any Ctrl-Break key presses during
  4281.        ICF operation. If Ctrl-Break is hit during an ICF run, the following
  4282.        processing occurs depending on the value of the /Break option:
  4283.  
  4284.  
  4285.  
  4286.  
  4287.  
  4288.                                           Page 68
  4289.                                    ICF REFERENCE MANUAL
  4290.  
  4291.  
  4292.  
  4293.  
  4294.       VALUE             HANDLING OF CTRL-BREAK
  4295.  
  4296.         N    It is ignored and processing continues.
  4297.  
  4298.         Q    Processing is immediately aborted.
  4299.  
  4300.  
  4301.        If /Break is not specified ICF asks if processing should be aborted. Hit
  4302.        N or Y to answer.
  4303.  
  4304.     EXAMPLES
  4305.        BREAK=N
  4306.  
  4307.        BREAK=Q
  4308.  
  4309.     SEE ALSO
  4310.        Escape Option
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.     4.16. CLS OPTION
  4317.  
  4318.     DESCRIPTION
  4319.        This option instructs ICF to clear the screen before starting any other
  4320.        operation.
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.     4.17. COLON OPTION
  4327.  
  4328.     DESCRIPTION
  4329.        This option specifies that a single letter used as a file specification
  4330.        should not be assumed to be a drive name.
  4331.  
  4332.     EXAMPLES
  4333.        ICF FILES D
  4334.           This will search for all files on drive D:
  4335.  
  4336.        ICF FILES D /COLON
  4337.           This will search for a file with the name "D".
  4338.  
  4339.        ICF FILES D:
  4340.           This will search for all files on drive D:
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.                                           Page 69
  4348.                                    ICF REFERENCE MANUAL
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.     4.18. COMPANYNAME OPTION
  4358.  
  4359.     SYNTAX
  4360.        /Companyname=<string>
  4361.  
  4362.     DESCRIPTION
  4363.        This option specifies a user-defined name to represent the company. It is
  4364.        valid only for the STATUS command. The value entered for this option will
  4365.        be saved in a special "ID" field just like any other item of information
  4366.        captured from the computer ICF is running on. Refer to ID Fields on page
  4367.        17 for more information.
  4368.  
  4369.     SEE ALSO
  4370.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  4371.        Option, Monitorid Option, Printerid Option, Userid Option, Username
  4372.        Option, Computername Option
  4373.  
  4374.  
  4375.  
  4376.  
  4377.  
  4378.     4.19. COMPUTERID OPTION
  4379.  
  4380.     SYNTAX
  4381.        /Computerid=<string>
  4382.  
  4383.     DESCRIPTION
  4384.        This option specifies a user-defined "tag" or ID to represent the com-
  4385.        puter that ICF is running on. The value entered for this option will be
  4386.        saved in a special "ID" field just like any other item of information
  4387.        captured from the computer ICF is running on. Refer to ID Fields on page
  4388.        17 for more information.
  4389.  
  4390.     SEE ALSO
  4391.        ID Fields, Miscid1 Option, Miscid2 Option, Modemid Option, Monitorid
  4392.        Option, Printerid Option, Userid Option, Username Option, Computername
  4393.        Option, Companyname Option
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.                                           Page 70
  4407.                                    ICF REFERENCE MANUAL
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.     4.20. DBASE OPTION
  4417.  
  4418.     DESCRIPTION
  4419.        This option instructs ICF to save data in a Dbase file. The file will be
  4420.        able to be read by any software program that understands .DBF type files.
  4421.  
  4422.        The extension applied to Dbase files is always .DBF. The name of the file
  4423.        depends on other options that are set.
  4424.  
  4425.  
  4426.  
  4427.        NOTE:  While some packages may not directly support Dbase files, they
  4428.        may have import conversion commands or utilities to convert such files
  4429.        into their native format (i.e. Paradox).
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.     SEE ALSO
  4436.        Ascii Option, Lotus Option, Output File Naming
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.     4.21. DESC OPTION
  4443.  
  4444.     DESCRIPTION
  4445.        This option specifies that additional "description" fields are to be
  4446.        added to each record in the output file. It has a unique use for each of
  4447.        the several ICF commands affected by this option. The /Desc option is ig-
  4448.        nored for commands that do not have "description" fields.
  4449.  
  4450.        The following commands are supported by this option:
  4451.  
  4452.          Status
  4453.          Lanaccess
  4454.          Lanservers
  4455.          Lanresource
  4456.  
  4457.     SEE ALSO
  4458.        Status Command
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.                                           Page 71
  4466.                                    ICF REFERENCE MANUAL
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.     4.22. DESCEND OPTION
  4476.  
  4477.     DESCRIPTION
  4478.        ICF will descend a directory tree and process all nested subdirectories
  4479.        starting with the first one specified. Since this is the default behav-
  4480.        ior, /Descend is used only to override a previously issued /Nodescend op-
  4481.        tion.
  4482.  
  4483.     SEE ALSO
  4484.        Nodescend Option
  4485.  
  4486.  
  4487.  
  4488.  
  4489.  
  4490.     4.23. DOMAINS OPTION
  4491.  
  4492.     DESCRIPTION
  4493.        This option is reserved for LAN vendor-specific versions of ICF.
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.     4.24. DOSEARCH OPTION
  4500.  
  4501.     DESCRIPTION
  4502.        This option instructs ICF to use standard DOS file specifications.
  4503.  
  4504.     EXAMPLES
  4505.        ICF FILES EXE
  4506.           This will search for all files with the text "EXE" anywhere in the
  4507.           file name. The following files, if present on the drives searched,
  4508.           would be identified by this command:
  4509.  
  4510.               TEST.EXE
  4511.               MYEXE.DAT
  4512.               1EXE2
  4513.  
  4514.        ICF FILES EXE /DOSEARCH
  4515.           Since /Dosearch is used, only a file with the name "EXE" would be
  4516.           identified.
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.                                           Page 72
  4525.                                    ICF REFERENCE MANUAL
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.     4.25. DRIVES OPTION
  4535.  
  4536.     SYNTAX
  4537.        /Drives= <drive letter list>
  4538.  
  4539.     DESCRIPTION
  4540.        This option specifies the drives that should be included in any file scan
  4541.        operation. If it is not specified, then by default all local drives are
  4542.        included. Use the /Landrives or /Landriveso options to include remote
  4543.        drives.
  4544.  
  4545.     EXAMPLES
  4546.        ICF FILES /DRIVES=CEG
  4547.           Only drives C:, E:, and G: are included in the search for files.
  4548.  
  4549.     SEE ALSO
  4550.        Drive Options Summary, File Scan Operations, Skipdrives Option, Landrives
  4551.        Option, Landriveso Option, Alldisks Option
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.     4.26. ENTIREDISK OPTION
  4558.  
  4559.     DESCRIPTION
  4560.        There are many options that set "filters" to be used when performing a
  4561.        file scan command. The result of these filters is that only files that
  4562.        meet the specified criteria are included in the output. Files can be se-
  4563.        lected based on file size, file date, file attributes, and names.
  4564.  
  4565.        This option instructs ICF to override all these options, in effect skip-
  4566.        ping any filter conditions previously defined. All files will be included
  4567.        in a file scan operation.
  4568.  
  4569.     SEE ALSO
  4570.        Bigfiles Option, Smallfiles Option
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.                                           Page 73
  4584.                                    ICF REFERENCE MANUAL
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.     4.27. ESCAPE OPTION
  4594.  
  4595.     DESCRIPTION
  4596.        This option instructs ICF to abort processing if the ESC (escape) key is
  4597.        hit. If it is not specified then hitting ESC key has no effect.
  4598.  
  4599.        It may be useful to include /Escape to permit users to abort processing
  4600.        in case more important (in the eyes of the user) work needs to be done.
  4601.  
  4602.     SEE ALSO
  4603.        Break Option
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.     4.28. FILENAME OPTION
  4610.  
  4611.     SYNTAX
  4612.        /Filename=<filespec> or
  4613.          $TEMP or $COMPID or $USERID or $USERNAME
  4614.  
  4615.     DESCRIPTION
  4616.        This option specifies the name of the output file created when one of the
  4617.        output file options is used: /Dbase, /Ascii, and /Lotus. Normally ICF as-
  4618.        signs a default name to an output file, which depends on the command ICF
  4619.        is performing. Refer to Output File Naming on page 36 for complete infor-
  4620.        mation.
  4621.  
  4622.        If the /Filename option is used, a different file name is assigned de-
  4623.        pending on the parameter used:
  4624.  
  4625.  
  4626.  
  4627.  
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.  
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.                                           Page 74
  4643.                                    ICF REFERENCE MANUAL
  4644.  
  4645.  
  4646.  
  4647.  
  4648.        FILENAME                     DESCRIPTION
  4649.         OPTION
  4650.  
  4651.      <filespec>    Specifies a file name, which may include a
  4652.                    drive/path specification. Note that the
  4653.                    location of the output file is also af-
  4654.                    fected by the /Outdir option.
  4655.  
  4656.      $TEMP         The file name is assigned a unique number
  4657.                    padded with zeroes. ICF makes sure the name
  4658.                    assigned does not conflict with existing
  4659.                    file names in the same output directory.
  4660.                    The first file name would be ICF00001.DBF,
  4661.                    the second ICF00002.DBF, and so on.
  4662.  
  4663.      $COMPID       The file name is assigned the first eight
  4664.                    characters from the value specified on the
  4665.                    /Computerid option.
  4666.  
  4667.      $USERID       The file name is assigned the first eight
  4668.                    characters from the value specified on the
  4669.                    /Userid option.
  4670.  
  4671.      $USERNAME     The file name is assigned the first eight
  4672.                    characters from the value specified on the
  4673.                    /Username option.
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.        NOTE:  If the $COMPID, $USERID, or $USERNAME options are used, and the
  4680.        corresponding option used to retrieve the name is not specified, an
  4681.        error will result. For example, if the option /Filename=$Userid was
  4682.        used, but the option /User= was not specified. ICF will not be able to
  4683.        name the file.
  4684.  
  4685.  
  4686.  
  4687.  
  4688.  
  4689.     SEE ALSO
  4690.        Dbase Option, Ascii Option, Lotus Option, Output File Naming, Outdir
  4691.        Option, Computerid Option, Userid Option, Username Option
  4692.  
  4693.  
  4694.  
  4695.  
  4696.  
  4697.  
  4698.  
  4699.  
  4700.  
  4701.                                           Page 75
  4702.                                    ICF REFERENCE MANUAL
  4703.  
  4704.  
  4705.  
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.     4.29. FINDEXTS OPTION
  4712.  
  4713.     DESCRIPTION
  4714.        This option specifies that a record of non-recognized software be saved
  4715.        during program scan operations, permitting after-the-fact program recog-
  4716.        nition. Normally when a program scan operation is performed as a result
  4717.        of using the STATUS, AUTO or PROGRAMS commands, ICF records information
  4718.        for each .COM and .EXE file that has a matching entry in the recognition
  4719.        database (ICFPROGn.DBF).  If /Findexts is used then ICF will also save
  4720.        information for every .COM and .EXE file found.
  4721.  
  4722.     SEE ALSO
  4723.        Findextsval Option
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.     4.30. FINDEXTSVAL OPTION
  4730.  
  4731.     DESCRIPTION
  4732.        This option specifies additional file extensions that ICF should search
  4733.        for in addition to .COM and .EXE files used by the /Findexts option. In
  4734.        order for /Findextsval to work the /Findexts option must also be speci-
  4735.        fied.
  4736.  
  4737.  
  4738.  
  4739.        HINT: This option is particularly useful for searching for licensed
  4740.        files that are not necessarily "software". Examples include soft fonts
  4741.        and proprietary data files.
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.     SEE ALSO
  4748.        Findexts Option
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.                                           Page 76
  4761.                                    ICF REFERENCE MANUAL
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.     4.31. FLOPPY OPTION
  4771.  
  4772.     DESCRIPTION
  4773.        This option is a Shortcut Option - it automatically specifies the follow-
  4774.        ing options:
  4775.  
  4776.          /Outdir=A:\
  4777.          /Needspace=50
  4778.          /Filename=$Temp
  4779.  
  4780.        In other words, specifying just the /Floppy option instructs ICF to send
  4781.        the output file to the A:\ drive and directory, use a file name of
  4782.        "$Temp", and make sure at least 50,000 free bytes exist on the disk be-
  4783.        fore starting.
  4784.  
  4785.     SEE ALSO
  4786.        Needspace Option, Outdir Option, Filename Option, Shortcut Options
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.     4.32. FORCE OPTION
  4793.  
  4794.     DESCRIPTION
  4795.        This option forces a configuration data collection to be performed when
  4796.        the AUTO command is used. It instructs ICF to ignore the normal criteria
  4797.        used to check if any changes were made to the configuration.
  4798.  
  4799.     SEE ALSO
  4800.        Auto Command, Autorun Option, Autoid Option, Autorunfile Option,
  4801.        Autospace Option, Force Option, Autodays Option
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.     4.33. FORCEGLOBAL OPTION
  4808.  
  4809.     DESCRIPTION
  4810.        This option is a Shortcut Option. It automatically specifies the follow-
  4811.        ing options:
  4812.  
  4813.          /Entiredisk
  4814.          /Alldisks
  4815.  
  4816.  
  4817.  
  4818.  
  4819.                                           Page 77
  4820.                                    ICF REFERENCE MANUAL
  4821.  
  4822.  
  4823.  
  4824.        The effect is to search all files on all disks during a file scan opera-
  4825.        tion.
  4826.  
  4827.     SEE ALSO
  4828.        Shortcut Options, Entiredisk Option, Alldisks Option
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.     4.34. HIDE OPTION
  4835.  
  4836.     DESCRIPTION
  4837.        This option instructs ICF to "hide", or protect certain files that ICF
  4838.        uses. When the AUTO command is used, this option will cause ICF to set
  4839.        the Hidden, System, and Read-only attributes for the AUTORUN.DAT file
  4840.        (note that the /Autorunfile option can change this file name).
  4841.  
  4842.        Use of this option helps secure critical files from users. ICF will al-
  4843.        ways be able to read the file, but under normal circumstances it will not
  4844.        be deleted, or even viewed in directory listings.
  4845.  
  4846.     SEE ALSO
  4847.        Autorunfile Option, Auto Command
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.     4.35. ID OPTION
  4854.  
  4855.     DESCRIPTION
  4856.        This option specifies that output files should have additional fields
  4857.        added to each record to assist in identifying which configuration the re-
  4858.        cord belongs to. The fields added are:
  4859.  
  4860.  
  4861.        FIELD     DATA  LENGTH
  4862.         NAME     TYPE
  4863.  
  4864.      Username     C      25
  4865.  
  4866.      Miscid       C      25
  4867.  
  4868.      Compid       C      25
  4869.  
  4870.  
  4871.          Table 25 - ID option fields
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.                                                78                                          Page 
  4879.                                    ICF REFERENCE MANUAL
  4880.  
  4881.  
  4882.  
  4883.         The values for these fields are automatically filled in from the
  4884.        /Username, /Miscid, and /Computerid options.
  4885.  
  4886.     SEE ALSO
  4887.        Output File Structures, Timestamp Option, Miscid Option, Compid Option,
  4888.        Username Option
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.     4.36. INDIR OPTION
  4895.  
  4896.     DESCRIPTION
  4897.        This option specifies the input directory used for reading data files
  4898.        during the inventory collection process. These files include directories
  4899.        holding software and hardware recognition data.
  4900.  
  4901.        Normally ICF looks in the default directory for these files. If you want
  4902.        to place them on a special directory then this option is needed so ICF
  4903.        can find them.
  4904.  
  4905.  
  4906.  
  4907.        HINT: It may be prudent to place these files on a file server drive in
  4908.        a network environment.
  4909.  
  4910.  
  4911.  
  4912.  
  4913.  
  4914.     SEE ALSO
  4915.        Outdir Option
  4916.  
  4917.  
  4918.  
  4919.  
  4920.  
  4921.     4.37. ISMCA OPTION
  4922.  
  4923.     DESCRIPTION
  4924.        This option forces ICF to perform Microchannel inventory collection on
  4925.        machines that are not recognized as MCA (Micro Channel Architecture) com-
  4926.        puters.
  4927.  
  4928.        It is currently required on computers running any version of OS/2.
  4929.  
  4930.     SEE ALSO
  4931.        OS/2 Version
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.                                           Page 79
  4938.                                    ICF REFERENCE MANUAL
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.     4.38. LANDRIVES OPTION
  4948.  
  4949.     DESCRIPTION
  4950.        This option specifies that LAN (network) drives should be included in any
  4951.        file scan operation. By default ICF ignores LAN drives.
  4952.  
  4953.     SEE ALSO
  4954.        Drive Options Summary, File Scan Operations, Drives Option, Skipdrives
  4955.        Option, Landriveso Option, Alldisks Option
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.     4.39. LANDRIVESO OPTION
  4962.  
  4963.     DESCRIPTION
  4964.        This option specifies that ICF search only LAN (network) drives during
  4965.        any file scan operation. Local drives are ignored.
  4966.  
  4967.     SEE ALSO
  4968.        Drive Options Summary, File Scan Operations, Drives Option, Skipdrives
  4969.        Option, Landrives Option, Alldisks Option
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.     4.40. LOTUS OPTION
  4976.  
  4977.     DESCRIPTION
  4978.        This option instructs ICF to save data in a Lotus 1-2-3 file. The file
  4979.        will be able to be read in by any software package that reads .WK1
  4980.        spreadsheet files. Most spreadsheet and database programs are capable of
  4981.        reading (or at least translating) these files.
  4982.  
  4983.        The extension applied to files created with this option is always .WK1.
  4984.        The name of the file depends on other options that are set.
  4985.  
  4986.  
  4987.  
  4988.        NOTE:  The APPEND option is ignored if the /Lotus option is specified.
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.                                           Page 80
  4997.                                    ICF REFERENCE MANUAL
  4998.  
  4999.  
  5000.  
  5001.  
  5002.     SEE ALSO
  5003.        Ascii Option, Dbase Option, Append Option
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.     4.41. MISCID1 OPTION
  5010.  
  5011.     SYNTAX
  5012.        /Miscid1=<string>
  5013.  
  5014.     DESCRIPTION
  5015.        This option specifies a user-defined "tag" or ID to represent any compo-
  5016.        nent of the computer. It is one of 2 "miscid" fields (the other being
  5017.        /Miscid2). The value entered for this option will be saved in a special
  5018.        "ID" field just like any other item of information captured from the com-
  5019.        puter ICF is running on. Refer to ID Fields on page 17 for more informa-
  5020.        tion.
  5021.  
  5022.     SEE ALSO
  5023.        ID Fields, Computerid Option, Miscid2 Option, Modemid Option, Monitorid
  5024.        Option, Printerid Option, Userid Option, Username Option, Computername
  5025.        Option, Companyname Option
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.     4.42. MISCID2 OPTION
  5032.  
  5033.     SYNTAX
  5034.        /Miscid2=<string>
  5035.  
  5036.     DESCRIPTION
  5037.        This option specifies a user-defined "tag" or ID to represent any compo-
  5038.        nent of the computer. It is one of 2 "miscid" fields (the other being
  5039.        /Miscid1). The value entered for this option will be saved in a special
  5040.        "ID" field just like any other item of information captured from the com-
  5041.        puter ICF is running on. Refer to ID Fields on page 17 for more informa-
  5042.        tion.
  5043.  
  5044.     SEE ALSO
  5045.        ID Fields, Computerid Option, Miscid1 Option, Modemid Option, Monitorid
  5046.        Option, Printerid Option, Userid Option, Username Option, Computername
  5047.        Option, Companyname Option
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  
  5055.                                           Page 81
  5056.                                    ICF REFERENCE MANUAL
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.     4.43. MODEMID OPTION
  5066.  
  5067.     SYNTAX
  5068.        /Modemid=<string>
  5069.  
  5070.     DESCRIPTION
  5071.        This option specifies a "tag" or ID to help identify a modem attached to
  5072.        the computer. The value entered for this option will be saved in a spe-
  5073.        cial "ID" field just like any other item of information captured from the
  5074.        computer ICF is running on. Refer to ID Fields on page 17 for more infor-
  5075.        mation.
  5076.  
  5077.     SEE ALSO
  5078.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Monitorid
  5079.        Option, Printerid Option, Userid Option, Username Option, Computername
  5080.        Option, Companyname Option
  5081.  
  5082.  
  5083.  
  5084.  
  5085.  
  5086.     4.44. MONITORID OPTION
  5087.  
  5088.     SYNTAX
  5089.        /Monitorid=<string>
  5090.  
  5091.     DESCRIPTION
  5092.        This option is used to specify a "tag" or ID used to identify a monitor
  5093.        attached to the computer. The value entered for this option will be saved
  5094.        in a special "ID" field just like any other item of information captured
  5095.        from the computer ICF is running on. Refer to ID Fields on page 17 for
  5096.        more information.
  5097.  
  5098.     SEE ALSO
  5099.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  5100.        Option, Printerid Option, Userid Option, Username Option, Computername
  5101.        Option, Companyname Option
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.     4.45. NEEDDIR OPTION
  5108.  
  5109.     SYNTAX
  5110.        /Needdir=<directory name>
  5111.  
  5112.  
  5113.  
  5114.                                           Page 82
  5115.                                    ICF REFERENCE MANUAL
  5116.  
  5117.  
  5118.  
  5119.  
  5120.     DESCRIPTION
  5121.        This option instructs ICF to verify that the specified directory exists
  5122.        before starting any processing. If the directory does not exist, process-
  5123.        ing is aborted.
  5124.  
  5125.     SEE ALSO
  5126.        Needfile Option, Needspace Option, Needdir Option
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.     4.46. NEEDFILE OPTION
  5133.  
  5134.     SYNTAX
  5135.        /Needfile=<file name>
  5136.  
  5137.        This option instructs ICF to verify that the specified file exists before
  5138.        starting any processing. If the file does not exist, processing is
  5139.        aborted.
  5140.  
  5141.     SEE ALSO
  5142.        Needspace Option, Needdir Option
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.     4.47. NEEDSPACE OPTION
  5149.  
  5150.     SYNTAX
  5151.        /Needspace=<free space in K units>
  5152.  
  5153.     DESCRIPTION
  5154.        This option instructs ICF to verify that at least the specified number of
  5155.        bytes (in K units) of free disk space exist on a disk. If the amount of
  5156.        free space  is less than that specified, processing is aborted. The disk
  5157.        that space is checked on depends on whether or not the /Outdir option is
  5158.        specified. If /Outdir is used and a drive letter is included on the
  5159.        Outdir path, then that is the disk that is checked. Otherwise ICF checks
  5160.        the default disk.
  5161.  
  5162.  
  5163.  
  5164.        HINT: This option is especially valuable when saving data to a floppy
  5165.        disk.
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.                                           Page 83
  5174.                                    ICF REFERENCE MANUAL
  5175.  
  5176.  
  5177.  
  5178.  
  5179.     SEE ALSO
  5180.        Needfile Option, Needdir Option, Outdir Option, Floppy Option
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.     4.48. NOALIGNEXT OPTION
  5187.  
  5188.     DESCRIPTION
  5189.        This option specifies that extensions should not be aligned when dis-
  5190.        played on the screen.  For example, without the /Noalignext option the
  5191.        following display is produced from the command:
  5192.  
  5193.        ICF FILES E:\SAMPLE
  5194.  
  5195.       [ E:\SAMPLE\ ]
  5196.  
  5197.     TEST1        <DIR>  02-26-92 21:16      TEST2        <DIR>  02-26-92 21:16
  5198.     APPEND   EXE  10774 04-09-91 05:00 A    ATTRIB   EXE  15796 04-09-91 05:00 A
  5199.     CHKDSK   EXE  16200 04-09-91 05:00 A    COMP     EXE  14282 04-09-91 05:00 A
  5200.     CONFIG   SYS    106 04-22-91 05:56 A    EDIT     COM    413 04-09-91 05:00 A
  5201.     EDIT     HLP  17898 04-09-91 05:00 A    GORILLA  BAS  29434 04-09-91 05:00 A
  5202.     MORTGAGE BAS   6207 06-17-88 12:00 A    QBASIC   EXE 254799 04-09-91 05:00 A
  5203.     QBASIC   HLP 130810 04-09-91 05:00 A    SHELL    CLR   4438 06-17-88 12:00 A
  5204.     SHELL    HLP  65667 08-03-88 12:00 A    SHELL    MEU   4588 08-03-88 12:00 A
  5205.     SORT     EXE   6938 04-09-91 05:00 A    SUBST    EXE  18478 04-09-91 05:00 A
  5206.  
  5207.  
  5208.        and when the NOALIGNEXT option is used:
  5209.  
  5210.        ICF FILES E:\SAMPLE /NOALIGNEXT
  5211.  
  5212.       [ E:\SAMPLE\ ]
  5213.  
  5214.     TEST1        <DIR>  02-26-92 21:16      TEST2        <DIR>  02-26-92 21:16
  5215.     APPEND.EXE    10774 04-09-91 05:00 A    ATTRIB.EXE    15796 04-09-91 05:00 A
  5216.     CHKDSK.EXE    16200 04-09-91 05:00 A    COMP.EXE      14282 04-09-91 05:00 A
  5217.     CONFIG.SYS      106 04-22-91 05:56 A    EDIT.COM        413 04-09-91 05:00 A
  5218.     EDIT.HLP      17898 04-09-91 05:00 A    GORILLA.BAS   29434 04-09-91 05:00 A
  5219.     MORTGAGE.BAS   6207 06-17-88 12:00 A    QBASIC.EXE   254799 04-09-91 05:00 A
  5220.     QBASIC.HLP   130810 04-09-91 05:00 A    SHELL.CLR      4438 06-17-88 12:00 A
  5221.     SHELL.HLP     65667 08-03-88 12:00 A    SHELL.MEU      4588 08-03-88 12:00 A
  5222.     SORT.EXE       6938 04-09-91 05:00 A    SUBST.EXE     18478 04-09-91 05:00 A
  5223.  
  5224.  
  5225.     VALID FOR
  5226.        The FILES command and when output is not directed to a file.
  5227.  
  5228.  
  5229.  
  5230.  
  5231.  
  5232.                                           Page 84
  5233.                                    ICF REFERENCE MANUAL
  5234.  
  5235.  
  5236.  
  5237.     SEE ALSO
  5238.        Files Command
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.     4.49. NODESCEND OPTION
  5245.  
  5246.     DESCRIPTION
  5247.        This option instructs ICF not to descend a directory tree during a file
  5248.        scan operation. By default ICF processes all nested subdirectories start-
  5249.        ing with the first one specified.
  5250.  
  5251.     SEE ALSO
  5252.        Descend Option, File Scan Operations
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.     4.50. NOFILESDEFAULT OPTION
  5259.  
  5260.     DESCRIPTION
  5261.        This option specifies that any file scan operation should require a file
  5262.        specification to be given in the command line. Normally when a command is
  5263.        given, such as
  5264.  
  5265.        ICF FILES
  5266.  
  5267.        it is assumed that, in the absence of any files being specified after the
  5268.        FILES command,  all files on all drives should be scanned. If you want to
  5269.        disable this behavior and force the identification of files then use this
  5270.        option.
  5271.  
  5272.     SEE ALSO
  5273.        File Scan Operations
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.     4.51. NOMSG OPTION
  5280.  
  5281.     SYNTAX
  5282.        /Nomsg=<list of codes>
  5283.  
  5284.     DESCRIPTION
  5285.        This option suppresses various messages from being displayed by ICF dur-
  5286.        ing processing. It can be used to present a "cleaner" or more turnkey
  5287.        display for users. The codes can be a combination of the following:
  5288.  
  5289.  
  5290.  
  5291.                                           Page 85
  5292.                                    ICF REFERENCE MANUAL
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.      CODE   MEANING
  5299.  
  5300.        R    Suppress messages displayed when an input file is
  5301.             read.
  5302.  
  5303.        F    Suppress messages displayed when an output file
  5304.             is opened or closed.
  5305.  
  5306.        E    Suppress the "End of program run" message.
  5307.  
  5308.  
  5309.          Table 26 - Values for /Nomsg option
  5310.  
  5311.  
  5312.  
  5313.     EXAMPLES
  5314.        ICF STATUS /DBASE /NOMSG=FE
  5315.           Suppress open/close and "End of program run" messages.
  5316.  
  5317.        ICF FILES /NOMSG=R
  5318.           Suppress "read input file" messages.
  5319.  
  5320.  
  5321.     SEE ALSO
  5322.        Noreadmsg Option
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.     4.52. NONUMBER OPTION
  5329.  
  5330.     DESCRIPTION
  5331.        If text files are output to the screen or printer (as a result of using
  5332.        the STATUS command with appropriate options to capture files such as
  5333.        CONFIG.SYS and AUTOEXEC.BAT), these files are normally displayed with
  5334.        line numbers.
  5335.  
  5336.        If this option is specified the line numbers are suppressed. It has no
  5337.        effect if output is directed to a file with the /Ascii, /Dbase, /Lotus,
  5338.        or /Filetype options.
  5339.  
  5340.     SEE ALSO
  5341.        Ascii Option, Dbase Option, Append Option, Lotus Option, Status Command
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.                                           Page 86
  5351.                                    ICF REFERENCE MANUAL
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.     4.53. NOREADMSG OPTION
  5361.  
  5362.     DESCRIPTION
  5363.        This option suppresses ICF from displaying a status message when it reads
  5364.        an input file. Normally ICF will display a message similar to
  5365.  
  5366.        LOADING DATA. PLEASE WAIT...
  5367.  
  5368.        when it reads an input file (an input file is any file that provides ICF
  5369.        with data, such as the programs file or microchannel boards file). If
  5370.        this option is used the message is not displayed.
  5371.  
  5372.        The same effect is produced by using the NOMSG option with R.
  5373.  
  5374.     EXAMPLES
  5375.        ICF STATUS /NOREADMSG
  5376.  
  5377.        ICF STATUS /NOMSG=R
  5378.  
  5379.        (the above options produce the same result)
  5380.  
  5381.     SEE ALSO
  5382.        Nomsg Option, Batch Option
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.     4.54. NORMAL OPTION
  5389.  
  5390.     DESCRIPTION
  5391.        This option specifies that only "normal" files are included in file scan
  5392.        operations. A "normal" file is completely unprotected - it does not have
  5393.        the System, Hidden, or Readonly attributes set.
  5394.  
  5395.     SEE ALSO
  5396.        Protected Option, Attrs Option, File Scan Operations
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.                                           Page 87
  5410.                                    ICF REFERENCE MANUAL
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.     4.55. NOSHOWDIR OPTION
  5420.  
  5421.     DESCRIPTION
  5422.        This option specifies that directory entries should not be included while
  5423.        processing the FILES Command. Normally directory entries are displayed
  5424.        with their name followed by the <DIR> indicator. This option inhibits
  5425.        this display.
  5426.  
  5427.  
  5428.  
  5429.        NOTE:  This option does not prevent subdirectories from being proc-
  5430.        essed. See the /Descend and /Nodescend options for related informa-
  5431.        tion.
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.     SEE ALSO
  5438.        Files Command, Showdir Option, Descend Option, Nodescend Option
  5439.  
  5440.  
  5441.  
  5442.  
  5443.  
  5444.     4.56. NOSTATUS OPTION
  5445.  
  5446.     SYNTAX
  5447.        /Nostatus=<status code list>
  5448.  
  5449.     VALID FOR
  5450.        STATUS command, AUTO command
  5451.  
  5452.     DESCRIPTION
  5453.        This option lists groups of status information that should not be re-
  5454.        ported when the STATUS command is run.  Each item reported by the STATUS
  5455.        command is in a particular "group". These groups are shown below:
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.                                           Page 88
  5469.                                    ICF REFERENCE MANUAL
  5470.  
  5471.  
  5472.  
  5473.  
  5474.      CODE  DESCRIPTION
  5475.  
  5476.      MCA   Microchannel
  5477.  
  5478.      MEM   Memory
  5479.  
  5480.      MOU   Mouse
  5481.  
  5482.      VIO   Video
  5483.  
  5484.      MAI   Main information
  5485.  
  5486.      PRO   Program (software) information
  5487.  
  5488.      LAN   LAN Information
  5489.  
  5490.      ENV   Environment variables
  5491.  
  5492.      IDI   Id information
  5493.  
  5494.      DSK   Disk information
  5495.  
  5496.      TXT   Text files (i.e. CONFIG.SYS, AUTOEXEC.BAT)
  5497.  
  5498.      CMO   Cmos information
  5499.  
  5500.      SUB   DOS TSR and Subsystem information
  5501.  
  5502.  
  5503.          Table 27 - Status command groups
  5504.  
  5505.  
  5506.  
  5507.  
  5508.        By default when the STATUS command is performed ICF collects configura-
  5509.        tion and status information on all groups.
  5510.  
  5511.     EXAMPLES
  5512.        ICF STATUS /NOSTATUS:PRO
  5513.           When the STATUS command is performed the program scan is skipped.
  5514.           This option is valuable when you don't have a lot of time and
  5515.           therefore want to skip scanning drives for software.
  5516.  
  5517.        ICF STATUS /NOSTATUS:TXT
  5518.           Any system files are not captured when the STATUS command is per-
  5519.           formed
  5520.  
  5521.  
  5522.     SEE ALSO
  5523.        STATUS command
  5524.  
  5525.  
  5526.  
  5527.                                           Page 89
  5528.                                    ICF REFERENCE MANUAL
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.     4.57. OUTDIR OPTION
  5538.  
  5539.     DESCRIPTION
  5540.        This option specifies the directory used to store output files from ICF.
  5541.        ICF will normally use the current default directory to place any output
  5542.        files unless one of the following conditions occurs:
  5543.  
  5544.          The /Outdir option is used
  5545.  
  5546.          A path specification is included on the /Filename option.
  5547.  
  5548.  
  5549.     SEE ALSO
  5550.        Indir Option, Filename Option, Outdirnov Option, Needspace Option, Output
  5551.        File Naming
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.     4.58. OUTDIRNOV OPTION
  5558.  
  5559.     DESCRIPTION
  5560.        This option instructs ICF to ignore any path specifications included on
  5561.        the /Filename option and always use the directory specified on the
  5562.        /Outdir option.
  5563.  
  5564.        Normally if both the /Outdir option is specified, and the /Filename op-
  5565.        tion is used and includes a path specification, the /Filename path will
  5566.        override the /Outdir path. The /Outdirnov option reverses this behavior.
  5567.  
  5568.     SEE ALSO
  5569.        Outdir Option, Filename Option
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.     4.59. OVERWRITE OPTION
  5576.  
  5577.     DESCRIPTION
  5578.        This option specifies that if an output file already exists with the same
  5579.        name as the one being created, the old file is overwritten. By default
  5580.        ICF will not overwrite files and will abort if such an attempt is made.
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.                                           Page 90
  5587.                                    ICF REFERENCE MANUAL
  5588.  
  5589.  
  5590.  
  5591.     SEE ALSO
  5592.        Append Option, Batch Option
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.     4.60. PAUSE OPTION
  5599.  
  5600.     VALID FOR
  5601.        Any command where output is sent to the screen.
  5602.  
  5603.     DESCRIPTION
  5604.        This option instructs ICF to pause the display every time the screen
  5605.        fills with information. When the screen fills, the message "--MORE--" is
  5606.        displayed, and ICF waits until any key is pressed to continue.
  5607.  
  5608.     SEE ALSO
  5609.        Cls Option
  5610.  
  5611.  
  5612.  
  5613.  
  5614.  
  5615.     4.61. PRINTERID OPTION
  5616.  
  5617.     SYNTAX
  5618.        /Printerid=<string>
  5619.  
  5620.     DESCRIPTION
  5621.        This option specifies a "tag" or ID to identify a printer attached to the
  5622.        computer. The value entered for this option will be saved in a special
  5623.        "ID" field just like any other item of information captured from the com-
  5624.        puter ICF is running on. Refer to ID Fields on page 17 for more informa-
  5625.        tion.
  5626.  
  5627.     SEE ALSO
  5628.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  5629.        Option, Monitorid Option, Userid Option, Username Option, Computername
  5630.        Option, Companyname Option
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.     4.62. PROGINFO OPTION
  5637.  
  5638.     DESCRIPTION
  5639.        This option instructs ICF to provide additional information, including
  5640.        the file date, time, and size, for each program found during processing
  5641.        of a STATUS, AUTO or PROGRAMS command.
  5642.  
  5643.  
  5644.  
  5645.                                           Page 91
  5646.                                    ICF REFERENCE MANUAL
  5647.  
  5648.  
  5649.  
  5650.  
  5651.     SEE ALSO
  5652.        STATUS command
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.     4.63. PROGSLIMIT OPTION
  5659.  
  5660.  
  5661.     SYNTAX
  5662.        /Progslimit=<n>
  5663.  
  5664.     DESCRIPTION
  5665.        This option instructs ICF to only process the first <n> programs found
  5666.        during a program scan (when ICF scans drives searching for recognizable
  5667.        software). It is intended for testing purposes and is useful when trying
  5668.        out different ICF commands and options.
  5669.  
  5670.     SEE ALSO
  5671.        Recslimit option, Options for testing, Recsnotify option
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.     4.64. PROTECTED OPTION
  5678.  
  5679.     DESCRIPTION
  5680.        This option specifies that only "protected" files should be included in
  5681.        file scan operations. Protected files must have at least one of the
  5682.        Hidden, System, and Readonly attributes set.
  5683.  
  5684.     SEE ALSO
  5685.        Attrs Option, File Scan Operations, Normal Option
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.     4.65. QUIET OPTION
  5692.  
  5693.     DESCRIPTION
  5694.        This option instructs ICF to suppress the display of all status messages
  5695.        while running. It can be used to remove clutter from the screen as a re-
  5696.        sult of status messages being displayed.
  5697.  
  5698.     SEE ALSO
  5699.        Noreadmsg Option, Nomsg Option
  5700.  
  5701.  
  5702.  
  5703.  
  5704.                                           Page 92
  5705.                                    ICF REFERENCE MANUAL
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.     4.66. RECSLIMIT OPTION
  5715.  
  5716.     SYNTAX
  5717.        /Recslimit=<n>
  5718.  
  5719.     DESCRIPTION
  5720.        This option instructs ICF to abort processing after <n> records have been
  5721.        processed. It is useful for testing ICF runs.
  5722.  
  5723.     SEE ALSO
  5724.        Recsnotify Option, Options for testing
  5725.  
  5726.  
  5727.  
  5728.  
  5729.  
  5730.     4.67. RECSNOTIFY OPTION
  5731.  
  5732.     SYNTAX
  5733.        /Recsnotify=<n>
  5734.  
  5735.        This option instructs ICF to display a progress message after every <n>
  5736.        records processed. It is for testing and convenience so you know work is
  5737.        actually being done (useful for commands or options that may take a long
  5738.        time to perform).
  5739.  
  5740.     SEE ALSO
  5741.        Recslimit Option, Options for testing, Progslimit option
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.     4.68. RINGBELL OPTION
  5748.  
  5749.     DESCRIPTION
  5750.        This option instructs ICF to ring the bell when the current command is
  5751.        complete. It is useful when running long commands or batch files and you
  5752.        want to know when it has finished.
  5753.  
  5754.     SEE ALSO
  5755.        Overview
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.                                           Page 93
  5764.                                    ICF REFERENCE MANUAL
  5765.  
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.     4.69. SAVEIDS OPTION
  5774.  
  5775.     DESCRIPTION
  5776.        This option specifies that any user-defined information for physical or
  5777.        standalone equipment entered with the /Ask option should be saved in a
  5778.        file on the local computer. The next time the STATUS or AUTO command is
  5779.        performed this information is automatically available to ICF. The file
  5780.        this information is saved to is C:\AUTORUN.DAT.
  5781.  
  5782.     SEE ALSO
  5783.        ASK command
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.     4.70. SERVERS OPTION
  5790.  
  5791.     DESCRIPTION
  5792.        This option is reserved for LAN specific versions of ICF.
  5793.  
  5794.     SEE ALSO
  5795.        Options Summary
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.     4.71. SERVERTYPES OPTION
  5802.  
  5803.     DESCRIPTION
  5804.  
  5805.        This option is reserved for LAN specific versions of ICF.
  5806.  
  5807.     SEE ALSO
  5808.        Options Summary
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.     4.72. SHOWDIR OPTION
  5815.  
  5816.     DESCRIPTION
  5817.        This option specifies that directory entries should be listed during
  5818.        processing of the ICF FILES command. Normally directory entries are
  5819.  
  5820.  
  5821.  
  5822.                                           Page 94
  5823.                                    ICF REFERENCE MANUAL
  5824.  
  5825.  
  5826.  
  5827.        listed by name with the <DIR> indicator next to them. Since this is the
  5828.        default behavior, /Showdir is only necessary to override a previously is-
  5829.        sued /Noshowdir option.
  5830.  
  5831.     SEE ALSO
  5832.        Files Command, Noshowdir Option
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.     4.73. SIZE OPTION
  5839.  
  5840.     SYNTAX
  5841.        /Size= L<n> | E<n> | G<n>
  5842.  
  5843.     DESCRIPTION
  5844.        This option specifies what size, in bytes, to use in comparing file sizes
  5845.        during a file scan operation, and what type of comparison is made. Either
  5846.        the L (less than), E (equal), or G (greater than) letter is used followed
  5847.        immediately with a number.
  5848.  
  5849.     EXAMPLES
  5850.        /SIZE=L1000
  5851.           Include all files whose file size is less (L) than 1,000 bytes
  5852.  
  5853.        /SIZE=E140000
  5854.           Include files whose size is equal to 140,000 bytes
  5855.  
  5856.        /SIZE=G5000000
  5857.           Include files whose size is greater than 5,000,000 bytes
  5858.  
  5859.     SEE ALSO
  5860.        File Scan Operations, Smallfilesize Option, Bigfiles Option, Bigfilesize
  5861.        Option
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.     4.74. SIZEK OPTION
  5868.  
  5869.     DESCRIPTION
  5870.        This option specifies that all file sizes should be displayed in Kilobyte
  5871.        units. A 'K' will follow each file size to indicate this option is set.
  5872.        By default ICF will display file sizes as exact numbers, unless doing so
  5873.        would overflow the space available for display. In such cases ICF will
  5874.        automatically convert the number to Kilobyte or Megabyte units and append
  5875.        a 'K' or 'M' suffix as appropriate.
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.                                           Page 95
  5882.                                    ICF REFERENCE MANUAL
  5883.  
  5884.  
  5885.  
  5886.        This option only affects the FILES Command, and only if output is sent to
  5887.        the screen or printer (i.e. output is not going to a file).
  5888.  
  5889.        For example, when the /Sizek option is not specified as in the following:
  5890.  
  5891.  
  5892.     TEST1        <DIR>  02-26-92 21:16      TEST2        <DIR>  02-26-92 21:16
  5893.     APPEND.EXE    10774 04-09-91 05:00 A    ATTRIB.EXE    15796 04-09-91 05:00 A
  5894.     CHKDSK.EXE    16200 04-09-91 05:00 A    COMP.EXE      14282 04-09-91 05:00 A
  5895.     CONFIG.SYS      106 04-22-91 05:56 A    EDIT.COM        413 04-09-91 05:00 A
  5896.     EDIT.HLP      17898 04-09-91 05:00 A    GORILLA.BAS   29434 04-09-91 05:00 A
  5897.     MORTGAGE.BAS   6207 06-17-88 12:00 A    QBASIC.EXE   254799 04-09-91 05:00 A
  5898.     QBASIC.HLP   130810 04-09-91 05:00 A    SHELL.CLR      4438 06-17-88 12:00 A
  5899.     SHELL.HLP     65667 08-03-88 12:00 A    SHELL.MEU      4588 08-03-88 12:00 A
  5900.     SORT.EXE       6938 04-09-91 05:00 A    SUBST.EXE     18478 04-09-91 05:00 A
  5901.  
  5902.        and when it is specified:
  5903.  
  5904.       [ E:\SAMPLE\ ]
  5905.  
  5906.     TEST1        <DIR>  02-26-92 21:16      TEST2        <DIR>  02-26-92 21:16
  5907.     APPEND   EXE    10K 04-09-91 05:00 A    ATTRIB   EXE    15K 04-09-91 05:00 A
  5908.     CHKDSK   EXE    16K 04-09-91 05:00 A    COMP     EXE    14K 04-09-91 05:00 A
  5909.     CONFIG   SYS    106 04-22-91 05:56 A    EDIT     COM    413 04-09-91 05:00 A
  5910.     EDIT     HLP    17K 04-09-91 05:00 A    GORILLA  BAS    29K 04-09-91 05:00 A
  5911.     MORTGAGE BAS     6K 06-17-88 12:00 A    QBASIC   EXE   254K 04-09-91 05:00 A
  5912.     QBASIC   HLP   130K 04-09-91 05:00 A    SHELL    CLR     4K 06-17-88 12:00 A
  5913.     SHELL    HLP    65K 08-03-88 12:00 A    SHELL    MEU     4K 08-03-88 12:00 A
  5914.     SORT     EXE     6K 04-09-91 05:00 A    SUBST    EXE    18K 04-09-91 05:00 A
  5915.  
  5916.  
  5917.     SEE ALSO
  5918.        Files Command
  5919.  
  5920.  
  5921.  
  5922.  
  5923.  
  5924.     4.75. SKIPDRIVES OPTION
  5925.  
  5926.     SYNTAX
  5927.        SKIPDRIVES=<drive list>
  5928.  
  5929.        where <drive list> is a string of letters, each representing a valid disk
  5930.        drive. Colons and commas should not be included in the string
  5931.  
  5932.     DESCRIPTION
  5933.        This option specifies drives that should be skipped during file scan op-
  5934.        erations. This option may conflict with related options.
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.                                           Page 96
  5941.                                    ICF REFERENCE MANUAL
  5942.  
  5943.  
  5944.  
  5945.     SEE ALSO
  5946.        Drive Options Summary, File Scan Operations, Drives Option, Landrives
  5947.        Option, Landriveso Option, Alldisks Option
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.     4.76. SMALLFILES OPTION
  5954.  
  5955.     DESCRIPTION
  5956.        This option specifies that only "small files" are processed in a file
  5957.        scan operation. A small file is defined as a file whose size is less than
  5958.        that specified by the /Smallfilesize option. If the /Smallfilesize option
  5959.        isn't included, the default size of 100,000 bytes is used.
  5960.  
  5961.     SEE ALSO
  5962.        File Scan Operations, Smallfilesize Option, Bigfiles Option, Bigfilesize
  5963.        Option, Size Option
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.     4.77. SMALLFILESIZE OPTION
  5970.  
  5971.     SYNTAX
  5972.        /Smallfilesize=<n>
  5973.  
  5974.     DESCRIPTION
  5975.        This option specifies the file size, in bytes, used for comparison when
  5976.        the /Smallfiles option is included. Unless this option is used, ICF uses
  5977.        a default size of 100,000 bytes.
  5978.  
  5979.     SEE ALSO
  5980.        File Scan Operations, Bigfiles Option, Bigfilesize Option, Smallfiles
  5981.        Option, Size Option
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.     4.78. SORTE OPTION
  5988.  
  5989.     DESCRIPTION
  5990.        This option specifies that files should be sorted by extension first,
  5991.        prior to displaying their names on the screen. It is only available for
  5992.        the FILES command.
  5993.  
  5994.     SEE ALSO
  5995.        FILES Command
  5996.  
  5997.  
  5998.  
  5999.                                           Page 97
  6000.                                    ICF REFERENCE MANUAL
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.     4.79. SPACECHAR OPTION
  6010.  
  6011.     DESCRIPTION
  6012.        This option specifies the special character used to substitute for
  6013.        spaces. It is used in con    tion with other options that may have long                                junc
  6014.        text strings as their value. If this option isn't specified, the '_'
  6015.        (underscore) character is used by default.
  6016.  
  6017.     SEE ALSO
  6018.        Banner Option
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.     4.80. TIMESTAMP OPTION
  6025.  
  6026.     DESCRIPTION
  6027.        This option specifies that output files should have additional fields
  6028.        added to each record to assist in identifying the exact date and time the
  6029.        record was written. The added fields are:
  6030.  
  6031.  
  6032.       FIELD    DATA   LENGTH
  6033.        NAME    TYPE
  6034.  
  6035.      Tsdate      D       8
  6036.  
  6037.      Tstime      C       8
  6038.  
  6039.  
  6040.          Table    -                28   Timestamp option fields
  6041.  
  6042.  
  6043.  
  6044.     SEE ALSO
  6045.        Output File Structures, Id Option
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.     4.81. TOTALS OPTION
  6052.  
  6053.     DESCRIPTION
  6054.        This option specifies that totals for each directory should be displayed.
  6055.  
  6056.  
  6057.  
  6058.                                                98                                          Page 
  6059.                                    ICF REFERENCE MANUAL
  6060.  
  6061.  
  6062.  
  6063.  
  6064.     VALID FOR
  6065.        The FILES command and when output is sent to the screen or printer.
  6066.  
  6067.     SEE ALSO
  6068.        Files Command
  6069.  
  6070.  
  6071.  
  6072.  
  6073.  
  6074.     4.82. TOTEXT OPTION
  6075.  
  6076.     DESCRIPTION
  6077.        This option is used only with the FILES command, and is only valid when
  6078.        output is sent to the screen. It specifies that file size and count to-
  6079.        tals should be displayed by file extension. Not all extensions are dis-
  6080.        played -- only "popular" ones. If all extensions should be totaled then
  6081.        include the /Allext option.
  6082.  
  6083.  
  6084.  
  6085.        NOTE:  This option is experimental and may be discontinued in future
  6086.        versions of ICF.
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.     SEE ALSO
  6093.        Experimental Features, Allext Option
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.     4.83. USERID OPTION
  6100.  
  6101.     SYNTAX
  6102.        /Userid=<string>
  6103.  
  6104.     DESCRIPTION
  6105.        This option specifies a "tag" or ID to help identify the user that the
  6106.        computer belongs to . The value entered for this option will be saved in
  6107.        a special "ID" field just like any other item of information captured
  6108.        from the computer ICF is running on. Refer to ID Fields on page 17 for
  6109.        more information.
  6110.  
  6111.  
  6112.  
  6113.  
  6114.  
  6115.  
  6116.  
  6117.                                           Page 99
  6118.                                    ICF REFERENCE MANUAL
  6119.  
  6120.  
  6121.  
  6122.     SEE ALSO
  6123.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  6124.        Option, Monitorid Option, Printerid Option, Username Option, Computername
  6125.        Option, Companyname Option
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.     4.84. USERNAME OPTION
  6132.  
  6133.     SYNTAX
  6134.        /Username=<string>
  6135.  
  6136.     DESCRIPTION
  6137.        This option specifies the name of the user that the computer belongs to.
  6138.        The value entered for this option will be saved in a special "ID" field
  6139.        just like any other item of information captured from the computer ICF is
  6140.        running on. Refer to ID Fields on page 17 for more information.
  6141.  
  6142.     SEE ALSO
  6143.        ID Fields, Computerid Option, Miscid1 Option, Miscid2 Option, Modemid
  6144.        Option, Monitorid Option, Printerid Option, Userid Option, Computername
  6145.        Option, Companyname Option
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.  
  6152.  
  6153.  
  6154.  
  6155.  
  6156.  
  6157.  
  6158.  
  6159.  
  6160.  
  6161.  
  6162.  
  6163.  
  6164.  
  6165.  
  6166.  
  6167.  
  6168.  
  6169.  
  6170.  
  6171.  
  6172.  
  6173.  
  6174.  
  6175.  
  6176.                                           Page 100
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.                                  ICF REFERENCE MANUAL
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.                                        INDEX
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.              .
  6197.  
  6198.              .ASC extension, 37, 61
  6199.              .DBF extension, 37
  6200.              .WK1 extension, 37, 80
  6201.  
  6202.  
  6203.              /
  6204.  
  6205.              /Alldisks option, 12, 28
  6206.            and /Forceglobal option, 77
  6207.              /Allext option, 32, 60
  6208.              /Append option
  6209.            and /Lotus option, 80
  6210.              /Ascii option, 36, 61
  6211.              /Ask option, 14, 48, 62
  6212.              /Attrs option, 62
  6213.              /Autodays option, 63
  6214.              /Autorun option, 64
  6215.              /Autorunfile option, 15, 49, 65
  6216.              /Autospace option, 66
  6217.              /Banner option, 67
  6218.              /Batch option, 27, 67
  6219.              /Bigfiles option, 68
  6220.              /Bigfilesize option, 68
  6221.              /Break option, 50, 68
  6222.              /Cls option, 69
  6223.              /Colon Option, 20
  6224.              /Colon option, 69
  6225.              /Companyname option, 70
  6226.  
  6227.  
  6228.                                   ICF REFERENCE MANUAL
  6229.  
  6230.              /Computerid option, 70
  6231.              /Dbase option, 36, 71
  6232.              /Desc option, 71
  6233.              /Descend option, 72, 85, 88
  6234.              /Domains option, 72
  6235.              /Dosearch Option, 20
  6236.              /Dosearch option, 72
  6237.              /Drives option, 28, 73
  6238.              /Entiredisk option, 12, 73
  6239.              /Entiredisks option
  6240.            and /Forceglobal option, 77
  6241.              /Escape option, 50, 69, 74
  6242.              /Filename option, 74, 90
  6243.            and /Floppy option, 77
  6244.              /Filetype option, 67
  6245.              /Findexts, 13
  6246.              /Findexts option, 76
  6247.              /Findextsval, 14
  6248.              /Findextsval option, 76
  6249.              /Floppy option, 27, 77
  6250.              /Force option, 49, 77
  6251.              /Forceglobal option, 12, 27, 77
  6252.              /Hide, 15
  6253.              /Hide option, 49, 67, 78
  6254.              /Id option, 78
  6255.              /Indir option, 79
  6256.              /Ismca option, 79
  6257.              /Landrives, 19
  6258.              /Landrives option, 28, 73, 80
  6259.              /Landriveso, 19
  6260.              /Landriveso option, 28, 73, 80
  6261.              /Lotus option, 36, 80
  6262.            and /Append, 61
  6263.              /Miscid1 option, 81
  6264.              /Miscid2 option, 81
  6265.              /Monitorid option, 82
  6266.              /Needdir option, 82
  6267.              /Needfile option, 83
  6268.              /Needspace option, 83
  6269.            and /Floppy option, 77
  6270.              /Noalignext option, 84
  6271.              /Nodescend option, 19, 72, 85, 88
  6272.              /Nofilesdefault option, 85
  6273.              /Nomsg option, 85, 87
  6274.              /Nonumber option, 86
  6275.              /Noreadmsg option, 67, 87
  6276.              /Normal option, 87
  6277.              /Noshowdir option, 88, 95
  6278.              /Nostatus option, 58, 88
  6279.              /Outdir option, 90
  6280.            and /Floppy option, 77
  6281.              /Outdirnov option, 90
  6282.  
  6283.  
  6284.                                   ICF REFERENCE MANUAL
  6285.  
  6286.              /Overwrite option, 67, 90
  6287.              /Pause option, 91
  6288.              /Printerid option, 91
  6289.              /Proginfo option, 91
  6290.              /Progslimit option, 30, 92
  6291.              /Protected option, 92
  6292.              /Quiet option, 67, 92
  6293.              /Recslimit option, 30, 93
  6294.              /Recsnotify option, 30, 93
  6295.              /Ringbell option, 93
  6296.              /Saveids option, 94
  6297.            and /Ask option, 62
  6298.              /Servers option, 94
  6299.              /Servertypes option, 94
  6300.              /Showdir option, 94
  6301.              /Size option, 95
  6302.              /Sizek option, 95
  6303.              /Skipdrives option, 28, 96
  6304.              /Smallfiles option, 97
  6305.              /Smallfilesize option, 97
  6306.              /Sorte option, 97
  6307.              /Spacechar option, 53, 67, 98
  6308.              /Timestamp option, 98
  6309.              /Totals option, 98
  6310.              /Totext option, 32, 60, 99
  6311.              /Userid option, 99
  6312.              /Username option, 100
  6313.  
  6314.  
  6315.              :
  6316.  
  6317.              : character, 26
  6318.  
  6319.  
  6320.              =
  6321.  
  6322.              = character, 26
  6323.  
  6324.  
  6325.              _
  6326.  
  6327.              _ character, 53
  6328.  
  6329.  
  6330.              A
  6331.  
  6332.              Alldisks option, 60
  6333.              Append option, 61
  6334.              ASK command, 14, 48
  6335.              Attributes, 87, 92
  6336.              AUTO command, 48
  6337.            and /Ask option, 62
  6338.  
  6339.  
  6340.                                   ICF REFERENCE MANUAL
  6341.  
  6342.            and /Autodays option, 63
  6343.            and /Autorun option, 64
  6344.            and /Autorunfile option, 65
  6345.            and /Autospace option, 66
  6346.            and /Force option, 77
  6347.            and /Hide option, 78
  6348.              AUTOEXEC.BAT
  6349.            /Nonumber option, 86
  6350.            STATUS command, 54
  6351.              AUTOEXEC.BAT file
  6352.            installation, 10
  6353.              AUTORUN.DAT file, 49, 65
  6354.            and /Hide option, 78
  6355.  
  6356.  
  6357.              B
  6358.  
  6359.              Batch file parameters, 14
  6360.  
  6361.  
  6362.              C
  6363.  
  6364.              Collecting Physical Configuration Data, 14
  6365.              Comma delimited files, 61
  6366.              Command line
  6367.            using options on, 26
  6368.              Commands Summary, 18
  6369.              Companyname, 17
  6370.              Compmethod field, 13
  6371.              Computerid, 17
  6372.              Computername, 17
  6373.              CONFIG.SYS
  6374.            /Nonumber option, 86
  6375.            STATUS command, 54
  6376.              Configuration files
  6377.            /Nonumber option, 86
  6378.              Ctrl-Break, 50
  6379.              Ctrl-W, 16
  6380.              Cumulative effects of options, 27
  6381.  
  6382.  
  6383.              D
  6384.  
  6385.              DISKSPACE Command, 51
  6386.              DOS SET command, 26
  6387.              Drive options summary, 28, 60
  6388.              Drives
  6389.            local, 80
  6390.  
  6391.  
  6392.                                   ICF REFERENCE MANUAL
  6393.  
  6394.  
  6395.  
  6396.              E
  6397.  
  6398.              Editing Keys, 16
  6399.              Environment variables, 26, 30
  6400.            ICF, 31
  6401.            ICFINI, 31
  6402.              Equip IDs, 15
  6403.              Equipment ID's, 15
  6404.              ESC, 16
  6405.              Experimental features, 32, 60
  6406.              Extensions
  6407.            in file names, 37
  6408.  
  6409.  
  6410.              F
  6411.  
  6412.              file attributes, 15
  6413.              File extensions, 37
  6414.              File san operations
  6415.            and /Entiredisk option, 73
  6416.              File Scan Operations, 18
  6417.              File scan operations
  6418.            and /Nofilesdefault option, 85
  6419.              File structures
  6420.            of output files, 38
  6421.              Files
  6422.            /Hide option, 78
  6423.            attribute codes, 62
  6424.            attributes, 87, 92
  6425.            AUTORUN.DAT, 49, 65
  6426.            comma delimited, 61
  6427.            Help files, 53
  6428.            output file naming, 74
  6429.            used for specifying options, 26
  6430.              FILES command, 19, 51
  6431.            /Sorte option, 97
  6432.              Filtering options, 12
  6433.  
  6434.  
  6435.              G
  6436.  
  6437.              Getting started, 2
  6438.  
  6439.  
  6440.              H
  6441.  
  6442.              HELP Command, 53
  6443.              Help files, 53
  6444.              Hidden, System, and Readonly attributes, 49
  6445.              Hints, 32
  6446.  
  6447.  
  6448.                                   ICF REFERENCE MANUAL
  6449.  
  6450.  
  6451.  
  6452.              I
  6453.  
  6454.              ICF environment variable, 31
  6455.              ICF.INI file, 26
  6456.              ICFDOS.EXE, 2
  6457.              ICFFILES file name, 37
  6458.              ICFHELP1.DBF file, 53
  6459.              ICFHELP2.DBF file, 53
  6460.              ICFINI environment variable, 27, 31
  6461.              ICFINV file name, 37
  6462.              ICFOS2.EXE, 2
  6463.              ICFPROG file name, 37
  6464.              ICFPROG1.DBF file, 53
  6465.              ICFPROGn files, 33
  6466.              ID Fields, 14, 17
  6467.              ID fields, 70, 81, 82, 91
  6468.            /Userid option, 99
  6469.            /Username option, 100
  6470.              Input files, 33
  6471.            for microchannel board recognition, 35
  6472.            for program recognition, 34
  6473.  
  6474.  
  6475.              L
  6476.  
  6477.              LAN
  6478.            changing output file name, 37
  6479.              Local drives, 80
  6480.              Location, 15
  6481.  
  6482.  
  6483.              M
  6484.  
  6485.              Making options permanent, 6, 20
  6486.              MCA, 79
  6487.              Microchannel
  6488.            /Ismca option, 79
  6489.            input recognition file, 35
  6490.              Miscid1, 17
  6491.              Miscid2, 17
  6492.              Modemid, 17
  6493.              Modifying ICF input files, 7
  6494.              Monitorid, 17
  6495.  
  6496.  
  6497.              N
  6498.  
  6499.              Naming
  6500.            of output files, 36
  6501.              Notes 1, 15
  6502.  
  6503.  
  6504.                                   ICF REFERENCE MANUAL
  6505.  
  6506.  
  6507.  
  6508.              O
  6509.  
  6510.              Options
  6511.            Cumulative Process Effects, 27
  6512.            drive options, 28, 60
  6513.            filtering, 12
  6514.            for testing, 29
  6515.            shortcut options, 27
  6516.            specification methods, 25
  6517.            specifying values for, 26
  6518.              Options Summary, 20
  6519.              Organization of manual, 1
  6520.              OS/2 version, 79
  6521.              Output file naming, 36, 74
  6522.              Output file structures, 38
  6523.            ID fields, 17
  6524.              Output files, 36
  6525.  
  6526.  
  6527.              P
  6528.  
  6529.              Paradox, 71
  6530.              Printerid, 17
  6531.              Program input files, 34
  6532.              Program scan operations, 11
  6533.              PROGRAMS command, 53
  6534.  
  6535.  
  6536.              R
  6537.  
  6538.              Recognizing programs, 13
  6539.              Running ICF, 3
  6540.  
  6541.  
  6542.              S
  6543.  
  6544.              Saving information in a file, 5
  6545.              Scanning for software programs, 11
  6546.              SET command (of DOS), 30
  6547.              SHIFT-TAB, 16
  6548.              Shortcut options, 27
  6549.              Specification methods of options, 25
  6550.              Standard file extensions, 37
  6551.              Starting ICF, 10
  6552.              STATUS command, 54
  6553.            /Ask option, 62
  6554.            and /Autodays option, 63
  6555.            output file structure, 40
  6556.              Summary of options, 20
  6557.              Syntax, 1
  6558.  
  6559.  
  6560.                                   ICF REFERENCE MANUAL
  6561.  
  6562.  
  6563.  
  6564.              T
  6565.  
  6566.              TAB, 16
  6567.              Testing options, 29
  6568.  
  6569.  
  6570.              U
  6571.  
  6572.              Underscore character, 53
  6573.              User ID, 15
  6574.              User Name, 15
  6575.              Userid, 17
  6576.              Username, 17
  6577.              Using ICF on a LAN, 6
  6578.              Using ICF Options, 20
  6579.  
  6580.  
  6581.              V
  6582.  
  6583.              Valid For, 1
  6584.  
  6585.  
  6586.                                   ICF REFERENCE MANUAL
  6587.  
  6588.  
  6589.            ICF REFERENCE MANUAL                  4.84. USERNAME OPTION