- Batch Script Tutorial
- Batch Script - Home
- Batch Script - Overview
- Batch Script - Environment
- Batch Script - Commands
- Batch Script - Files
- Batch Script - Syntax
- Batch Script - Variables
- Batch Script - Comments
- Batch Script - Strings
- Batch Script - Arrays
- Batch Script - Decision Making
- Batch Script - Operators
- Batch Script - DATE & TIME
- Batch Script - Input / Output
- Batch Script - Return Code
- Batch Script - Functions
- Batch Script - Process
- Batch Script - Aliases
- Batch Script - Devices
- Batch Script - Registry
- Batch Script - Network
- Batch Script - Printing
- Batch Script - Debugging
- Batch Script - Logging
- Batch Script Resources
- Batch Script - Quick Guide
- Batch Script - Useful Resources
- Batch Script - Discussion
- Selected Reading
- UPSC IAS Exams Notes
- Developer's Best Practices
- Questions and Answers
- Effective Resume Writing
- HR Interview Questions
- Computer Glossary
- Who is Who
Batch Script - Debugging
Debugging a batch script becomes important when you are working on a big complex batch script.
Following are the ways in which you can debug the batch file.
Using echo command
A very simple debug option is to make use of echo command in your batch script wherever possible. It will display the message in the command prompt and help you debug where things have gone wrong.
Here is a simple example that displays even numbers based on the input given. The echo command is used to display the result and also if the input is not given. Similarly, the echo command can be used in place when you think that the error can happen. For example, if the input given is a negative number, less than 2, etc.
@echo off if [%1] ==  ( echo input value not provided goto stop ) rem Display numbers for /l %%n in (2,2,%1) do ( echo %%n ) :stop pause
C:\>test.bat 10 2 4 6 8 10 22 Press any key to continue ...
Using pause command
Another way is to pause the batch execution when there is an error. When the script is paused, the developer can fix the issue and restart the processing.
In the example below, the batch script is paused as the input value is mandatory and not provided.
@echo off if [%1] ==  ( echo input value not provided goto stop ) else ( echo "Valid value" ) :stop pause
C:\>test.bat input value not provided Press any key to continue..
Logging the error messages to another file
It might get hard to debug the error just looking at a bunch of echo displayed on the command prompt. Another easy way out is to log those messages in another file and view it step by step to understand what went wrong.
Here is an example, consider the following test.bat file:
net statistics /Server
The command given in the .bat file is wrong. Let us log the message and see what we get.
Execute the following command in your command line:
C:\>test.bat > testlog.txt 2> testerrors.txt
The file testerrors.txt will display the error messages as shown below:
The option /SERVER is unknown. The syntax of this command is: NET STATISTICS [WORKSTATION | SERVER] More help is available by typing NET HELPMSG 3506.
Looking at the above file the developer can fix the program and execute again.
Using ErrorLevel to detect errors and log them
Errorlevel returns 0 if the command executes successfully and 1 if it fails.
Consider the following example:
@echo off PING google.com if errorlevel 1 GOTO stop :stop echo Unable to connect to google.com pause
During execution, you can see errors as well as logs:
C:\>test.bat > testlog.txt
Pinging google.com [18.104.22.168] with 32 bytes of data: Reply from 22.214.171.124: bytes=32 time=160ms TTL=111 Reply from 126.96.36.199: bytes=32 time=82ms TTL=111 Reply from 188.8.131.52: bytes=32 time=121ms TTL=111 Reply from 184.108.40.206: bytes=32 time=108ms TTL=111 Ping statistics for 220.127.116.11: Packets: Sent = 4, Received = 4, Lost = 0 (0% loss), Approximate round trip times in milli-seconds: Minimum = 82ms, Maximum = 160ms, Average = 117ms Connected successfully Press any key to continue . . .
In case of failure, you will see the following logs inside testlog.txt.
Ping request could not find host google.com. Please check the name and try again. Unable to connect to google.com Press any key to continue . . .