COMMAND.COM

COMMAND.COM
	COMMAND.COM in Windows 8
Other names	MS-DOS Prompt,; Windows Command Interpreter
Developer(s)	Seattle Computer Products, IBM, Microsoft, The Software Link, Datalight, Novell, Caldera
Initial release	1980
Written in	x86 assembly language[1]
Operating system	86-DOS; MS-DOS; PC DOS; DR-DOS; SISNE plus; PTS-DOS; ROM-DOS; OS/2; Windows 9x; Windows NT (NTVDM); FreeDOS; MSX-DOS;
Platform	16-bit x86
Successor	cmd.exe
Type	Command-line interpreter

COMMAND.COM is the default command-line interpreter for MS-DOS, Windows 95, Windows 98, Windows 98SE and Windows Me. In the case of DOS, it is the default user interface as well. It has an additional role as the usual first program run after boot (init process), hence being responsible for setting up the system by running the AUTOEXEC.BAT configuration file, and being the ancestor of all processes.

command.com running in a Windows console on Windows 95 (MS-DOS Prompt)

COMMAND.COM's successor on OS/2 and Windows NT systems is cmd.exe, although COMMAND.COM is available in virtual DOS machines on IA-32 versions of those operating systems as well.

The COMMAND.COM filename was also used by Disk Control Program (DCP), an MS-DOS derivative by the former East German VEB Robotron.[2]

The compatible command processor under FreeDOS is sometimes also named FreeCom.

COMMAND.COM is a DOS program. Programs launched from COMMAND.COM are DOS programs that use the DOS API to communicate with the disk operating system.

Operating modes

As a shell, COMMAND.COM has two distinct modes of operation. The first is interactive mode, in which the user types commands which are then executed immediately. The second is batch mode, which executes a predefined sequence of commands stored as a text file with the .BAT extension.

Internal commands

Internal commands are commands stored directly inside the COMMAND.COM binary. Thus, they are always available but can only be executed directly from the command interpreter.

All commands are executed after the ↵ Enter key is pressed at the end of the line. COMMAND.COM is not case-sensitive, meaning commands can be typed in any mixture of upper and lower case.

BREAK: Controls the handling of program interruption with Ctrl+C or Ctrl+Break.
CHCP: Displays or changes the current system code page.
CHDIR, CD: Changes the current working directory or displays the current directory.
CLS: Clears the screen.
COPY: Copies one file to another (if the destination file already exists, MS-DOS asks whether to replace it). (See also XCOPY, an external command that could also copy directory trees).
CTTY: Defines the device to use for input and output.
DATE: Display and set the date of the system.
DEL, ERASE: Deletes a file. When used on a directory, deletes all files inside the directory only. In comparison, the external command DELTREE deletes all subdirectories and files inside a directory as well as the directory itself.
DIR: Lists the files in the specified directory.
ECHO: Toggles whether text is displayed (ECHO ON) or not (ECHO OFF). Also displays text on the screen (ECHO text).
EXIT: Exits from COMMAND.COM and returns to the program which launched it.
LFNFOR: Enables or disables the return of long filenames by the FOR command. (Windows 9x).
LOADHIGH, LH: Loads a program into upper memory (HILOAD in DR DOS).
LOCK: Enables external programs to perform low-level disk access to a volume. (MS-DOS 7.1 and Windows 9x only)
MKDIR, MD: Creates a new directory.
PATH: Displays or changes the value of the PATH environment variable which controls the places where COMMAND.COM will search for executable files.
PROMPT: Displays or change the value of the PROMPT environment variable which controls the appearance of the prompt.
RENAME, REN: Renames a file or directory.
RMDIR, RD: Removes an empty directory.
SET: Sets the value of an environment variable; without arguments, shows all defined environment variables.
TIME: Display and set the time of the system.
TRUENAME: Display the fully expanded physical name of a file, resolving ASSIGN, JOIN and SUBST logical filesystem mappings.[3]
TYPE: Display the content of a file on the console.
UNLOCK: Disables low-level disk access. (MS-DOS 7.1 and Windows 9x only)
VER: Displays the version of the operating system.
VERIFY: Enable or disable verification of writing for files.
VOL: Shows information about a volume.

Batch file commands

Control structures are mostly used inside batch files, although they can also be used interactively.[4][3]

:label: Defines a target for GOTO.
CALL: Executes another batch file and returns to the old one and continues.
FOR: Iteration: repeats a command for each out of a specified set of files.
GOTO: Moves execution to a specified label. Labels are specified at the beginning of a line, with a colon (:likethis).
IF: Conditional statement, allows branching of the program execution.
PAUSE: Halts execution of the program and displays a message asking the user to press any key to continue.
REM: comment: any text following this command is ignored.
SHIFT: Replaces each of the replacement parameters with the subsequent one (e.g. %0 with %1, %1 with %2, etc.).

IF command

On exit, all external commands submit a return code (a value between 0 and 255) to the calling program. Most programs have a certain convention for their return codes (for instance, 0 for a successful execution).[5][6][7][8]

If a program was invoked by COMMAND.COM, the internal IF command with its ERRORLEVEL conditional can be used to test on error conditions of the last invoked external program.

Under COMMAND.COM, internal commands do not establish a new value.

Variables

Batch files for COMMAND.COM can have four kinds of variables:

Environment variables: These have the %VARIABLE% form and are associated with values with the SET statement. Before DOS 3 COMMAND.COM will only expand environment variables in batch mode; that is, not interactively at the command prompt.
Replacement parameters: These have the form %0, %1...%9, and initially contain the command name and the first nine command line parameters passed to the script (e.g., if the invoking command was "myscript.bat John Doe", then %0 is "myscript.bat", %1 is "John" and %2 is "Doe"). The parameters to the right of the ninth can be mapped into range by using the SHIFT statement.
Loop variables: Used in loops, they have the %%a format when run in batch files. These variables are defined solely within a specific FOR statement, and iterate over a certain set of values defined in that FOR statement.
Under Novell DOS 7, OpenDOS 7.01, DR-DOS 7.02 and higher, COMMAND.COM also supports a number of system information variables,[4][9][3] a feature earlier found in 4DOS 3.00 and higher[10] as well as in Multiuser DOS,[3] although most of the supported variable names differ.

Redirection, piping, and chaining

Because DOS is a single-tasking operating system, piping is achieved by running commands sequentially, redirecting to and from a temporary file. COMMAND.COM makes no provision for redirecting the standard error channel.

command < filename: Redirect standard input from a file or device
command > filename: Redirect standard output, overwriting target file if it exists.
command >> filename: Redirect standard output, appending to target file if it exists.
command1 | command2: Pipe standard output from command1 to standard input of command2
command1 ¶ command2: Commands separated by ASCII-20 (¶, invoked by Ctrl+T) are executed in sequence (chaining of commands).[3] In other words, first command1 is executed until termination, then command2.[3] This is an undocumented feature in COMMAND.COM of MS-DOS/PC DOS 5.0 and higher.[3] It is also supported by COMMAND.COM of the Windows NT family as well as by DR-DOS 7.07. All versions of DR-DOS COMMAND.COM already supported a similar internal function utilizing an exclamation mark (!) instead (a feature originally derived from Concurrent DOS and Multiuser DOS) - however, in the single-user line this feature was only available internally (in built-in startup scripts like "!DATE!TIME") and indirectly through DOSKEY's $T parameter to avoid problems with ! as a valid filename character.[3] 4DOS supports a configurable command line separator (4DOS.INI CommandSep= or SETDOS /C), which defaults to ^.[10] COMMAND.COM in newer versions of Windows NT also supports an & separator for compatibility with the cmd syntax in OS/2 and the Windows NT family.[10] (cmd, however, does not support the ¶ separator.)

Limitations

The command line length in interactive mode is limited to 126 characters.[11][12][13]

In popular culture

The message "Loading COMMAND.COM" can be seen on a HUD view of the Terminator and the internal viewport of RoboCop when he reboots.

In the CGI children's TV series ReBoot, which takes place inside computers, the leader of a system (the equivalent of a city) is called the COMMAND.COM.

References

MS-DOS/COMMAND.ASM at master · microsoft/MS-DOS · GitHub
Kurth, Rüdiger; Groß, Martin; Hunger, Henry (2016-11-29) [2007]. "Betriebssystem DCP". www.robotrontechnik.de (in German). Archived from the original on 2019-04-03. Retrieved 2019-04-28.
Paul, Matthias R. (1997-07-30) [1994-05-01]. NWDOS-TIPs — Tips & Tricks rund um Novell DOS 7, mit Blick auf undokumentierte Details, Bugs und Workarounds. MPDOSTIP. Release 157 (in German) (3 ed.). Archived from the original on 2016-11-04. Retrieved 2014-08-06. (NB. The provided link points to a HTML-converted version of the NWDOSTIP.TXT, which is part of the MPDOSTIP.ZIP collection.)
"Chapter 7: Batch Processing". Caldera DR-DOS 7.02 User Guide. Caldera, Inc. 1998 [1993, 1997]. Archived from the original on 2017-09-11. Retrieved 2017-09-11.
Paul, Matthias R. (1997-05-01) [1993-10-01]. BATTIPs — Tips & Tricks zur Programmierung von Batchjobs. MPDOSTIP (in German). Kapitel 7: ERRORLEVEL abfragen. Archived from the original on 2017-08-23. Retrieved 2017-08-23. (NB. BATTIPS.TXT is part of MPDOSTIP.ZIP. The provided link points to a HTML-converted older version of the BATTIPS.TXT file.)
Auer, Eric; Paul, Matthias R.; Hall, Jim (2015-12-24) [2003-12-31]. "MS-DOS errorlevels". Archived from the original on 2015-12-24.
Paul, Matthias R. (2003) [1997]. Auer, Eric (ed.). "Exitcodes (errorlevels) of DOS utilities". Archived from the original on 2017-09-11. Retrieved 2017-09-11.
Allen, William; Allen, Linda. "Windows 95/98/ME ERRORLEVELs". Archived from the original on 2005-10-29.
Caldera DR-DOS 7.02 User Guide. Caldera, Inc. 1998 [1993, 1997]. Archived from the original on 2016-11-04. Retrieved 2013-08-10.
Brothers, Hardin; Rawson, Tom; Conn, Rex C.; Paul, Matthias R.; Dye, Charles E.; Georgiev, Luchezar I. (2002-02-27). 4DOS 8.00 online help. […] Multiple Commands: You can type several commands on the same command line, separated by a caret [^]. For example, if you know you want to copy all of your .TXT files to drive A: and then run CHKDSK to be sure that drive A's file structure is in good shape, you could enter the following command: C:\>COPY *.TXT A: ^ CHKDSK A: You may put as many commands on the command line as you wish, as long as the total length of the command line does not exceed 511 characters. You can use multiple commands in aliases and batch files as well as at the command line. If you don't like using the default command separator, you can pick another character using the SETDOS /C command or the CommandSep directive in 4DOS.INI. […] SETDOS /C: (Compound character) This option sets the character used for separating multiple commands on the same line. The default is the caret [^]. You cannot use any of the redirection characters [<>|], or the blank, tab, comma, or equal sign as the command separator. The command separator is saved by SETLOCAL and restored by ENDLOCAL. This example changes the separator to a tilde [~]: C:\>SETDOS /C~ (You can specify either the character itself, or its ASCII code as a decimal number, or a hexadecimal number preceded by 0x.) […] CommandSep = c (^): This is the character used to separate multiple commands on the same line. […] Special Character Compatibility: If you use two or more of our products, or if you want to share aliases and batch files with users of different products, you need to be aware of the differences in three important characters: the Command Separator […], the Escape Character […], and the Parameter Character […]. The default values of each of these characters in each product is shown in the following chart: […] Product, Separator, Escape Parameter […] 4DOS: ^, ↑, & […] 4OS2, 4NT, Take Command: &, ^, $ […] (The up-arrow [↑] represents the ASCII Ctrl-X character, numeric value 24.) […]
Paul, Matthias R. (1997-07-01) [1994-01-01]. MSDOSTIPs — Tips für den Umgang mit MS-DOS 5.0-7. MPDOSTIP (in German). Archived from the original on 2017-08-22. Retrieved 2013-10-25. (NB. MSDOSTIP.TXT is part of MPDOSTIP.ZIP, maintained up to 2001 and distributed on many sites at the time. The provided link points to a HTML-converted older version of the MSDOSTIP.TXT file.)
Paul, Matthias R. (1997-05-01) [1995-03-01]. "Hinweise zu JPSofts 4DOS 5.5b/c, 5.51, 5.52a und NDOS". MPDOSTIP (in German). Archived from the original on 2016-11-04. Retrieved 2015-05-08. (NB. The provided link points to a HTML-converted version of the 4DOS5TIP.TXT file, which is part of the MPDOSTIP.ZIP collection.)
Schulman, Andrew; Brown, Ralf D.; Maxey, David; Michels, Raymond J.; Kyle, Jim (1994) [November 1993]. Undocumented DOS: A programmer's guide to reserved MS-DOS functions and data structures - expanded to include MS-DOS 6, Novell DOS and Windows 3.1 (2 ed.). Reading, Massachusetts, USA: Addison Wesley. pp. 623, 626. ISBN 0-201-63287-X. (xviii+856+vi pages, 3.5"-floppy) Errata:

Windows command-line programs and shell builtins
COMMAND.COM Command Prompt Windows PowerShell Recovery Console
File system navigation	cd (chdir) dir popd pushd tree
File management	attrib cacls cipher compact copy del (erase) deltree icacls mkdir (md) mklink move openfiles recover ren (rename) replace rmdir (rd) robocopy takeown xcopy
Archiving	expand extrac32 extract makecab pax tar
Disk management	chkdsk convert defrag diskcomp diskcopy diskpart diskraid diskshadow drvspace fdisk format fsutil label manage-bde subst scandisk sys vol vssadmin
Processes	at exit kill powercfg runas sc schtasks shutdown start taskkill tasklist
Registry	assoc ftype reg regini regsvr32
User environment	chcp cmdkey date graftabl mode path set setver setx time title ver where whoami
File contents	comp edit edlin fc find findstr print type
Scripting	choice clip cscript doskey echo for forfiles goto if more pause prompt rem timeout
Networking	arp BITSAdmin cURL getmac hostname ipconfig nbtstat net netsh netstat nslookup PathPing ping rpcping route scp sftp ssh ssh-add ssh-agent ssh-keygen ssh-keyscan tracert winrm winrs
Maintenance and care	auditpol dispdiag driverquery eventcreate eventtriggers logman mofcomp msiexec ntbackup pnpunattend pnputil REAgentC relog sfc sxstrace systeminfo tracerpt typeperf w32tm WBAdmin wecutil wevtutil winmgmt winsat wmic
Boot management	bcdedit bootcfg bootsect fixboot fixmbr
Software development	debug exe2bin QBasic
Miscellaneous	break cls dism dpath gpresult gpupdate help MSCDEX pentnt wsl
List of DOS commands Environment variables Windows Support Tools