DOSSHELL Subroutine
Sends a command to the Command Line Interpreter.
call DosPutData(string:Command_SV)
Parameters
Command_SV
A string variable that holds the command to be processed by the Command Line Interpreter.
Returns
One of the following codes will be returned in the pseudo variable, "errorlevel":
DosErrorFree |
Operation was successful. |
DosBusy |
A previous command is still being processed. |
DosInitial |
The command line Interpreter is still initializing. |
DosDataRecd |
There is data waiting to be processed by the ESL application. |
DosErrorRecd |
An error has previous occur, so CMD.EXE needs to be restarted with DosStartCmd |
Description
This routines sends a command to the command line interpreter. The command will be executed once the new line character is received, so we recommend all command strings include a new line (i.e. "\n") as the final character. The buffer size, has been set to 1024 bytes, so all commands must be no greater than this length. There is no filtering of commands, so it is possible to crash or terminate the command line interpreter, for example; by sending "exit\n" or "echo off\n", as commands.