|
| |
|
K
E
Y |
Common Commands |
INTERNAL |
External |
/SWITCH |
Parameter |
Help text |
AddonTool |
|
Mounted Commands |
.Mount/\Command |
CmdShorthand |
#Constant |
$FUNCTION |
:Procedure |
!GuardNote |
|
Operating Systems |
NT/2K/XP/K3 |
NT Only |
NT/2K |
2K Only |
2K/XP |
XP Only |
XP/K3 |
K3 Only |
2K/XP/K3 |
Related Resources from the NT/2K/XP/K3 Command Library
|
Resource |
|
Short Description |
|
.Call |
|
Calls the currently loaded Command Library |
Go straight to !GuardNotes. (updated
2004-07-13)
This is the Mounted Help Text. We also archive the Common Help Text
for NT,
2K, XP
and K3
Description
Calls one batch program from another.
Syntax
|
CALL |
|
[drive:][path]filename
[batch-parameters] |
Parameters and Switches
|
batch-parameters |
|
Specifies any command-line information required by the batch program. |
Examples, Notes and Instructions
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:
%~1 - expands %1 removing any surrounding quotes (")
%~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
%~s1 - expanded path contains short names only
%~a1 - expands %1 to file attributes
%~t1 - expands %1 to date/time of file
%~z1 - expands %1 to size of file
%~$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.
%~ftza1 - expands %1 to a DIR like output
line
In the above examples %1 and PATH can be replaced by other valid values. The %~ syntax is terminated by a valid argument number. The %~ modifiers may not be
used with %*
GuardNotes
Things that are different (by design, by accident or otherwise)
The /? parameter
CALL cannot take /? as one of the parameters of the called program or command unless it is quoted ("/?").
CALL will always parse /? as a request for the CALL
/? help screen, regardless of where the /? is in the command line.
For example, CALL
ECHO /? displays the help for
CALL, not ECHO.
CALL
ECHO "/?" does not display the
ECHO help screen either but rather echoes /? to the console.
This behavior also affects the operation of the .Call
command.
|
