The d3flash utility is a DOS command that allows the launching of BASIC modules from a Windows command prompt. This launcher can be, in Windows, associated to the D3F extension and invoked automatically, thus making the D3F executable.
D3flash {options}
| options | |
| -a args | Specifies the arguments that can be retrieved by a tclread statement. More than one -a switch
can be present, in which case all tokens are concatenated with one
space between each of them. If there are spaces in the arguments,
surround the arguments with double quotes. The -a option is ignored if used with the -e option. Passing double-quotes in the string To pass double-quotes in your string arguments, the double-quotes you want passed must be preceded (escaped) by a \ (backslash character). Consider the program below: tclarg 001 tclread a 002 print "ARGUMENTS '" : a : "'" 003 end The example below illustrates passing a single word parameter enclosed in quotes. C:\D3\D3Programs>d3flash -f c:\D3Modules\tclarg -a \"This\" ARGUMENTS 'c:\D3Modules\tclarg.D3F "This"' The example below illustrates passing a multiple word parameter enclosed in quotes. C:\D3Programs>d3flash -f c:\D3Modules\tclarg -a "\"This is a test\"" ARGUMENTS 'c:\D3Modules\tclarg.D3F "This is a test"' |
| -d database | Specifies the default database in which the module will run. This database name is used when doing an execute or requiring some VME support, and to determine where files are when trying to open them without an explicit path. If there is no -d switch, the Windows environment variable %D3DATABASE% is used. If this variable is not specified, the module must use only explicit file names, and will log on to FSI:DM if a VME service is needed. |
| -n domain | Specifies the D3 domain in which the module will run. If there is no -n switch, the Windows environment variable %D3DOMAIN% is used. If this variable is not specified, the module is run in the default domain. |
| -e {outfile{.exe}} | Converts the module into an EXE. If not specified, the module name, stripped of the .D3F extension, is used. Note that the -t, -d, and -n switch settings are retained in the .EXE which is produced. The -a, -h and -r options are ignored if used with the -e option. |
| -f {module{.d3f }} | Specifies the module to run or to use to make the .EXE. |
| -h | Help message. The -h option is ignored if used with the -e option. |
| -t | Use Telnet I/Os. A Telnet client is spawned as soon as the module does a print or input statement. The Telnet client is closed as soon as the module terminates. If this option is not used, all I/Os are directed to the Windows command prompt console. |
| -r | Run (default). The -r option is ignored if used with the -e option. |