Home > Commands N-Z > Commands S

SETVER


Description | Syntax | Parameters | Switches | Related | Notes | Examples | Errorlevels | Availability

Displays the version table. Reports a earlier version number to programs or device drivers that were designed for earlier Versions of the operating system.

You can also use this command to display and modify the version table, which lists names of programs and the number of the operating system version with which they are designed to run. If you are using a program that has not been updated for this version of the operating system, you can add its name to the version table by using the SETVER command.

The operating system displays two columns: the left column lists the names of the program files; the right column lists the corresponding operating system version with which each file is set to run.


Syntax

SETVER [drive:path] filename n.nn

SETVER [drive:path] filename [/D[ELETE]] [/Q[UIET]]

To display the current version table:

SETVER [drive:path]


Parameters
drive: ( path v5.0 Win95 NT3.5)
Specifies the location of the SETVER.EXE file.
filename (v5.0 Win95 NT3.5)
Specifies the name of the program file (usually an .EXE or .COM file) that you want to add to the version table. You cannot use a wildcard character (* or ?).
n.nn (v5.0 Win95 NT3.5)
Specifies the DOS version number 2.11 to 9.99 to be reported by SETVER.EXE to the specified filename. The /DELETE and /QUIET options cannot be used with this option.

Switches
/D[ELETE] (v5.0 Win95 NT3.5)
Used to remove a file from the version table. You cannot use with n.nn.
/QUIET (v5.0 NT3.5)
/Q[UIET] (v7.00 Win95)
Used to keep DOS from displaying messages. You cannot use with n.nn.

Related

none.


Notes
SETVER confirmation

If you make changes to the version table and no errors are detected, the operating system displays the message:

    WARNING - Contact your software vendor for information about whether a
    specific program works with
    v6.22. It is possible that Microsoft
    has not verified whether the program will successfully run if you use
    the SETVER command to change the program version number and version
    table. If you run the program after changing the version table, you may
    lose or corrupt data or introduce system instabilities. Microsoft is not
    responsible for any loss or damage, or for lost or corrupted data.
    Version table successfully updated
    The version change will take effect the next time you restart your
    system.

Loading the version table into memory

Before you can use the SETVER command, the version table must be loaded into memory by a DEVICE command in your CONFIG.SYS file. By default, the operating system Setup program modifies your CONFIG.SYS file to ensure that the version table is loaded into memory each time you start your system.


Setting the version number of a command interpreter

You can use SETVER to set the version number of a command interpreter; however, if you set the version number of the v6.22 command interpreter (COMMAND.COM), you may not be able to start your system.


Using the version table

Many programs designed to run with a previous version of the operating system will run correctly with v6.22. In some cases, however, a program might not run correctly unless its name is included in the version table. The table indicates to the program that it is running with the operating system version for which it was designed, even though it is running with v6.22. By interpreting v6.22 as the earlier version, the program will probably run correctly; however, using SETVER will not solve the problem if the program is not compatible with v6.22.


Restarting after updating the version table

When you update the version table by adding or deleting entries, you must restart your system before the changes will take effect.


Updating existing entries

If you specify a filename that is already in the version table, the new entry replaces the existing entry.


Examples

Suppose you have a program file named MYPROG.EXE that runs with v3.30. To run MYPROG.EXE, you must first use the SETVER command to create an entry in the version table that will cause MYPROG.EXE to interpret v5.0+ as v3.30:

    SETVER MYPROG.EXE 3.30

To delete the MYPROG.EXE entry from the version table (without otherwise affecting the MYPROG.EXE file), type:

    SETVER MYPROG.EXE /D

To list the contents of the version table on drive C, type:

    SETVER C:

Errorlevels
Availability
External
DOS
v5.0 v5.0A v5.00.02 v5.001A v5.01 v5.02 v6.0 v6.10 v6.2 v6.21 v6.22 v6.23 v7.00 v7.0R1 v7.10 v8.00
Windows
Win95 Win98 WinME
Windows NT
NT3.5 NT4