
                                                   06/09/94
                    CONVERT Version 2.0.
                    ____________________

  I. CONVERT Help Screen

       Usage: CONVERT [options] [<pathname1> <pathname2> <pathname3>]
       Options:

         /NETWORK     Check files on network drives for validation data.
         /REMOVE      Remove old validation data.
         /VALIDATE    Replace old validation data by new ones.

       <pathname1>    Full path name of ASCII file to convert.
       <pathname2>    Full path name of the old SCAN.
       <pathname3>    Full path name of the new SCAN.

    Examples:
     1.CONVERT C:\BAT\CHECK.BAT C:\\OLDSCAN\SCAN.EXE C:\NEWSCAN\SCAN.EXE
     2.CONVERT C:\BAT\CHECK.BAT C:\OLDSCAN\VSHIELD.EXE C:\NEWSCAN\VSHIELD.EXE
     3.CONVERT /NETWORK /VALIDATE
     4.CONVERT /NETWORK C:\AUTOEXEC.BAT D:\MCAFEE\SCAN.EXE D:\PH\SCAN.EXE

  II.Description
  _______________

          CONVERT is a program developed by McAfee, Inc. to change
          batch files, network login scripts, and other ASCII text
          files used to run VIRUSCAN/VSHIELD  from their old options
          to the new set of option names used by VIRUSCAN/VSHIELD(TM)
          Version 2.0.

          CONVERT will read an ASCII text file and search it for
          references to VIRUSCAN/VSHIELD.  When it comes across a
          command to run SCAN/VSHIELD in the file it will replace
          them with a new set of options which match the old options
          as closely as possible.

          If you use CONVERT to convert any ASCII file it needs to
          be run with:
              a) the name of the batch file, network login script,
                 or other ASCII text file to be changed;
              b) the full pathname of the old SCAN;
              c) the full pathname of the new SCAN;

          In this case using any options is optional.

          CONVERT will automatically save the original ASCII file with
          the .OLD extension.

          Each time CONVERT finds a SCAN/VSHIELD option, it will inform
          the user about the changes made. CONVERT will check the presence
          of some options ( Tabl 2 ) and add any needed options. After
          CONVERT has  examined the text file, it will  allow you to review
          the changes before writing the changed file to disk.

          CONVERT can be used as a separate utility to check all local
          drives ( default ) and all network ( /NETWORK ) for old
          validation data, remove them, and add the new validation
          data.  In this case you do not have to specify any path names
          on CONVERT command line ( Example #3 );

  III.Options
  ____________

     1. If  /REMOVE option specified CONVERT will check all files
        on all local drives for validation data added by old SCAN with
        either /AG or /AV option and remove them.

     2. If  /VALIDATE option specified CONVERT will check all files on
        all local drivers for old validation data, remove them and add
        the new validation data ( 98 bytes ).

     3. /VALIDATE and /REMOVE are incompatible options. If both of them
        specified on command line CONVERT will give an error message.

     4. If /NETWORK option specified all network and local drives will
        be checked. This option requers another option or pathes to be
        specified on CONVERT command line.

  IV. How CONVERT manages some situations
  _______________________________________

   1. CONVERT adds to the new SCAN/VSHIELD command line information
      from old SCAN/VSHIELD command line found before file name of
      the old SCAN/VSHIELD.

      For example : # d:\mcafee\scan   ->  # d:\phoenix\scan.exe
                    @scan...           ->  @d:\newscan\scan...
                    # command scan...  ->  # command d:\newscan\scan...

   2. If VSHIELD command line was converted CONVERT starts looking
      for a reference to CHKSHLD. If it was found CONVERT changes the
      name to CHKVSHLD and gives the following message:

      WARNING:  Converted file contains a reference to CHKSHLD.
                This name will be changed to CHKVSHLD.

   3. If SCAN command line was converted CONVERT starts looking
      for any refernces to the old SCAN errorlevels. It checks
      8 next lines for it. If the reference found CONVERT comments
      the line and gives the message:

      IF ERRORLEVEL 1 GOTO VIRUS
      WARNING:  This line contains a reference to the old SCAN
                errorlevel and will be commented.
                Errorlevels of the new SCAN are different.
                See your user manual for more information.

      As a result the following line will be written:

      rem IF ERRORLEVEL 1 GOTO VIRUS

   6. If /AV option on SCAN command line contains <filename>
      CONVERT will add /EXCLUDE option and give the message:

      /EXCLUDE    Option is added to the new SCAN command line.
                  This option allows to exclude files listed in
                  specified after /EXCLUDE file from adding
                  validation information by SCAN with /AV option.

      Example:
              Old line: ...scan /av d:\mcafee\excl.dat...
              New line: ...SCAN /AV /EXCLUDE D:\MCAFEE\EXCL.DAT...

   7. If either /RV or /RG was found  on the old SCAN command line
      CONVERT will check ( by default ) all local drives and remove
      old validation data.

      7.1. If /NETWORK option was specified on CONVERT command line
           in additional all network drives will be processed the same
           way.
      7.2. If /VALIDATE option was specified on CONVERT command line
           CONVERT will replace old validation data with the new ones.
           It means that priority of CONVERT options is higher.

   8. If /CV was found  on the old SCAN/VSHIELD command line
      CONVERT will check ( by default ) all local drives, remove
      old validation data, and add the new validation data ( 98 bytes ).

      8.1. If /NETWORK option was specified on CONVERT command line
           in additional all network drives will be processed the same
           way.
      8.2. If /REMOVE option was specified on CONVERT command line
           CONVERT will ONLY  remove old validation data.
           It means that priority of CONVERT options is higher.

   9. If /CG was found  on the old SCAN/VSHIELD command line
      CONVERT will check ( by default ) all local drives, and remove
      old validation data.

      9.1. If /NETWORK option was specified on CONVERT command line
           in additional all network drives will be processed the same
           way.
      9.2. If /VALIDATE option was specified on CONVERT command line
           CONVERT will replace the old validation data with the new
           ones.
           It means that priority of CONVERT options is higher.

   10. All information displayed on the screen is written into
      report file CONVERT.RPT by default. If you run CONVERT
      several times all new reports will be appended to the
      previous ones.


  V. Messages
  ____________

              Messages for converting SCAN command line
                                                            Table 1
 _________________________________________________________________________
 Old Scan    New Scan         Action / Explanation
 options     options
 _________________________________________________________________________

 /A         Default         Removed from the SCAN command line.
                            This option is no longer needed.
                            All files are scanned for viruses default.

 /AD        /ADL /ADN       Replaced by /ADL /ADN options.
                            This option is nolonger used.

 /ADL       /ADL            Transferred with no chanege.

 /ADN       /ADN            Transferred with no change.

 /AF        /AF             Transferred with no change.

 /AG        /AG             Removed from the SCAN command line.
                            This option is no longer used.
                            Use of the SCAN 2.0  /AF, /CF, and /RF options
                            is recommended.

 /AV        /AV             Transferred with no changes.

 /BELL      None            Removed from the SCAN command line.
                            This option is no longer used.
                            Please see your user manual for more information.

 /BMP       None            Removed from the SCAN command line.
                            This option is no longer needed.
                            The OS/2 Boot Manager Partition is scanned
                            by default.

 /CERTIFY   /CERTIFY        Removed from the SCAN command line.
                            This option is not implemented yet.

 /CF        None            Removed from the SCAN command line.
                            This option should be used only after running
                            the SCAN 2.0 with /AF option.
                            Please see your user manual for more information.

 /CG        None            Removed from the SCAN command line.
                            Option is no longer used.
                            Use of the SCAN 2.0 /AF, /CF, /RF options is
                            recommended.
                            Old validation data will be removed.

 /CHKHI     Default         Removed from the SCAN command line.
                            This option is no longer needed.
                            High memory is scanned for viruses by default.

 /CV        None            Removed from the SCAN command line.
                            Old validate data will be replaced by new ones.
                            Please see your user manual for more information.

 /D         /DEL            Replaced by the /DEL option.

 /DATE      /LOG            Replaced by the /LOG option.

 /EXT       None            Removed from the SCAN command line.
                            This option is no longer used.
                            We support more friquent updates of external
                            data file.

 /HISTORY   /APPEND         Replaced by the /APPEND option.

 /M         None            Removed from the SCAN command line.
                            This option is no longer used.
                            Memory is scanned for viruses by default.

 /MAINT     None            Removed from the SCAN command line.
                            This option is no longer needed.
                            Corrupted boot sectors are scanned by default.

 /NLZ       None            Removed from the SCAN command line.
                            This option is not implemented yet.

 /NOBREAK   /NOBREAK        Transfrred with no change.

 /NOEXPIRE  None            Removed from the SCAN command line.
                            This option is not implemented yet.

 /NOMEM     /NOMEM          Transferred with no change.

 /NOPAUSE   None            Removed from the SCAN command line.
                            This option is no longer needed.
                            SCAN dispays messages without pousing by default.

 /REPORT    /REPORT         Transfered with no change.

 /RF        None            Removed from the SCAN command line.
                            This option should be used only after running
                            the SCAN 2.0.with /AF option.
                            Please see your user manual for more information.

 /RG        None            Removed from the SCAN command line.
                            This option is no longer used.
                            Use of the SCAN 2.0 /AF, /CF, /RF options is recommended.
                            Old validation data will be removed.

 /RV        None            Transferred with no change.
                            Old validation data will be removed.

 /SAVE      None            Option removed from SCAN command line.
                            Option is no longer used.
                            Use any editor to create a file containing SCAN options
                            and specify that file with  /LOAD option.

 /SHOWDATE  /LOG            Replaced by the /LOG option.

 /SUB       /SUB           Transferred with no change.

 @          /LOAD          Replaced by the /LOAD option.
                           Note: Files created for the old @ option require
                           minor formatting changes to work with the new
                           /LOAD option.
 ____________________________________________________________________________


         Messages for adding some option to the new SCAN          Table 2
 _________________________________________________________________________
 Old Scan    New Scan         Action / Explanation
 options     options
 not found   to add
 _________________________________________________________________________


 /A         /STD           Option not found on old SCAN command line.
                           /STD option added to the SCAN 2.0 command line.

 /NOPAUSE   /PAUSE         Option not found on old SCAN command line.
                           /PAUSE option added to the SCAN 2.0 command line.

 __________________________________________________________________________


              Messages for converting VSHIELD                      Table 3
 _________________________________________________________________________
 Old Vshield   New Vshield      Action / Explanation
 options       options
 _________________________________________________________________________

 /ACCESS       /ANYACCESS     Replaced by /ANYACCESS options.
                              This option is no longer used.

 /BOOT         /BOOTACCESS    Replaced by /BOOTACCESS option.
                              This option is no longer used.

 /CERTIFY      /CERTIFY       Removed from the VSHIELD command line.
                              This option should be used only after running
                              SCAN 2.0 with either the /AF or /AV option.
                              Please see your user manual for more information.

 /CF           None           Removed from the VSHIELD command line.
                              This option should be used only after running
                              SCAN 2.o with the /AF option.
                              Please see your user manual for more information.

 /CG           None           Removed from the VSHIELD command line.
                              Option is no longer used.
                              Use of the SCAN 2.0 /AF, /CF, /RF options is
                              recommended.
                              Old validation data will be removed.

 /CHKHI        None           Removed from the VSHIELD command line.
                              This option is no longer needed.
                              High memory is scanned for viruses by default.

 /CONTACT      /CONTACT       Transferred with no change.

 /COPY         /ANYACCESS     Replaced by the /ANYACCESS options.
                              This option is no longer used.

 /CV           None           Transferred with no changes.
                              Old validation data will be removed.

 /IGNORE       /IGNORE        Transferred with no change.

 /LH           None           Removed from the VSHIELD command line.
                              This option is no longer needed.
                              VSHIELD is loaded into UMB by default.

 /LOCK         /LOCK          Transferred with no changes.

 /M            None           Removed from the VSHIELD command line.
                              This option is no longer used.
                              Memory is scanned for viruses by default.

 /NB           None           Removed from the VSHIELD command line.
                              This option is no longer used.

 /NI6510       None           Removed from the VSHIELD command line.
                              This option is no longer used.

 /NOBREAK      None           Removed from the VSHIELD command line.
                              This option is no longer needed.
                              VSHIELD disables Ctrl-Break by default.

 /NOCONT       None           Removed from the VSHIELD command line.
                              This option is no longer used.

 /NODISK       None           Removed from the VSHIELD command line.
                              This option is no longer used.

 /NOFLOPPY     None           Removed from the VSHIELD command line.
                              This option is no longer used.

 /NOEMS        /NOEMS         Transferred with no change.

 /NOMEM        /NOMEM         Transferred with no changes.

 /NOREMOVE     /NOREMOVE      Transferred with no change.

 /ONLY         /ONLY          Transferred with no change.

 /RECONNECT    /RECONNECT     Transferred with no change.

 /SAVE         /SAVE          Transferred with no change.

 /SWAP         /SWAP          Transferred with no change.

 /F                           Removed from the VSHIELD command line.
                              This option is no longer used.

 /WINDOWS                     Removed from VSHIELD command line.
                              Option is no longer used.

  VI. Error Messages
  __________________

   1. If the new SCAN/VSHIELD pathname and the old SCAN pathname
      are identical CONVERT gives an error message:

         <pathname1> and <pathname2> are identical.

   2. If unknown for old SCAN option specified CONVERT gives an
      error message:

         Invalid option: <option>

      and skips the line containing invalid option.

   3. If the file(s) specified on CONVERT command line does not exist
      CONVERT gives an error message:

         <pathname> not found.

   4. If no pathes were specified on CONVERT command line and only
      one option /NETWORK was specified CONVERT gives the messae:

         Option /NETWORK is used incorrectly.
         This option requires more arguments on CONVERT command line.

   5. If /VALIDATE and /REMOVE options are specified in the same command
      line CONVERT gives the error message:

          Incompatible options: /REMOVE /VALIDATE





      VALIDATION CODES FOR INCLUDED PROGRAMS:


CONVERT  EXE     81420  07-21-94   8:27a   709C   B83B
VALIDATE EXE     15958  03-31-94  12:41p   6371   071A
OS2VAL   EXE     51264  04-01-94   9:06p   90A5   1A25
