Supported arguments and flags

%SEQZAP_EXE% differentiates between flags, which do not take an argument, and arguments, which do take an argument.

Flags

-v

--verbose

Instructs SeqZap to write the execution log of the test on the standard output console during execution.

-s

--silent

Instructs SeqZap to not write any output on the standard output console.

Normally %SEQZAP_EXE% will inform you about command line arguments it does not understand, or script files which could not be found, but with the silent flag %SEQZAP_EXE% will not output anything.

-vv

--extra-verbose

Be extra verbose, allow SeqZap to write startup and shutdown progress to the standard output console.

--verdict-error

Normally SeqZap will return 0, even if the execution did not result in a Pass or Unset verdict, but if this flag is set then SeqZap will return 2 if the test failed or resulted in an error.

--debug

Set SeqZap in DEBUG mode, this is equivalent to clicking the Debug -> Debug Mode menu item in SeqZap Studio.

DEBUG mode changes how much logging is done.

--dry-run

Only parse the script files, do not start execution.

--wait

Wait for the user to hit a key before stopping the command line interface.

--ignore-multiple-configuration-properties

If the same configuration property is set multiple times on the command line (or in .SeqZapCmdFile files) SeqZap will normally report an error and execution will not start. By specifiying the --ignore-multiple-configuration-properties flag, multiple --set arguments for the same configuration property is allowed and the last specified value will be used.

--skip-unsatisfied

If the test-suite to execution contains test cases with unsatisfied preconditions, execution should start anyway, and the test cases with unsatisfied preconditions should be skipped.

--skip-missing-configuration-properties

Skip configuration properties set using the --set which are not found.

Otherwise %SEQZAP_EXE% will not start the test when a configuration property is not found.

If –skip-missing-configuration-properties is specified a message is written to the log and stdout for each configuration property which was not found.

--ui

--user-interface

%SEQZAP_EXE% will show a text-only user interface on the console while the execution is running.

--studio

%SEQZAP_EXE% will start SeqZap Studio with the exact same parameters as it was started with itself. SeqZap Studio handles the following command line arguments:

--print-sort-alphabetically

--print-system-files

--print-only-test-cases

--print-only-test-steps

Specifies how the printed Script Files should look, see the Printing section of the manual for more.

Arguments

-f <filename>

--file <filename>

Specify the script file to load, this can also be a SeqZap project file.

-l <filename>

--log <filename>

Append the execution log to the given filename.

-s <suite name>

--suite <suite name>

Select the test suite to run, if the test suite could not be found a list of the possible test suites are written to the standard output console.

-c <test case name>

--case <test case name>

Select the test case to run, if the test case could not be found, or if the found procedure is not a test case, a list of the possible test cases are written to the standard output console.

-p <procedure name>

--procedure <procedure name>

Select the procedure to run, if the procedure could not be found a list of the possible procedures are written to the standard output console.

--partner

Select the partner to execute the selected test through. The example below executes the All test suite using the UntilFail partner.

%SEQZAP_EXE% -f MyProject.SeqZapProject –s All –partner UntilFail

--reference <filename>

Add a temporary reference from the file given using the –f argument to the script file identifier by the given filename.

This reference will not be written to the script file, but will only exist temporarily during this SeqZap Command Line execution.

-r <report name>

--report <report name>

Tell SeqZap to generate the given report after execution has finished, the report will be written to the same directory as script file given using the –f argument and the filename will follow the following pattern:

Report <project name> <date> <time> <report name>.<report default file extension>

If the report name contain whitespace the report name has to be enclosed in ” (quotes)

%SEQZAP_EXE% -f MyScript.szs –r Run --report “Detailed Browsable Report”

--rf <report name>=<filename>

--reportfile <report name>=<filename>

Tell SeqZap to generate the given report just as using the –r argument, but do it to the filename specified after the equal sign in the argument.

There is no reason to use both arguments, since this argument will also tell SeqZap to generate the report.

As with the –r argument, the argument needs to be enclosed in “ (quotes) if it contains whitespace

%SEQZAP_EXE% -f MyScript.szs –r Run --rf “Detailed Browsable Report=report.html”

--set <name>=<value>

Specify the value of configuration properties or the input parameters to the procedure specified using –p.

The example below sets the value of the PortName configuration property defined on the project.

%SEQZAP_EXE% -f MyProject.SeqZapProject –s All –-set Project.PortName=COM1

If the same configuration property is specified multiple times SeqZap will report an error, and execution will not start. This behavior can be ignored by specifying the --ignore-multiple-configuration-properties flag.

--print <filename>

Print the script as an HTML file, see the Printing section of the manual for more.