NT4/private/windows/cmd/cmdmsg.mc

1772 lines
51 KiB
MonkeyC
Raw Normal View History

2001-01-01 00:00:00 +01:00
;/*++ BUILD Version: 0001 // Increment this if a change has global effects
;
;Copyright (c) 1991 Microsoft Corporation
;
;Module Name:
;
; cmdmsg.h
;
;Abstract:
;
; This file contains the message definitions for the Win32 CMD.EXE
; program.
;
;Author:
;
; Steve Wood (stevewo) 25-Jan-1991
;
;Revision History:
;
;Notes:
;
; This file is generated by the MC tool from the winerror.msg file.
;
;--*/
;
;#ifndef _CMDMSG_
;#define _CMDMSG_
;
;
MessageId=9000 SymbolicName=MSG_RESPONSE_DATA
Language=English
Y N
.
MessageId=9001 SymbolicName=MSG_BAD_PARM1
Language=English
An incorrect parameter was
entered for the command.
.
MessageId=9002 SymbolicName=MSG_BAD_SYNTAX
Language=English
The syntax of the command is incorrect.
.
MessageId=9003 SymbolicName=MSG_STRIKE_ANY_KEY
Language=English
Press any key to continue . . . %0
.
MessageId=9004 SymbolicName=MSG_CMD_DELETE
Language=English
%1, Delete (Y/N)? %0
.
MessageId=9005 SymbolicName=MSG_COM_SEARCH_DIR_BAD
Language=English
The system cannot find the
command processor in the path specified.
.
MessageId=9006 SymbolicName=MSG_REN_INVAL_PATH_FILENAME
Language=English
The system cannot accept the path
or file name requested.
.
MessageId=9007 SymbolicName=MSG_INVALID_DATE
Language=English
The system cannot accept the date entered.
.
MessageId=9008 SymbolicName=MSG_NO_BAT_LABEL
Language=English
No batch label specified to GOTO command.
.
MessageId=9009 SymbolicName=MSG_DIR_BAD_COMMAND_OR_FILE
Language=English
The name specified is not recognized as an
internal or external command, operable program or batch file.
.
MessageId=9010 SymbolicName=MSG_REN_INVALID_TIME
Language=English
The system cannot accept the time entered.
.
MessageId=9011 SymbolicName=MSG_BAD_DOS_VER
Language=English
The application program is not compatible
with the version of the operating system being used.
.
MessageId=9012 SymbolicName=MSG_COMM_VER
Language=English
Microsoft(R) Windows %1(TM)
(C) Copyright 1985-1996 Microsoft Corp.
.
MessageId=9013 SymbolicName=MSG_C
Language=English
^C
.
MessageId=9014 SymbolicName=MSG_FILES_COPIED
Language=English
%1 file(s) copied.
.
MessageId=9015 SymbolicName=MSG_CURRENT_DATE
Language=English
The current date is: %0
.
MessageId=9016 SymbolicName=MSG_CURRENT_TIME
Language=English
The current time is: %0
.
MessageId=9017 SymbolicName=MSG_DIR_OF
Language=English
Directory of %1
.
MessageId=9018 SymbolicName=MSG_OUT_OF_ENVIRON_SPACE
Language=English
The system is out of environment space.
.
MessageId=9019 SymbolicName=MSG_INVALID_DOS_FILENAME
Language=English
The file name entered is not valid in DOS mode.
.
MessageId=9020 SymbolicName=MSG_EXEC_FAILURE
Language=English
The system cannot execute the specified program.
.
MessageId=9021 SymbolicName=MSG_FILES_FREE
Language=English
%1 File(s) %2 bytes free
.
MessageId=9022 SymbolicName=MSG_FILES_ONLY
Language=English
%1 File(s).
.
MessageId=9023 SymbolicName=MSG_LINES_TOO_LONG
Language=English
The input line is too long.
.
MessageId=9024 SymbolicName=MSG_CONT_LOST_BEF_COPY
Language=English
The contents of the target file
were lost.
.
MessageId=9025 SymbolicName=MSG_INSRT_DISK_BAT
Language=English
Insert the diskette that contains the batch file
and press any key when ready. %0
.
MessageId=9026 SymbolicName=MSG_ENTER_NEW_DATE
Language=English
Enter the new date: (mm-dd-yy) %0
.
MessageId=9027 SymbolicName=MSG_ENTER_NEW_TIME
Language=English
Enter the new time: %0
.
MessageId=9028 SymbolicName=MSG_RDR_HNDL_CREATE
Language=English
The handle could not be duplicated
during redirection of handle %1.
.
MessageId=9029 SymbolicName=MSG_ECHO_OFF
Language=English
ECHO is off.
.
MessageId=9030 SymbolicName=MSG_ECHO_ON
Language=English
ECHO is on.
.
MessageId=9031 SymbolicName=MSG_VERIFY_OFF
Language=English
VERIFY is off.
.
MessageId=9032 SymbolicName=MSG_VERIFY_ON
Language=English
VERIFY is on.
.
MessageId=9033 SymbolicName=MSG_CANNOT_COPIED_ONTO_SELF
Language=English
The file cannot be copied onto itself.
.
MessageId=9034 SymbolicName=MSG_SYNERR_GENL
Language=English
%1 was unexpected at this time.
.
MessageId=9035 SymbolicName=MSG_TOP_LEVEL_PROCESS_CAN
Language=English
CMD.EXE has halted. %0
.
MessageId=9036 SymbolicName=MSG_PID_IS
Language=English
The Process Identification Number is %1.
.
MessageId=9037 SymbolicName=MSG_DUP_FILENAME_OR_NOT_FD
Language=English
A duplicate file name exists, or the file
cannot be found.
.
MessageId=9038 SymbolicName=MSG_ARE_YOU_SURE
Language=English
%1, Are you sure (Y/N)? %0
.
MessageId=9039 SymbolicName=MSG_TOKEN_TOO_LONG
Language=English
The following character string is too long:
%1
.
MessageId=9040 SymbolicName=MSG_MS_DOS_VERSION
Language=English
Windows %1 Version %2.%3 %0
.
MessageId=9041 SymbolicName=MSG_PIPE_FAILURE
Language=English
The handle could not be duplicated during
a pipe operation.
.
MessageId=9042 SymbolicName=MSG_MS_MORE
Language=English
More? %0
.
MessageId=9043 SymbolicName=MSG_REAL_MODE_ONLY
Language=English
The system cannot complete the process.
.
MessageId=9044 SymbolicName=MSG_TYPE_FILENAME
Language=English
%1
.
MessageId=9045 SymbolicName=MSG_INVALID_INPUT
Language=English
Unable to read from input.
.
MessageId=9051 SymbolicName=MSG_DR_VOL_SERIAL
Language=English
Volume Serial Number is %1
.
MessageId=9052 SymbolicName=MSG_DIR_EXISTS
Language=English
A subdirectory or file %1 already exists.
.
MessageId=9053 SymbolicName=MSG_ERR_PROC_ARG
Language=English
Error occurred while processing: %1.
.
MessageId=9054 SymbolicName=MSG_HAS_NO_LABEL
Language=English
Volume in drive %1 has no label.
.
MessageId=9055 SymbolicName=MSG_DR_VOL_LABEL
Language=English
Volume in drive %1 is %2
.
MessageId=9056 SymbolicName=MSG_KEYS_ON
Language=English
KEYS is on.
.
MessageId=9057 SymbolicName=MSG_KEYS_OFF
Language=English
KEYS is off.
.
MessageId=9058 SymbolicName=MSG_START_INVALID_PARAMETER
Language=English
The system cannot accept the START command parameter %1.
.
MessageId=9059 SymbolicName=MSG_CMD_FILE_NOT_FOUND
Language=English
The system cannot find the file %1.
.
MessageId=9060 SymbolicName=MSG_CMD_INVAL_PIPE
Language=English
The process tried to write to a nonexistent pipe.
.
MessageId=9061 SymbolicName=MSG_CMD_CANT_FRGRND
Language=English
The system cannot start the session in the foreground.
.
MessageId=9062 SymbolicName=MSG_CMD_SYS_ERR
Language=English
A non-recoverable error occurred.
The process ended.
.
MessageId=9063 SymbolicName=MSG_CMD_DIV_0
Language=English
The system detected a divide by zero error.
.
MessageId=9064 SymbolicName=MSG_CMD_SOFT_ERR
Language=English
The process has stopped. The software
diagnostic code (trap number) is %1.
.
MessageId=9065 SymbolicName=MSG_CMD_COPROC
Language=English
The process ended when it tried to use
a non-existent math processor.
.
MessageId=9066 SymbolicName=MSG_CMD_KILLED
Language=English
The external process was canceled by a Ctrl+Break or another process.
.
MessageId=9067 SymbolicName=MSG_CMD_NOT_RECOGNIZED
Language=English
"%1" is not a recognized device.
.
MessageId=9068 SymbolicName=MSG_CMD_BATCH_FILE_MISSING
Language=English
The batch file cannot be found.
.
MessageId=9070 SymbolicName=MSG_FILES_MOVED
Language=English
%1 file(s) moved.
.
MessageId=9071 SymbolicName=MSG_TRAPC
Language=English
A program attempted to reference storage outside the
limits of a stack segment. The program was ended.
%1
.
MessageId=9072 SymbolicName=MSG_UNEXPEC_ERROR_ENC
Language=English
Error %1 encountered an unexpected end of file
on the redirected input. The process has stopped.
.
MessageId=9073 SymbolicName=MSG_LITERAL_TEXT
Language=English
%1%0
.
MessageId=9074 SymbolicName=MSG_NOT_IMPLEMENTED
Language=English
Command not implemented.
.
MessageId=9075 SymbolicName=MSG_DIR
Language=English
<DIR> %0
.
MessageId=9076 SymbolicName=MSG_NO_MEMORY
Language=English
Out of memory.
.
MessageId=9077 SymbolicName=MSG_INVALID_SWITCH
Language=English
Invalid switch - "%1".
.
MessageId=9078 SymbolicName=MSG_PARAMETER_FORMAT_NOT_CORRECT
Language=English
Parameter format not correct - "%1".
.
MessageId=9079 SymbolicName=MSG_ERROR_IN_DIRCMD
Language=English
(Error occurred in environment variable)
.
MessageId=9080 SymbolicName=MSG_FILES_COUNT_FREE
Language=English
%1 File(s) %2 bytes
.
MessageId=9081 SymbolicName=MSG_FILES_TOTAL_FREE
Language=English
%1 bytes free
.
MessageId=9082 SymbolicName=MSG_FILE_TOTAL
Language=English
Total Files Listed:
.
MessageId=9083 SymbolicName=MSG_BATCH_TERM
Language=English
Terminate batch job (Y/N)? %0
.
MessageId=9084 SymbolicName=MSG_BAD_CURDIR
Language=English
The current directory is invalid.
.
MessageId=9085 SymbolicName=MSG_HELP_CHDIR
Language=English
Displays the name of or changes the current directory.
CHDIR [/D] [drive:][path]
CHDIR [..]
CD [/D] [drive:][path]
CD [..]
.. Specifies that you want to change to the parent directory.
Type CD drive: to display the current directory in the specified drive.
Type CD without parameters to display the current drive and directory.
Use the /D switch to change current drive in addition to changing current
directory for a drive.
.
MessageId=9086 SymbolicName=MSG_HELP_CLS
Language=English
Clears the screen.
CLS
.
MessageId=9087 SymbolicName=MSG_HELP_COPY
Language=English
Copies one or more files to another location.
COPY [/A | /B] source [/A | /B] [+ source [/A | /B] [+ ...]] [destination
[/A | /B]] [/V] [/N]
source Specifies the file or files to be copied.
/A Indicates an ASCII text file.
/B Indicates a binary file.
destination Specifies the directory and/or filename for the new file(s).
/V Verifies that new files are written correctly.
/N Uses short filename, if available, when copying a file with a
non-8dot3 name.
/Z Copies networked files in restartable mode.
To append files, specify a single file for destination, but multiple files
for source (using wildcards or file1+file2+file3 format).
.
MessageId=9088 SymbolicName=MSG_HELP_DATE
Language=English
Displays or sets the date.
DATE [date]
Type DATE without parameters to display the current date setting and
a prompt for a new one. Press ENTER to keep the same date.
.
MessageId=9089 SymbolicName=MSG_HELP_DEL_ERASE
Language=English
Deletes one or more files.
DEL [/P] [/F] [/S] [/Q] [/A[[:]attributes]] [[drive:][path]filename
ERASE [/P] [/F] [/S] [/Q] [/A[[:]attributes]] [[drive:][path]filename
[drive:][path]filename
Specifies the file(s) to delete. Specify multiple
files by using wildcards.
/P Prompts for confirmation before deleting each file.
/F Force deleting of read-only files.
/S Delete specified files from all subdirectories.
/Q Quiet mode, do not ask if ok to delete on global wildcard
/A Selects files to delete based on attributes
attributes R Read-only files S System files
H Hidden files A Files ready for archiving
- Prefix meaning not
.
MessageId=9090 SymbolicName=MSG_HELP_DIR
Language=English
Displays a list of files and subdirectories in a directory.
DIR [drive:][path][filename] [/P] [/W] [/D] [/A[[:]attributes]]
[/O[[:]sortorder]] [/T[[:]timefield]] [/S] [/B] [/L] [/N] [/X] [/C]
[drive:][path][filename]
Specifies drive, directory, and/or files to list.
/P Pauses after each screenful of information.
/W Uses wide list format.
/D Same as wide but files are list sorted by column.
/A Displays files with specified attributes.
attributes D Directories R Read-only files
H Hidden files A Files ready for archiving
S System files - Prefix meaning not
/O List by files in sorted order.
sortorder N By name (alphabetic) S By size (smallest first)
E By extension (alphabetic) D By date & time (earliest first)
G Group directories first - Prefix to reverse order
/T Controls which time field displayed or used for sorting
timefield C Creation
A Last Access
W Last Written
/S Displays files in specified directory and all subdirectories.
/B Uses bare format (no heading information or summary).
/L Uses lowercase.
/N New long list format where filenames are on the far right.
/X This displays the short names generated for non-8dot3 file
names. The format is that of /N with the short name inserted
before the long name. If no short name is present, blanks are
displayed in its place.
/C Display the thousand separator in file sizes. This is the
default. Use /-C to disable display of separator.
Switches may be preset in the DIRCMD environment variable. Override
preset switches by prefixing any switch with - (hyphen)--for example, /-W.
.
MessageId=9091 SymbolicName=MSG_HELP_EXIT
Language=English
Quits the CMD.EXE program (command interpreter).
EXIT
.
MessageId=9092 SymbolicName=MSG_HELP_MKDIR
Language=English
Creates a directory.
MKDIR [drive:]path
MD [drive:]path
.
MessageId=9093 SymbolicName=MSG_HELP_PATH
Language=English
Displays or sets a search path for executable files.
PATH [[drive:]path[;...][;%%PATH%%]
PATH ;
Type PATH ; to clear all search-path settings and direct cmd.exe to search
only in the current directory.
Type PATH without parameters to display the current path.
Including %%PATH%% in the new path setting causes the old path to be appended
to the new setting.
.
MessageId=9094 SymbolicName=MSG_HELP_PROMPT
Language=English
Changes the cmd.exe command prompt.
PROMPT [text]
text Specifies a new command prompt.
Prompt can be made up of normal characters and the following special codes:
$A & (Ampersand)
$B | (pipe)
$C ( (Left parenthesis)
$D Current date
$E Escape code (ASCII code 27)
$F ) (Right parenthesis)
$G > (greater-than sign)
$H Backspace (erases previous character)
$L < (less-than sign)
$N Current drive
$P Current drive and path
$Q = (equal sign)
$S (space)
$T Current time
$V Windows NT version number
$_ Carriage return and linefeed
$$ $ (dollar sign)
.
MessageId=9095 SymbolicName=MSG_HELP_RMDIR
Language=English
Removes (deletes) a directory.
RMDIR [/S] [/Q] [drive:]path
RD [/S] [/Q] [drive:]path
/S Removes all directories and files in the specified directory
in addition to the directory itself. Used to remove a directory
tree.
/Q Quiet mode, do not ask if ok to remove a directory tree with /S
.
MessageId=9096 SymbolicName=MSG_HELP_RENAME
Language=English
Renames a file or files.
RENAME [drive:][path]filename1 filename2.
REN [drive:][path]filename1 filename2.
Note that you cannot specify a new drive or path for your destination file.
.
MessageId=9097 SymbolicName=MSG_HELP_SET
Language=English
Displays, sets, or removes cmd.exe environment variables.
SET [variable=[string]]
variable Specifies the environment-variable name.
string Specifies a series of characters to assign to the variable.
Type SET without parameters to display the current environment variables.
.
MessageId=9098 SymbolicName=MSG_HELP_TIME
Language=English
Displays or sets the system time.
TIME [time]
Type TIME with no parameters to display the current time setting and a prompt
for a new one. Press ENTER to keep the same time.
.
MessageId=9099 SymbolicName=MSG_HELP_TYPE
Language=English
Displays the contents of a text file or files.
TYPE [drive:][path]filename
.
MessageId=9100 SymbolicName=MSG_HELP_VER
Language=English
Displays the Windows NT version.
VER
.
MessageId=9101 SymbolicName=MSG_HELP_VERIFY
Language=English
Tells cmd.exe whether to verify that your files are written correctly to a
disk.
VERIFY [ON | OFF]
Type VERIFY without a parameter to display the current VERIFY setting.
.
MessageId=9102 SymbolicName=MSG_HELP_VOL
Language=English
Displays the disk volume label and serial number, if they exist.
VOL [drive:]
.
MessageId=9103 SymbolicName=MSG_HELP_CALL
Language=English
Calls one batch program from another.
CALL [drive:][path]filename [batch-parameters]
batch-parameters Specifies any command-line information required by the
batch program.
.
MessageId=9104 SymbolicName=MSG_HELP_REM
Language=English
Records comments (remarks) in a batch file or CONFIG.SYS.
REM [comment]
.
MessageId=9105 SymbolicName=MSG_HELP_PAUSE
Language=English
Suspends processing of a batch program and displays the message
Press any key to continue . . . %0
PAUSE
.
MessageId=9106 SymbolicName=MSG_HELP_ECHO
Language=English
Displays messages, or turns command-echoing on or off.
ECHO [ON | OFF]
ECHO [message]
Type ECHO without parameters to display the current echo setting.
.
MessageId=9107 SymbolicName=MSG_HELP_GOTO
Language=English
Directs cmd.exe to a labeled line in a batch program.
GOTO label
label Specifies a text string used in the batch program as a label.
You type a label on a line by itself, beginning with a colon.
.
MessageId=9108 SymbolicName=MSG_HELP_SHIFT
Language=English
Changes the position of replaceable parameters in a batch file.
SHIFT [/n]
.
MessageId=9109 SymbolicName=MSG_HELP_IF
Language=English
Performs conditional processing in batch programs.
IF [NOT] ERRORLEVEL number command
IF [NOT] string1==string2 command
IF [NOT] EXIST filename command
NOT Specifies that Windows NT should carry out the command only
if the condition is false.
ERRORLEVEL number Specifies a true condition if the last program run returned
an exit code equal to or greater than the number specified.
command Specifies the command to carry out if the condition is
met.
string1==string2 Specifies a true condition if the specified text strings
match.
EXIST filename Specifies a true condition if the specified filename
exists.
.
MessageId=9110 SymbolicName=MSG_HELP_FOR
Language=English
Runs a specified command for each file in a set of files.
FOR %%variable IN (set) DO command [command-parameters]
%%variable Specifies a replaceable parameter.
(set) Specifies a set of one or more files. Wildcards may be used.
command Specifies the command to carry out for each file.
command-parameters
Specifies parameters or switches for the specified command.
To use the FOR command in a batch program, specify %%%%variable instead
of %%variable Variable names are case sensitive, so %%i is different
from %%I.
.
MessageId=9111 SymbolicName=MSG_HELP_START
Language=English
Starts a separate window to run a specified program or command.
START ["title"] [/Dpath] [/I] [/MIN] [/MAX] [/SEPARATE | /SHARED]
[/LOW | /NORMAL | /HIGH | /REALTIME] [/WAIT] [/B] [command/program] [parameters]
"title" Title to display in window title bar.
path Starting directory
I The new environment will be the original environment passed
to the cmd.exe and not the current environment.
MIN Start window minimized
MAX Start window maximized
SEPARATE Start 16-bit Windows program in separate memory space
SHARED Start 16-bit Windows program in shared memory space
LOW Start application in the IDLE priority class
NORMAL Start application in the NORMAL priority class
HIGH Start application in the HIGH priority class
REALTIME Start application in the REALTIME priority class
WAIT Start application and wait for it to terminate
B Start application without creating a new window. The
application has ^C handling ignored. Unless the application
enables ^C processing, ^Break is the only way to interrupt the
application
command/program
If it is an internal cmd command or a batch file then
the command processor is run with the /K switch to cmd.exe.
This means that the window will remain after the command
has been run.
If it is not an internal cmd command or batch file then
it is a program and will run as either a windowed application
or a console application.
parameters These are the parameters passed to the command/program
.
MessageId=9112 SymbolicName=MSG_HELP_BREAK
Language=English
Sets or Clears Extended CTRL+C checking on DOS system
This is present for Compatibility with DOS systems. It has no effect
under Windows NT.
.
MessageId=9113 SymbolicName=MSG_HELP_CMD
Language=English
Starts a new instance of the Windows/NT command interpreter
CMD [/X | /Y] [/A | /U] [/Q] [[/C | /K] string]
/C Carries out the command specified by string and then terminates
/K Carries out the command specified by string but remains
/Q Turns the echo off
/A Causes the output of internal commands to a pipe or file to be ANSI
/U Causes the output of internal commands to a pipe or file to be Unicode
/T:fg Sets the foreground/background colors (see COLOR /? for more info)
/X Enable extensions to the Windows NT version of CMD.EXE
/Y Disable extensions to the Windows NT version of CMD.EXE
Note that multiple commands separated by the command separator '&&'
are accepted for string if surrounded by quotes
.
MessageId= SymbolicName=MSG_HELP_CMD_EXTENSIONS
Language=English
Command Extensions are enabled by default. You may also disable
extensions for all invocations of the command processor by setting the
following value in the registry to 0
HKEY_CURRENT_USER\Software\Microsoft\Command Processor\EnableExtensions
The command extensions involve changes and/or additions to the following
commands:
DEL or ERASE
COLOR
CD or CHDIR
MD or MKDIR
PROMPT
PUSHD
POPD
SET
SETLOCAL
ENDLOCAL
IF
FOR
CALL
SHIFT
GOTO
START (also includes changes to external command invocation)
ASSOC
FTYPE
To get specific details, type HELP commandname to view the specifics.
.
MessageId= SymbolicName=MSG_EXT_ENABLED
Language=English
Command Processor Extensions Enabled
.
MessageId= SymbolicName=MSG_EXT_ENABLED_BY_DEFAULT
Language=English
Command Processor Extensions enabled by default. Use CMD /? for details.
.
MessageId= SymbolicName=MSG_FILE_DELETED
Language=English
Deleted file - %1
.
MessageId= SymbolicName=MSG_HELP_ASSOC
Language=English
Displays or modifies file extension associations
ASSOC [.ext[=[fileType]]]
.ext Specifies the file extension to associate the file type with
fileType Specifies the file type to associate with the file extension
Type ASSOC without parameters to display the current file associations.
If ASSOC is invoked with just a file extension, it displays the current
file association for that file extension. Specify nothing for the file
type and the command will delete the association for the file extension.
.
MessageID= SymbolicName=MSG_ASSOC_NOT_FOUND
Language=English
File association not found for extension %1
.
MessageId= SymbolicName=MSG_HELP_FTYPE
Language=English
Displays or modifies file types used in file extension associations
FTYPE [fileType[=[openCommandString]]]
fileType Specifies the file type examine or change
openCommandString Specifies the open command to use when launching files
of this type.
Type FTYPE without parameters to display the current file types that
have open command strings defined. FTYPE is invoked with just a file
type, it displays the current open command string for that file type.
Specify nothing for the open command string and the FTYPE command will
delete the open command string for the file type. Within an open
command string %%0 or %%1 are substituted with the file name being
launched through the assocation. %%* gets all the parameters and %%2
gets the 1st parameter, %%4 the second, etc. %%~n gets all the remaining
parameters starting with the nth parameter, where n may be between 2 and 9,
inclusive. For example:
ASSOC .pl=PerlScript
FTYPE PerlScript=perl.exe %%1 %%*
would allow you to invoke a Perl script as follows:
script.pl 1 2 3
If you want to eliminate the need to type the extensions, then do the
following:
set PATHEXT=.pl;%%PATHEXT%%
and the script could be invoked as follows:
script 1 2 3
.
MessageID= SymbolicName=MSG_FTYPE_NOT_FOUND
Language=English
File type '%1' not found or no open command associated with it.
.
MessageID= SymbolicName=MSG_SETLOCAL_BAD_ARG
Language=English
Invalid parameter to SETLOCAL command
.
MessageID= SymbolicName=MSG_NO_COPYFILEEX
Language=English
The restartable option to the COPY command is not supported by
this version of the operating system.
.
MessageID= SymbolicName=MSG_PATH_OPERATOR_INVALID
Language=English
The following usage of the path operator in batch-parameter
substitution is invalid: %1
For valid formats type CALL /? or FOR /?
.
MessageID= SymbolicName=MSG_ENV_VAR_NOT_FOUND
Language=English
Environment variable %1 not defined
.
MessageID= SymbolicName=MSG_CALL_LABEL_INVALID
Language=English
Invalid attempt to call batch label outside of batch script.
.
MessageId= SymbolicName=MSG_MISSING_BAT_LABEL
Language=English
The system cannot find the batch label specified - %1
.
MessageId= SymbolicName=MSG_UNICODE_NOT_SUPPORTED
Language=English
The unicode output option to CMD.EXE is not supported by this
version of the operating system.
.
MessageId= SymbolicName=MSG_HELP_DEL_ERASE_X
Language=English
If Command Extensions are enabled DEL and ERASE change as follows:
The display semantics of the /S switch are reversed in that it shows
you only the files that are deleted, not the ones it could not find.
.
MessageId= SymbolicName=MSG_HELP_CHDIR_X
Language=English
If Command Extensions are enabled CHDIR changes as follows:
The current directory string is converted to use the same case as
the on disk names. So CD C:\TEMP would actually set the current
directory to C:\Temp if that is the case on disk.
CHDIR command does not treat spaces as delimeters, so it is possible to
CD into a subdirectory name that contains a space without surrounding
the name with quotes. For example:
cd \winnt\profiles\username\programs\start menu
is the same as:
cd "\winnt\profiles\username\programs\start menu"
which is what you would have to type if extensions were disabled.
.
MessageId= SymbolicName=MSG_HELP_MKDIR_X
Language=English
If Command Extensions are enabled MKDIR changes as follows:
MKDIR creates any intermediate directories in the path, if needed.
For example, assume \a does not exist then:
mkdir \a\b\c\d
is the same as:
mkdir \a
chdir \a
mkdir b
chdir b
mkdir c
chdir c
mkdir d
which is what you would have to type if extensions were disabled.
.
MessageId= SymbolicName=MSG_HELP_DATE_X
Language=English
If Command Extensions are enabled the DATE command supports
the /T switch which tells the command to just output the
current date, without prompting for a new date.
.
MessageId= SymbolicName=MSG_HELP_TIME_X
Language=English
If Command Extensions are enabled the TIME command supports
the /T switch which tells the command to just output the
current time, without prompting for a new time.
.
MessageId= SymbolicName=MSG_HELP_PROMPT_X
Language=English
If Command Extensions are enabled the PROMPT command supports
the following additional formatting characters:
$+ zero or more plus sign (+) characters depending upon the
depth of the PUSHD directory stack, one character for each
level pushed.
$M Displays the remote name associated with the current drive
letter or the empty string if current drive is not a network
drive.
.
MessageId= SymbolicName=MSG_HELP_PUSHDIR_X
Language=English
If Command Extensions are enabled the PUSHD command accepts
network paths in addition to the normal drive letter and path.
If a network path is specified, PUSHD will create a temporary
drive letter that points to that specified network resource and
then change the current drive and directory, using the newly
defined drive letter. Temporary drive letters are allocated from
Z: on down, using the first unused drive letter found.
.
MessageId= SymbolicName=MSG_HELP_POPDIR_X
Language=English
If Command Extensions are enabled the POPD command will delete
any temporary drive letter created by PUSHD when you POPD that
drive off the pushed directory stack.
.
MessageId= SymbolicName=MSG_HELP_SET_X
Language=English
If Command Extensions are enabled SET changes as follows:
SET command invoked with just a variable name, no equal sign or value
will display the value of all variables whose prefix matches the name
given to the SET command. For example:
SET P
would display all variables that begin with the letter 'P'
SET command will set the ERRORLEVEL to 1 if the variable name is not
found in the current environment.
SET command will allow an equal sign (=) in the value of an environment
variable in any position other than the first character.
A new switch is added to the SET command:
SET /A expression
The /A switch specifies that the string to the right of the equal sign
is a numerical expression that is evaluated. The expression evaluator
is pretty simple and supports the following operations, in decreasing
order of precedence:
() - grouping
* / %% - arithmetic operators
+ - - arithmetic operators
<< >> - logical shift
& - bitwise and
^ - bitwise exclusive or
| - bitwise or
= *= /= %%= += -= - assignment
&= ^= |= <<= >>=
, - expression separator
If you use any of the logical or modulus operators, you will need to
enclose the expression string in quotes. Any non-numeric strings in the
expression are treated as environment variable names whose values are
converted to numbers before using them. If an environment variable name
is specified but is not defined in the current environment, then a value
of zero is used. This allows you to do arithmetic with environment
variable values without having to type all those %% signs to get their
values. If SET /A is executed from the command line outside of a
command script, then it displays the final value of the expression. The
assignment operator requires an environment variable name to the left of
the assignment operator. Numeric values are decimal numbers, unless
prefixed by 0x for hexidecimal numbers, 0b for binary numbers and 0 for
octals numbers. So 0x12 is the same as 0b10010 is the same as 022.
Please note that the octal notation can be confusing: 08 and 09 are
not valid numbers because 8 and 9 are not valid octal digits.
Environment variable substitution has been enhanced as follows:
%%PATH:str1=str2%%
would expand the PATH environment variable, substituting each occurrence
of "str1" in the expanded result with "str2". "str2" can be the empty
string to effectively delete all occurrences of "str1" from the expanded
output. "str1" can begin with an asterisk, in which case it will match
everything from the begining of the expanded output to the first
occurrence of the remaining portion of str1.
%%PATH:~10,5%%
would expand the PATH environment variable, and then use only the 5
characters that begin at the 11th (offset 10) character of the expanded
result.
.
MessageId= SymbolicName=MSG_HELP_GOTO_X
Language=English
If Command Extensions are enabled GOTO changes as follows:
GOTO command now accepts a target label of :EOF which transfers control
to the end of the current batch script file. This is an easy way to
exit a batch script file without defining a label. Type CALL /? for a
description of extensions to the CALL command that make this feature
useful.
.
MessageId= SymbolicName=MSG_HELP_SHIFT_X
Language=English
If Command Extensions are enabled the SHIFT command supports
the /n switch which tells the command to start shifting at the
nth argument, where n may be between zero and eight. For example:
SHIFT /2
would shift %%3 to %%2, %%4 to %%3, etc. and leave %%0 and %%1 unaffected.
.
MessageId= SymbolicName=MSG_HELP_CALL_X
Language=English
If Command Extensions are enabled CALL changes as follows:
CALL command now accepts labels as the target of the CALL. The syntax
is:
CALL :label arguments
A new batch file context is created with the specified arguments and
control is passed to the statement after the label specified. You must
"exit" twice by reaching the end of the batch script file twice. The
first time you read the end, control will return to just after the CALL
statement. The second time will exit the batch script. Type GOTO /?
for a description of the GOTO :EOF extension that will allow you to
"return" from a batch script.
In addition, expansion of batch script argument references (%%0, %%1,
etc.) have been changed as follows:
%%* in a batch script refers to all the arguments (e.g. %%1 %%2 %%3
%%4 %%5 ...)
Substitution of batch parameters (%%n) has been enhanced. You can
now use the following optional syntax:
%%~f1 - expands %%1 to a fully qualified path name
%%~d1 - expands %%1 to a drive letter only
%%~p1 - expands %%1 to a path only
%%~n1 - expands %%1 to a file name only
%%~x1 - expands %%1 to a file extension only
%%~s1 - changes the meaning of n and x options to
reference the short name instead
%%~$PATH:1 - searches the directories listed in the PATH
environment variable and expands %%1 to the fully
qualified name of the first one found. If the
environment variable name is not defined or the
file is not found by the search, then this
modifier expands to the empty string
The modifiers can be combined to get compound results:
%%~dp1 - expands %%1 to a drive letter and path only
%%~nx1 - expands %%1 to a file name and extension only
%%~dp$PATH:1 - searches the directories listed in the PATH
environment variable for %%1 and expands to the
drive letter and path of the first one found.
In the above examples %%1 and PATH can be replaced by other
valid values
.
MessageId= SymbolicName=MSG_HELP_SETLOCAL_X
Language=English
If Command Extensions are enabled SETLOCAL changes as follows:
SETLOCAL batch command now accepts an optional argument, which can be
either ENABLEEXTENSIONS or DISABLEEXTENSIONS. This will enable or
disable the Command process extensions until the matching ENDLOCAL
command, regardless of their setting prior to the SETLOCAL command.
The SETLOCAL command will set the ERRORLEVEL value if given
an argument. It will be zero if one of the two valid arguments
is given and one otherwise. You can use this in batch scripts
to determine if the extensions are available, using the following
technique:
VERIFY OTHER 2>nul
SETLOCAL ENABLEEXTENSIONS
IF ERRORLEVEL 1 echo Unable to enable extensions
This works because on old versions of CMD.EXE, SETLOCAL does NOT
set the ERRORLEVEL value. The VERIFY command with a bad argument
initializes the ERRORLEVEL value to a non-zero value.
.
MessageId= SymbolicName=MSG_HELP_ENDLOCAL_X
Language=English
If Command Extensions are enabled ENDLOCAL changes as follows:
If the corresponding SETLOCAL enable or disabled command extensions
using the new ENABLEEXTENSIONS or DISABLEEXTENSIONS options, then
after the ENDLOCAL, the enabled/disabled state of command extensions
will be restored to what it was prior to the matching SETLOCAL
command execution.
.
MessageId= SymbolicName=MSG_HELP_START_X
Language=English
If Command Extensions are enabled, external command invocation
through the command line or the START command changes as follows:
non-executable files may be invoked through their file association just
by typing the name of the file as a command. (e.g. WORD.DOC would
launch the application associated with the .DOC file extension).
See the ASSOC and FTYPE commands for how to create these
associations from within a command script.
When executing an application that is a 32-bit GUI application, CMD.EXE
does not wait for the application to terminate before returning to
the command prompt. This new behavior does NOT occur if executing
within a command script.
When executing a command line whose first token is CMD without an
extension or path qualifier, then replaces CMD with the value of the
COMSPEC variable, thus avoiding picking up random versions of
CMD.EXE when you least expect them.
When executing a command line whose first token does NOT contain an
extension, then CMD.EXE uses the value of the PATHEXT
environment variable to determine which extensions to look for
and in what order. The default value for the PATHEXT variable
is:
.COM;.EXE;.BAT;.CMD
Notice the syntax is the same as the PATH variable, with
semicolons separating the different elements.
When executing a command, if there is no match on any extension, then
looks to see if the name, without any extension, matches a directory name
and if it does, the START command launches the Explorer on that path.
If done from the command line, it is the equivalent to doing a CD /D
to that path.
.
MessageId= SymbolicName=MSG_HELP_BREAK_X
Language=English
If Command Extensions are enabled, and running on the Windows NT
platform, then the BREAK command will enter a hard coded breakpoint
if being debugged by a debugger.
.
MessageId= SymbolicName=MSG_HELP_FOR_X
Language=English
If Command Extensions are enabled, the following additional
forms of the FOR command are supported:
FOR /D %%variable IN (set) DO command [command-parameters]
If set contains wildcards, then specifies to match against directory
names instead of file names.
FOR /R [[drive:]path] %%variable IN (set) DO command [command-parameters]
Walks the directory tree rooted at [drive:]path, executing the FOR
statement in each directory of the tree. If no directory
specification is specified after /R then the current directory is
assumed. If set is just a single period (.) character then it
will just enumerate the directory tree.
FOR /L %%variable IN (start,step,end) DO command [command-parameters]
The set is a sequence of numbers from start to end, by step amount.
So (1,1,5) would generate the sequence 1 2 3 4 5 and (5,-1,1) would
generate the sequence (5 4 3 2 1)
FOR /F ["options"] %%variable IN (filenameset) DO command [command-parameters]
filenameset is one or more file names. Each file is opened, read
and processed before going on to the next file in filenameset.
Processing consists of reading in the file, breaking it up into
individual lines of text and then parsing each line into zero or
more tokens. The body of the for loop is then called with the
variable value(s) set to the found token string(s). By default, /F
passes the first blank separated token from each line of each file.
Blank lines are skipped. You can override the default parsing
behavior by specifying the optional "options" parameter. This
is a quoted string which contains one or more keywords to specify
different parsing parameters. The keywords are:
eol=c - specifies an end of line comment character
(just one)
skip=n - specifies the number of lines to skip at the
beginning of the file.
delims=xxx - specifies a delimeter set. This replaces the
default delimiter set of space and tab.
tokens=x,y,m-n - specifies which tokens from each line are to
be passed to the for body for each iteration.
This will cause additional variable names to
be allocated. The m-n form is a range,
specifying the mth through the nth tokens. If
the last character in the tokens= string is an
asterisk, then an additional variable is
allocated and receives the remaining text on
the line after the last token parsed.
.
MessageId= SymbolicName=MSG_HELP_FOR_X1
Language=English
Some examples might help:
FOR /F "eol=; tokens=2,3* delims=, " %%i in (myfile.txt) do @echo %%i %%j %%k
would parse each line in myfile.txt, ignoring lines that begin with
a semicolon, passing the 2nd and 3rd token from each line to the for
body, with tokens delimited by commas and/or spaces. Notice the for
body statements reference %%i to get the 2nd token, %%j to get the
3rd token, and %%k to get all remaining tokens after the 3rd.
%%i is explicitly declared in the for statement and the %%j and %%k
are implicitly declared via the tokens= option. You can specify up
to 26 tokens via the tokens= line, provided it does not cause an
attempt to declare a variable higher than the letter 'z'. Remember,
FOR variable names are global, and you can't have more than 26 total
active at any one time.
You can also use the FOR /F parsing logic on an immediate string, by
making the filenameset between the parenthesis a quoted string. It
will be treated as a single line of input from a file and parsed.
Finally, you can use the FOR /F command to parse the output of a
command. You do this by making the filenameset between the
parenthesis a single quoted string. It will be treated as a command
line, which is passed to a child CMD.EXE and the output is captured
into memory and parsed as if it was a file. So the following
example:
FOR /F "delims==" %%i IN ('set') DO @echo %%i
would enumerate the environment variable names in the current
environment.
In addition, substitution of FOR variable references has been enhanced.
You can now use the following optional syntax:
%%~fi - expands %%i to a fully qualified path name
%%~di - expands %%i to a drive letter only
%%~pi - expands %%i to a path only
%%~ni - expands %%i to a file name only
%%~xi - expands %%i to a file extension only
%%~si - expanded path contains short names only
%%~$PATH:i - searches the directories listed in the PATH
environment variable and expands %%i to the
fully qualified name of the first one found.
If the environment variable name is not
defined or the file is not found by the
search, then this modifier expands to the
empty string
The modifiers can be combined to get compound results:
%%~dpi - expands %%i to a drive letter and path only
%%~nxi - expands %%i to a file name and extension only
%%~fsi - expands %%i to a full path name with short names only
%%~dp$PATH:i - searches the directories listed in the PATH
environment variable for %%i and expands to the
drive letter and path of the first one found.
In the above examples %%i and PATH can be replaced by other
valid values. Just be careful to pick your FOR variable letters
to not conflict with any of the format specifier letters if you
plan on using the enhanced substitution logic.
.
MessageId= SymbolicName=MSG_HELP_IF_X
Language=English
If Command Extensions are enabled IF changes as follows:
IF [/I] string1 compare-op string2 command
IF CMDEXTVERSION number command
IF DEFINED variable command
where compare-op may be one of:
EQU - equal
NEQ - not equal
LSS - less than
LEQ - less than or equal
GTR - greater than
GEQ - greater than or equal
and the /I switch, if specified, says to do case insensitive string
compares. The /I switch can also be used on the string1==string2 form
of IF. These comparisons are generic, in that if both string1 and
string2 are both comprised of all numeric digits, then the strings are
converted to numbers and a numeric comparison is performed.
The CMDEXTVERSION conditional works just like ERRORLEVEL, except it is
comparing against an internal version number associated with the Command
Extensions. The first version is 1. It will be incremented by one when
significant enhancements are added to the Command Extensions.
CMDEXTVERSION conditional is never true when Command Extensions are
disabled.
The DEFINED conditional works just like EXISTS except it takes an
environment variable name and returns true if the environment variable
is defined.
%%ERRORLEVEL%% will expand into a string representation of
the current value of ERRORLEVEL, provided that there is not already
an environment variable with the name ERRORLEVEL, in which case you
will get its value instead. Using this and the above numerical
comparision operators, you can do the following
choice
goto answer%%ERRORLEVEL%%
:answer0
echo You typed Y for yes
:answer1
echo You typed N for no
you can also using the numerical comparisons above:
IF %%ERRORLEVEL%% LEQ 1 goto okay
%%CMDCMDLINE%% will expand into the original command line passed to
CMD.EXE prior to any processing by CMD.EXE, provided that there is not
already an environment variable with the name CMDCMDLINE, in which case
you will get its value instead.
.
MessageId= SymbolicName=MSG_HELP_KEYS
Language=English
Enables or disables command line editing on DOS system
This is present for Compatibility with DOS systems. It has no effect
under Windows NT, as command line editing is always enabled.
.
MessageId= SymbolicName=MSG_NO_UNC_CURDIR
Language=English
'%1' is an invalid current directory path. UNC paths are not supported.
Defaulting to Windows directory.
.
MessageId= SymbolicName=MSG_SIM_UNC_CURDIR
Language=English
UNC paths not supported for current directory. Using
PUSHD %1
to create temporary drive letter to support UNC current
directory. Use POPD or EXIT to delete temporary drive
letter.
.
MessageID= SymbolicName=MSG_SHIFT_BAD_ARG
Language=English
Invalid parameter to SHIFT command
.
MessageID= SymbolicName=MSG_SET_A_MISMATCHED_PARENS
Language=English
Unbalanced parenthesis.
.
MessageID= SymbolicName=MSG_SET_A_MISSING_OPERAND
Language=English
Missing operand.
.
MessageID= SymbolicName=MSG_SET_A_BAD_ASSIGN
Language=English
Environment variable name required to left of assignment operator.
.
MessageID= SymbolicName=MSG_SET_A_MISSING_OPERATOR
Language=English
Missing operator.
.
MessageID= SymbolicName=MSG_SET_A_INVALID_NUMBER
Language=English
Invalid number. Numeric contants are either decimal (17),
hexidecimal (0x11), binary (0b10001) or octal (021).
.
MessageId=10000 SymbolicName=MSG_TOO_MANY_PARAMETERS
Language=English
Too many parameters - %1
.
MessageID=10001 SymbolicName=MSG_FILE_NOT_FOUND
Language=English
File Not Found
.
MessageID=10002 SymbolicName=MSG_NOT_FOUND
Language=English
Could Not Find %1
.
MessageID=10003 SymbolicName=MSG_TIME_NOT_SUPPORTED
Language=English
The FAT File System only support Last Write Times
.
MessageId=10004 SymbolicName=MSG_HELP_SETLOCAL
Language=English
Begins localization of environment changes in a batch file.
Environment changes made after SETLOCAL has been issued are
local to the batch file. ENDLOCAL must be issued to
restore the previous settings.
SETLOCAL
.
MessageId=10005 SymbolicName=MSG_HELP_ENDLOCAL
Language=English
Ends localization of environment changes in a batch file.
Environment changes made after ENDLOCAL has been issued are
not local to the batch file; the previous settings are not
restored on termination of the batch file.
ENDLOCAL
.
MessageId=10006 SymbolicName=MSG_HELP_TITLE
Language=English
Sets the window title for the command prompt window.
TITLE [string]
string Specifies the title for the command prompt window.
.
MessageId=10007 SymbolicName=MSG_HELP_APPEND
Language=English
Allows programs to open data files in specified directories as if they were in
the current directory.
APPEND [[drive:]path[;...]] [/X[:ON | :OFF]] [/PATH:ON | /PATH:OFF] [/E]
APPEND ;
[drive:]path Specifies a drive and directory to append.
/X:ON Applies appended directories to file searches and
application execution.
/X:OFF Applies appended directories only to requests to open files.
/X:OFF is the default setting.
/PATH:ON Applies the appended directories to file requests that already
specify a path. /PATH:ON is the default setting.
/PATH:OFF Turns off the effect of /PATH:ON.
/E Stores a copy of the appended directory list in an environment
variable named APPEND. /E may be used only the first time
you use APPEND after starting up your system.
Type APPEND ; to clear the appended directory list.
Type APPEND without parameters to display the appended directory list.
.
MessageId=10008 SymbolicName=MSG_HELP_MOVE
Language=English
Moves one or more files from one directory to another directory.
MOVE [Source] [Target]
source Specifies the path and name of the file(s) to move.
target Specifies the path and name to move file(s) to.
.
MessageId=10009 SymbolicName=MSG_HELP_PUSHDIR
Language=English
Stores the current directory for use by the POPD command, then
changes to the specified directory.
PUSHD [path | ..]
path Specifies the directory to make the current directory.
.
MessageId=10010 SymbolicName=MSG_HELP_POPDIR
Language=English
Changes to the directory stored by the PUSHD command.
POPD
.
MessageId=10011 SymbolicName=MSG_FILE_NAME_PRECEEDING_ERROR
Language=English
%1 - %0
.
MessageId=10012 SymbolicName=MSG_MAX_SETLOCAL
Language=English
Maximum setlocal recursion level reached.
.
MessageId=10013 SymbolicName=MSG_ENTER_JAPAN_DATE
Language=English
Enter the new date: (yy-mm-dd) %0
.
MessageId=10014 SymbolicName=MSG_ENTER_DEF_DATE
Language=English
Enter the new date: (dd-mm-yy) %0
.
MessageID=10015 SymbolicName=MSG_VERIFY_FAIL
Language=English
ERROR Verify - %1
.
MessageID=10016 SymbolicName=MSG_MOVE_MULTIPLE_FAIL
Language=English
Cannot move multiple files to a single file.
.
MessageId=10017 SymbolicName=MSG_RDR_HNDL_OPEN
Language=English
The handle could not be opened
during redirection of handle %1.
.
MessageId=10018 SymbolicName=MSG_PROGRESS
Language=English
%r%1%% copied %0
.
MessageId=10019 SymbolicName=MSG_HELP_COLOR
Language=English
Sets the default console foreground and background colors.
COLOR [attr]
attr Specifies color attribute of console output
Color attributes are specified by TWO hex digits -- the first
corresponds to the background; the second the foreground. Each digit
can be any of the following values:
0 = Black 8 = Gray
1 = Blue 9 = Light Blue
2 = Green A = Light Green
3 = Aqua B = Light Aqua
4 = Red C = Light Red
5 = Purple D = Light Purple
6 = Yellow E = Light Yellow
7 = White F = Bright White
If no argument is given, this command restores the color to what it was
when CMD.EXE started. This value either comes from the current console
window, the /T command line switch or from the DefaultColor registry
value.
The COLOR command sets ERRORLEVEL to 1 if an attempt is made to execute
the COLOR command with a foreground and background color that are the
same.
Example: "COLOR fc" produces light red on bright white
.
MessageId=10020 SymbolicName=MSG_MAX_PATH_EXCEEDED
Language=English
Maximum path length exceeded - %1
.
;#endif // _CMDMSG_