Download Now | Pricing / Purchase 

DADiSP 6.7 B02 Release Notes

Command Line Arguments


DADiSP supports a number of command line flags invoked on startup to control the initial behavior. A command line flag begins with a leading - or / character followed by an optional = to specify arguments. For example, if the name of the DADiSP executable is dadispnt.exe, then


   dadispnt -d=2

sets the initial display size to maximized.

Multiple command line flags may be specified.

Display Options


Options that determine the initial display mode.

-d=0hidden
-d=1normal
-d=2maximized
-d=3iconic


Running DADiSP in hidden mode (-d=0) is useful when using DADiSP as an analysis engine in conjunction with another program.

Data Options


Options that determine the initial Labbook and Worksheet.

-l=labbookpathopen a specific Labbook
-w=worksheetnameopen a specific Worksheet


If labbookpath or worksheetname contains spaces, it should be enclosed in quotes. For example:


   dadispnt -w="C:\Documents and Settings\users\DWK\MyWork.dwk"

If worksheetname does not refer to a DWK and labbookpath is not specified, the Worksheet must reside in the current Labbook.

Command File and SPL Options


Options that specify loading of SPL functions.

-c=comfilenameload and run a command file
-s=splnameload and run an SPL function
-x=splnameload and run an SPL function with the display hidden and exit upon completion


For example:


   dadispnt -c=demo.dsp

loads and runs the DADiSP demo script.

A command line SPL function can accept arguments. For example, consider the following SPL function named ctest.spl:


  // ctest.spl 
  ctest(n, m)
  {
      if (argc < 2)
      {
          if (argc < 1) n = 2;

          m = n;
      }

      newworksheet(2, 0);

      eval(sprintf("W2 := randn(%d, %d)", n, m));
  }


Invoking


   dadispnt -s=ctest

creates a 2 window worksheet, sets the formula of W2 to randn(2, 2) causing W2 to contain a 2x2 array of random values.

If multiple arguments are specified, enclose splname in quotes. For example:


   dadispnt -s="ctest(10, 5)"

same as above except the formula of W2 is randn(10, 5) and contains a 10x5 random array.

Single and double quotes can be used for string arguments. For example:


  // ctest2.spl 
  ctest2(n, title)
  {
      if (argc < 2)
      {
          if (argc < 1) n = 2;

          title = "Test";
      }

      newworksheet(2, 0);

      eval(sprintf("W2 := randn(%d)", n));

      label(W2, title);
  }

Now


   dadispnt -s=ctest2(10)

creates a 2 window worksheet, sets the formula of W2 to randn(10) causing W2 to contain a 10x10 array of random values. W2 is labeled with the text Test.


   dadispnt -s="ctest2(10, 'My Label')"

same as above except W2 is labeled with the text My Label.

ActiveX Options


Options that specify ActiveX capabilities.

-arun as automation server
-erun as embedded server
-registerregister as an ActiveX server
-unregisterunregister as an ActiveX server


The -a and -e options are specified together when embedding DADiSP into another application.

Configuration Options


Options that specify configuration settings.

-cnf=configfileload a session specific configuration file


The standard configuration file named dadisp.cnf is loaded first, then any runtime settings are loaded from the session file dadisp.ses and finally the settings specified in the command line configuration file are loaded. In this way, the command line settings can override the initial base and runtime settings.

Miscellaneous Options


Additional Options

-passworddisplay password request dialog if password required
-versiondisplay version information and exit


Alphabetical Listing




-arun as automation server
-c=comfilenameload and run a command file
-cnf=configfileload a session specific configuration file
-d=0hidden
-d=1normal
-d=2maximized
-d=3iconic
-erun as embedded server
-l=labbookpathopen a specific Labbook
-passworddisplay password request dialog if password required
-registerregister as an ActiveX server
-s=splnameload and run an SPL function
-unregisterunregister as an ActiveX server
-versiondisplay version information and exit
-w=worksheetnameopen a specific Worksheet
-x=splnameload and run an SPL function with the display hidden and exit upon completion



 Configuration | Keyboard Shortcuts