Correct Testing Precedence of Batch File ERRORLEVELs (39585)


The information in this article applies to:

  • Microsoft MS-DOS operating system 2.11
  • Microsoft MS-DOS operating system 3.1
  • Microsoft MS-DOS operating system 3.2
  • Microsoft MS-DOS operating system 3.21
  • Microsoft MS-DOS operating system 3.3
  • Microsoft MS-DOS operating system 3.3a
  • Microsoft MS-DOS operating system 4.0
  • Microsoft MS-DOS operating system 4.01
  • Microsoft MS-DOS operating system 5.0
  • Microsoft MS-DOS operating system 5.0a
  • Microsoft MS-DOS operating system 6.0
  • Microsoft MS-DOS operating system 6.2
  • Microsoft MS-DOS operating system 6.21
  • Microsoft MS-DOS operating system 6.22
This article was previously published under Q39585

SUMMARY

When you use multiple IF ERRORLEVEL statements in batch files, the order in which the ERRORLEVELs are tested numerically is important. The correct order is descending (highest to lowest). This ordering is from the way ERRORLEVELs are tested. The IF condition is set to TRUE when the ERRORLEVEL is equal to, or greater than, the ERRORLEVEL number.

MORE INFORMATION

The following batch file fragment demonstrates this INCORRECT behavior: 
   rem (execute a program which returns an errorlevel of 0 or 1)
   if errorlevel 0 goto ZERO
   if errorlevel 1 goto ONE
   goto END
   :ZERO
     echo a Zero was returned!
     goto END
   :ONE
     echo a One was returned!
   :END
The above example always branches to the "ZERO" label, regardless of success or failure. This example would work correctly if the ERRORLEVEL testing was made in descending order.

The CORRECT way to write such a batch file is as follows: 
   rem (execute a program which returns an errorlevel of 0 or 1)
   if errorlevel 1 goto ONE
   if errorlevel 0 goto ZERO
   goto END
   :ZERO
     echo a Zero was returned!
     goto END
   :ONE
     echo a One was returned!
   :END
Modification Type:MajorLast Reviewed:5/12/2003
Keywords:KB39585
©2002 Microsoft Corporation. All rights reserved.