:SYSTem:VSA:STARt

command/query

Starts an instance of the 89600 VSA Software if one is not already running.

Command Syntax:

:SYSTem:VSA:STARt [newInstance] [,version] [,hostname] [,port] [,waitSecs] [,createOptions] [,commandLineArgs]

<newInstance>	::=	0 \| 1
<version>	::=	String
<hostname>	::=	String
<port>	::=	Integer number
<waitSecs>	::=	Integer number
<createOptions>	::=	Integer number
<commandLineArgs>	::=	String

Query Syntax:

:SYSTem:VSA:STARt?

Returns

::=

0 | 1

Remarks:

    newInstance:  Boolean with value of 1 or 0.  Default is 1.
        version:  Version of the 89600 VSA Software to start.  Default is empty string 
                  which indicates the latest available version.
       hostname:  String of the hostname (currently localhost or an empty string are 
                  the only valid values). Default is empty string which indicates to 
                  use localhost.  
       waitSecs:  How many seconds to wait before timing out.  Use a value less than 
                  or equal to 0 to wait indefinitely. Default is 0 (wait indefinitely).
           port:  Integer port number of the 89600 VSA Software to use.  Default is -1 
                  and indicates to use the default port number which is 60189.
  createOptions:  Integer bit field of the startup options (see the equivalent .NET API 
                  documentation for more detail)
                     0 = None
                     1 = Use 32-bit application
                     2 = Use 64-bit application
                  Default value is 0 which uses whatever the startup preferences are in 
                  the 89600 VSA Software.
commandLineArgs:  String of command line arguments.  Default is empty string.  See the 
                  equivalent .NET API documentation for more detail.

The optional arguments support was added in version 15.0.

The query form of :SYST:VSA:STAR? indicates whether the SCPI translator is currently connected to a running instance of the VSA application.

Example:

// Startup, no options specified (uses defaults)
:SYST:VSA:STAR

// Startup new instance, version 15.0, localhost, default port (60189), wait 50 seconds
:SYST:VSA:STAR 1,"15.0",,-1,50

// Startup new instance, version 15.0, localhost, port 60189, wait 50 seconds, 
// use 32-bit
:SYST:VSA:STAR 1,"15.0",,60189,50,1

// Startup new instance, version 15.0, localhost, port 60189, wait 50 seconds, 
// use 32-bit, use specified setup file
:SYST:VSA:STAR 1,"15.0",,60189,50,1,'/SETUP:"C:\Temp\setup.setx"'
or
:SYST:VSA:STAR 1,"15.0",,60189,50,1,"/SETUP:""C:\Temp\setup.setx"""

Version:

13.00 or later

.NET Equivalent:

For more operation and usage information, see:

Agilent.SA.Vsa.Interfaces.ApplicationFactory.Create