WishMesh http://wishmesh.com Real men don't make backups Thu, 09 Oct 2014 18:49:47 +0000 en-US hourly 1 http://wordpress.org/?v=4.0 Stopping a DOS batch file http://wishmesh.com/2014/10/stopping-a-dos-batch-file/ http://wishmesh.com/2014/10/stopping-a-dos-batch-file/#comments Thu, 09 Oct 2014 18:48:22 +0000 http://wishmesh.com/?p=1290 This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).
Previous article: First cmd / DOS batch script example.

Usually, OS (Windows, MS-DOS) executes a batch file without stopping. DOS stops processing the batch file while the program runs when the batch file loads a program. As soon as you exit the program, or an automatic termination occurs, OS immediately continues processing the batch file from where it left off. Typically this is what you want, but sometimes you want to give the user time to think, react, and then take action. An example would be giving the user a group of choices that you want them to select from before proceeding.

PAUSE is the command we are looking for. PAUSE stops the batch file until almost any key is pressed. A key that would produce a character on the screen needs to be pressed. Therefore pressing a key like CTRL or ALT or SHIFT will not exit out of the pause state. Earlier we used this command above to see the output on the console. Now we will use this to pause the execution of the batch script.

Though the PAUSE command is really quite helpful, it lacks in power. The keystroke that you press is not capable of being used as a menu selection nor can it be saved in the program in any other way. Below is an example to illustrate how the PAUSE command works along with the ways of terminating a program with the keyboard.

:: PAUSE-IT.bat
:: Example of the PAUSE command
:: and the ways to exit out of a program.
ECHO The next command is a PAUSE
ECHO Do NOT press Ctrl+C or Ctrl+Break
ECHO Press Ctrl+C or Ctrl+Break on your keyboard

The first line is a comment with the name of the file. The second and third line comments are description of the program (batch file). The fourth line turns command-echoing off. Line 5 and 6 gives the first message about which keys you can press for the first example. Line 7 is the PAUSE command that stops the batch file until a key is pressed. The next line (8) displays the message about aborting the program using the keyboard controls. The last line (9) is the final PAUSE that finishes the program.

You can terminate this script in many ways, however, if you follow the ECHO instructions, then you will have the following output:

Batch file: press CTRL+Break CTRL+C
Batch file: press CTRL+Break CTRL+C

As you see in the screenshot, after pressing Ctrl+Break or Ctrl+C, the command interpreter asks you to “Terminate batch job (Y/N)?”. By pressing Y followed by the Enter, the batch file terminates.

This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).

http://wishmesh.com/2014/10/stopping-a-dos-batch-file/feed/ 0
First cmd / DOS batch script example http://wishmesh.com/2014/10/first-cmd-dos-batch-script-example/ http://wishmesh.com/2014/10/first-cmd-dos-batch-script-example/#comments Mon, 06 Oct 2014 16:12:43 +0000 http://wishmesh.com/?p=1263 console-screen
Photo: freeimages.com

This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).

Previous article: What is a batch script?
Next article: Stopping a DOS batch file

Now we are familiar with the command prompt. Batch scripts are one or more DOS commands that are executed sequentially, and the script is written using a text editor. This does not mean you can use Microsoft Word or Google Docs or any other of those fancy programs you might use to type up a report. Those types of programs are called word processors, not text editors. Besides the obvious that these programs allow you to change colors and import graphics, these programs add extra formatting that you don’t see.

A great example of a text editor is Notepad. Notepad comes bundled up with Microsoft operating systems (or better choice is open source editor – Notepad++ which supports syntax highlighting). To access Notepad simply click the Start button followed by the Programs option. Next, click on Accessories which is usually at the top of the column. The next pop-up column should contain the Notepad program option. Or on newer Windows, hit Start, and type Notepad.

Search - Notepad on Windows 8.1
Search – Notepad on Windows 8.1

A helpful hint is to make a shortcut to the Notepad in your desktop or Taskbar by right-clicking on the Notepad option (or Pin to Taskbar on the newer Windows). Subsequently select Send To followed by selecting Desktop (Create a Shortcut). This allows quick access in the future by placing an icon on your desktop. A shortcut can also be made using batch.

At this point I highly recommend to download the Notepad++, or change Folder options in the Windows, to see file extensions, so you can easily change .txt file extension to the .bat for the batch files.

Notepad++ editing .bet file under Windows 8.1
Notepad++ editing .bet file under Windows 8.1

Now that we have the Notepad open we can begin scripting. Let’s begin by printing the words Hello World to the screen. Type the following into Notepad screen. Then save our new text file as helloworld.bat or my-first-batch-script.bat, or anything you like.

@Echo off
Rem helloworld.bat

:: Next line prints Hello World to the screen
Echo Hello World


Now let’s explain what each line does.

The computer has a habit of taking everything you type and storing it verbatim. This can be annoying and troublesome at first however you will soon realize that predictability is nice. Anyway, this means that all commands will be seen by the end-user. This makes for a very ugly and bothersome execution.

To circumvent this we will type @ECHO OFF at the first line. ECHO OFF makes sure that command echoing is turned off. This fixes our previous problem. However, it creates a new one. ECHO OFF is a command thus it will also be seen. That is where the use the @ (at) sign comes in. This stops the echo of the ECHO OFF command. If you were to leave the @ sign out you would see ECHO OFF above your Hello World message as part of your output.

The majority of the batch scripts have this snippet of code at the beginning. You can also turn echoing back on if you like by using the command ECHO ON. If you type ECHO by itself the status of ECHO will be displayed. The ECHO OFF command only turns off command echoing. The output from the DOS commands will still be seen.

When you copy a file in a batch file, you will still see the 1 File(s) copied message. If you use a batch file to start a GUI program, that program will indeed appear on the screen (For example, Calculator, Notepad, MS Word, MS Excel). ECHO OFF turns off batch file commands seen in the console while that specific batch file is running.

Here is a screenshot of your first batch file’s output:

Hello World.bat output
Hello World.bat output

The ECHO command is great for communicating with the user. Messages and questions can be easily delivered to the end-user. This is great for giving the user a list of choices and wanting feedback before a particular action is performed. Try experimenting with different formats for delivering messages to the user. For example, centering the text using spaces (this works because most consoles uses fixed-width fonts by default). Or adding hyphens and exclamation marks for borders:

@echo off

echo ---------------------------------
echo !     Your hello message...     !
echo ---------------------------------

Using fixed width fonts in the console
Using fixed width fonts in the console

You can create a line break, a blank line, by typing ECHO. but notice the period mark after the echo command. The ECHO and period combination is what creates the line break. Example:

REM helloworld.bat
:: Prints 'Hello World' to the screen...
:: with a line break in between the words.
ECHO Hello
ECHO World

Lines 2, 3 and 4 in this batch file example are comments or remark statements. When writing batch scripts you will want to place two comments at the top of the file. Coding standard style should be in place, which improves the quality of software which results in fewer bugs which is easier to maintain and use. The first line should contain the name of the file and the second remark statement should include a brief statement about the following program. This helps yourself when you start writing many batch files and it also helps someone else (for example, your colleagues) read your script that might not be as familiar with it as you. This could perhaps be the case of having a friend debug your file.

The first remark statement has the REM signifying a remark. Such remarks are used in every programming language to add comments to your code. Since your first batch scripts will be smaller programs, we won’t need very many remark statements, though it is a good idea to get in the habit of documenting your scripts well. Remark statements are ignored by DOS. Notice the :: (two colons) in the next remark statement. This is another way of commenting your batch scripts. The double colon approach is a better way of commenting your code because the command prompt will entirely ignore this line making your program run faster.

Yes, REM is ignored however the command prompt takes a more detailed approach at reading the comment and it takes a longer amount of time to execute (not relevant on modern PC). The double colon makes for a quicker program. This gives you advantages when you start building more complicated programs and you start adding more of them. For the preceding reasons we will not use the REM command rather we will use the double colons when commenting our code.

Another characteristic of batch scripting is that line breaks (spaces between lines) in your batch file are ignored. Here they are used merely for readability. Notice the two above / previous examples each have a different line break scheme. The first implements a double space layout for better readability. The second is more compact.

ECHO is similar to the PRINT command in other programming languages. ECHO is used for displaying a string of text to the screen.

Finally, we have the PAUSE command. Your program will run just fine without this. However, you will not be able to see your output; the text Hello World in this example. If you include the PAUSE command you will see the text string Press any key to continue… If you do not include this command the command prompt may appear, then flash away quickly (depends on how you run batch scripts). Run the program without this and note the difference (first run by double clicking mouse, second – from the CMD.exe console).

Note that batch commands are usually not case sensitive. All caps are shown in this article to help you identify the batch code. When an instance arises where case-sensitivity will matter it will be explained.

This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).

Edit Oct 9, 2014: Updated formatting and added link to the next article.

http://wishmesh.com/2014/10/first-cmd-dos-batch-script-example/feed/ 0
What is a batch script? http://wishmesh.com/2014/09/what-is-a-batch-script/ http://wishmesh.com/2014/09/what-is-a-batch-script/#comments Fri, 26 Sep 2014 16:04:30 +0000 http://wishmesh.com/?p=1250 This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).

Previous article: MS-DOS (cmd.exe) command prompt: CD, MD, copy.
Next article: First cmd / DOS batch script example.

Batch scripts is still relevant in 2014. Batch programming is repeatedly used in Windows server and workstation administration to make recurrent tasks easier and more efficient.

In the MS-DOS, Windows 95 and Windows 98, and nowadays in the DOSBox the most popular batch file is autoexec.bat. This file was appropriately named after AUTOmatic EXECution. Commands that are to be executed when DOS starts are placed in this special file particularly on systems that utilize the PROMPT and PATH commands. When pure DOS was the prevalent operating system this was important, however, on our newer Windows guided machines, this is really not of concern. The PATH environment variable can be modified from the System properties – Environment variables.

Environment variables - PATH - Windows 8.1
Environment variables – PATH – Windows 8.1

For creating and editing a batch file, I recommend to use Windows Notepad, or more advanced editor with syntax highlighting support, such as free and open source editor – Notepad++. You will save your batch files with a .bat or .cmd file extension. Some of the file naming conventions (requirements) for batch files include: not recommended to use any internal DOS commands for file names for example, ECHO.bat, ERASE.bat, PAUSE.bat, etc., and SPACES, and device names such as LPT, COM1, COM2, NUL, etc., and it is NOT OKAY to use the following special characters in a filename:

  1. \ – Backslash
  2. / – Slash
  3. : – Colon
  4. ? – Question mark
  5. * – Asterisk
  6. ” – Quotes
  7. < - Less than sign
  8. > – Greater than sign
  9. | – Pipe

The period must be used as the separator between the file name and the file extension. The colon is specifically used after a letter to identify a particular disk drive. The asterisk and question mark are special wild card characters. Be careful when using these two characters in your script as they can act on multiple files / folders, and with not planed carefully, do some very unpredictable things. The greater than sign, the less than sign and the pipe are special DOS commands to be discussed in the next articles. They are also illegal file names. When naming a DOS file you have even more restrictions.

It should also be noted that good recommended practice for batch file names is to not save them as the same name as another executable file with a different extension. If you already have a file named email.exe do not try to save the batch file as email.bat.

The format for batch files is a series of DOS commands on separate lines. Example:
First Command
Second Command
Third Command
Fourth Command
And so on...

Four types of commands are acceptable for a batch file. These are:

  1. internal commands
  2. .exe program names
  3. .com program names
  4. .bat / .cmd file names

As with any DOS procedure you can stop a batch program from executing by pressing CTRL+C or CTRL+Break key combination on the keyboard. DOS will ask if you wish to Terminate batch job (Y/N)?. Type N to skip the command you broke out of and proceed to the next command in the batch file. Press Y to abort execution of the batch file and return to the command prompt. Pressing ^Break will produce the same results as ^C (except some commands, like PING).

The last command that we will go over in this section is the VER command. VER stands for VERsion. Enter this into the command prompt and you will be presented with the current version of your DOS program / Operating System.

The VER command displays the operating system version number
The VER command displays the operating system version number

This article is from our Febooti archive, it was relevant then, and I think that it is still relevant today (a few details changed).

Update Oct 6, 2014: added link to the next article.

http://wishmesh.com/2014/09/what-is-a-batch-script/feed/ 0