06/09/94 CONVERT Version 2.0. ____________________ I. CONVERT Help Screen Usage: CONVERT [options] [ ] Options: /NETWORK Check files on network drives for validation data. /REMOVE Remove old validation data. /VALIDATE Replace old validation data by new ones. Full path name of ASCII file to convert. Full path name of the old SCAN. 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 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: and are identical. 2. If unknown for old SCAN option specified CONVERT gives an error message: Invalid option: