Share via


Goto

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Goto

Within a batch program, directs command processing to a line identified by a label. When the label is found, processing continues starting with the commands that begin on the next line.

Syntax

goto Label

Parameters
  • Label
    Specifies the line in a batch program to which you want to go.
  • /?
    Displays help at the command prompt.
Remarks
  • Working with command extensions

    If command extensions are enabled (that is, the default) and you use the goto command with a target label of :EOF, you transfer control to the end of the current batch script file and exit the batch script file without defining a label. When you use goto with the :EOF label, you must insert a colon before the label. For example:

    goto :EOF

    For a description of extensions to the call command that make this feature useful, see cmd in Related Topics.

  • Using valid Label values

    You can use spaces in the Label parameter, but you cannot include other separators (for example, semicolons or equal signs).

  • Matching Label with the label in the batch program

    The Label value you specify must match a label in the batch program. The label within the batch program must begin with a colon (:). The Windows Server 2003 family recognizes a batch program line beginning with a colon (:) as a label and does not process it as a command. If a line begins with a colon, any commands on that line are ignored. If your batch program does not contain the label that you specify, the batch program stops and displays the following message:

             Label not found            
  • Using goto for conditional operations

    You can use goto with other commands to perform conditional operations. For more information about using goto for conditional operations, see if in Related Topics.

Examples

The following batch program formats a disk in drive A as a system disk. If the operation is successful, the goto command directs processing to the :end label:

echo off
format a: /s
if not errorlevel 1 goto end
echo An error occurred during formatting.
:end
echo End of batch program. 

Formatting legend

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Ellipsis (...)

Parameter that can be repeated several times in a command line

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

See Also

Concepts

Call
Cmd
If
Command-line reference A-Z
Command shell overview