A command is the name of a built-in DESL function. The function is the main building block of the integrated system of tools collectively known as DESL.
[Jump down to the repertoire of DESL Commands]
Each function can have none, one or more options associated with it, and each option can have none, one or more arguments associated with it. Options define the scope of a command and arguments narrow the scope of the associated options.
A schematic example of an instance of a DESL command and option/argument list is shown in this excerpt from a longer hypothetical input sequence below :
Everything on one line :
cmd argument1 arg2 ...
or
More conventional command secifications on multiple lines :
cmd
option1 argument1
option2 argument1 argument2 argument3
option3
option4 argument1
option5 argument1
go
The go option ends the collection of options and options+arguments and tells DESL to invoke the function named by the command and report the results.
In general, using this type of command-line interface, the user enters the name or abbreviation of the desired command followed by a carriage return.
The entry of the command's name or abbreviation signals to DESL to expect more input particular to the command entered until the time when one of the special options go, quit or cancel is encountered.
All blank-delimited input encountered before one of these three
special options is gathered and preliminarily parsed to verify its syntax.
If the syntax of all of the input - options and their respective
arguments - is judged to be correct, then the input
is passed to the function's processor for a final determination of
completeness and legality and then for its use.
Here is a particular example of the use of the "fit" command with the DESL prompts being in the bold font and, as above, the option names being in red :
DESL> fit
Fit> files run10
Fit> names alpha cl cd
order 3 curve poly
Fit> values -5 to 25 by 1
Fit> go
DESL> stop
At the DESL command-level prompt (DESL>), once the system has recognized the intent of the user to cause the "fit" function to be invoked, the Fit> prompt is issued and DESL waits for blank-delimited input in the form of options and option arguments to fully describe the user's intentions.
Upon encountering the option go DESL knows that all input, as far as the user is concerned, has been completed and that it should now go perform the fit as described.
If any run time problems are encountered they will be reported and appropriate action(s) taken.
Once the "fit" has been completed, successfully or unsuccessfully, DESL returns to the command level prompt for the next command. In this example, "stop" was entered, indicating that the user is ending this DESL session.
The above example is very typical of the use of DESL in the command-line interface mode. The use of DESL in the gui mode makes the issuance of the information in the command-line form transparent to the user by presenting them with a Tcl/Tk-based graphical interface from which information similar to that supplied during the command-line mode of entry is supplied to DESL.
Please click the command name for more information for that command or a green ball () for one or more examples as to how the command can be used. Text displayed as examples may be useful to "save as" locally as a template for a similar example.
autopathfile | Set or (in)activate automatic "pathfile" per command | |
autoread | Set or (in)activate automatic "readsn" per command | |
autosys | Toggle direct system command capability | |
cleanup | Remove tagged files | |
clear | Clear the screen | |
continue | Restart a DESL session from named file (see "hold") | |
copy | Copy one file to a new file (with filters, etc) | |
create | Create an ascii file inline | |
do | Looping control | |
diff | Comparison between two files' variable values | |
echo | Toggle system echoing | |
endcreate | Ends the creation of an inline ASCII file | |
edit | Edit an ASCII file(s) | |
editor | Define the default text editor | |
else | Conditional branch point | |
elseif | Conditional branch point | |
endif | Conditional branch point | |
enddo | Looping control | |
endm | End a macro definition | |
endw | End a while loop | |
equation | Execute Fortran-like equations | |
extra | Build your own DESL-compatible stand-alone executable using the Compaq Fortran compiler or Unix Fortran compiler, the supplied .OBJ or .o file and user-supplied Fortran code. | |
extremes | Determine min's/max's in file(s) | |
files | List current new files | |
filesuffix | Set or clear new file suffix string | |
filter | Apply filters to data in file(s) | |
fit | Curve fitting in file(s) | |
hold | Suspend DESL session into named file then stop (see "continue") | |
holdn | Suspend DESL session into named file (see "continue") | |
if | Conditional branch point | |
input | Use an alternate file as DESL input | |
large | Use "large" memory model (file based) | |
learn | Determine "best set" of coefficients for data fit | |
list | Define a set of attributes for later application | |
log | Toggle system logging | |
macrolib | Load system macro(s) | |
merge | Combine files laterally | |
namecase | Toggle forced-upper case for SIF name use | |
noop | No-op command | |
overstore | Toggle state of system file overwriting ability | |
page | Define the default output page size | |
password | Specify the DESL password (and date if Demo DESL) | |
path | Define alternate lower-priority file paths | |
Print information from file(s) to output | ||
pubplot | Produce PostScript publication-quality graphical output | |
record | Toggle user input logging | |
register | Perform DESL register actions | |
say | Print line to output | |
saveinput | Move previous user input to file | |
sifstats | Display statistical information for SIF file(s) | |
sleep | Halt action for specified time | |
spawn | Generate multiple file(s) from file(s) based on data | |
stack | Combine files longitudinally | |
statistics | Calculates various statistical parameters | |
status | Display DESL status information | |
stop | End DESL and use DESLEXIT if present | |
stopn | End DESL and do not use DESLEXIT if present | |
system | Execute a command outside of DESL | |
tally | Display categorized file parameter information | |
time | Display current date/time | |
translate | Translate between file formats | |
until | Conditional branch point | |
variables | Establish a list of alternate SIF variable names | |
versions | Display current versions of DESL commands | |
while | Conditional branch point | |
whilelimit | Limit on while loop transversals |
30 Research Drive Hampton, VA 23666 Voice: (757) 865-1400 Toll Free: (800) 288-3998 FAX: (757) 865-8177 |