Home

Contact

Sitemap

Can I launch the software from the command line?

Document ID: DQ050
Relevant to following products: WorkOut 2.0 Manta
Document description: How To: Launch the software from the command line.

The Run and Results application can be launched from the command line. This means that Manta/WorkOut can be called from other applications. This document describes the syntax, however an easier method is to use the Command Line Launcher tool described here.

Syntax

MRunRes [/run | /edit] {<ProtocolFile> [<DataFileToImport>]} | <ResultsFile> [/IMPORT:<DataType> <MISFile> <FileToImport>] [/exit]

Where:

Item:	Meaning:
`MRunRes`	The application executable - this is located in the installation directory.
`<ProtocolFile>`	The full path to a protocol file (APR)
`<DataFileToImport>`	The full path to a text file to import (for a `<ProtocolFile>` which imports)
`<ResultsFile>`	The full path to an existing results file (ARS)
`/run`	The specified `<ProtocolFile>` file (which takes measurements) will start the readings once it has been loaded
`/edit`	Opens the specified `<ProtocolFile>` file for editing
`/exit`	The program exits after the post analysis options have been performed.
`<DataType>`	Use sampleids to import Sample ID data or use transn to import data for a specific transform number (substitute n for the 1 based transform number)
`<MISFile>`	The full path to the import script file
`<FileToImport>`	The full path to a text file to the import script file

If the <ProtocolFile> imports data then a second parameter <DataFileToImport> can optionally be given which is the file to import, if this parameter is not given then a file open window is displayed to allow the manual selection of the file to import.

Tip: The maximum command line argument is 255 characters. If the command line argument exceeds this length then a warning message is displayed and the program is exited. To use long command line arguments store the command line argument list in a text file and launch MRunRes passing the text file containing the command line arguments:

MRunRes @<CommandTxtFile>

Where <CommandTxtFile> is the name of the text file to read the command line from (quotation marks are not required here).

Examples

Example:	Action:
`MRunRes`	Opens the existing specified results file
`MRunRes <ProtocolFile>`	Launches the specified protocol file ready to start measurements.
`MRunRes /run <ProtocolFile>`	Launches the specified protocol file and starts the measurements straight away.
`MRunRes /run <ProtocolFile> /exit`	Launches the specified protocol file and starts the measurements straight away exits when finished.
`MRunRes /edit <ProtocolFile>`	Launches the specified protocol file for editing.
`MRunRes <ProtocolFile> <DataFileToImport>`	Launches the specified protocol which imports data and imports the specified file.
`MRunRes <ProtocolFile> <DataFileToImport> /exit`	Launches the specified protocol which imports data and imports the specified file then exits
`MRunRes <ProtocolFile> /IMPORT:sampleids <MISFile> <FileToImport>`	Launches the specified protocol file ready to start measurements and imports the Sample IDs from the file to import using the specified MIS file
`MRunRes /run <ProtocolFile> /IMPORT:sampleids <MISFile> <FileToImport> /exit`	As previous but also automatically starts the measurement process and exits on completion.
`MRunRes <ResultsFile> /IMPORT:sampleids <MISFile> <FileToImport>`	Opens the existing specified results file and imports the Sample IDs from the file to import using the specified MIS file
`MRunRes <ResultsFile> /IMPORT:trans1 <MISFile> <FileToImport>`	Opens the specified results file and imports the table data from the text file to import using the specified MIS file, the results being stored in transform number 1.
`MRunRes <ResultsFile> /IMPORT:trans1 <MISFile1> <FileToImport1> /IMPORT:sampleids <MISFile2> <FileToImport2>`	Opens the specified results file and imports sample ID and transform data from the two files.

Related articles:
DQ244: Is there an easy way to setup WorkOut command line parameters?
How To: Use the Command Line Launcher tool

DQ042: Can I automate the import process?
How to: Import text files as part of an automated process

DQ192: How do I launch MrunRes.exe from the command line?
How To: launch MrunRes.exe from the command line.

DQ189: How to import table based data into WorkOut 2.0 parameters.
How To: Import table based data into WorkOut 2.0 parameters.

Search again

Download software now:

	WorkOut 2.5
	Manta
	Stingray

	Search Knowledge Base
	Browse Knowledge Base
	Submit a query