RtssRun Usage

RtssRun can be used to run an RTSS application from a Windows command prompt. It displays all output in the console in which it is executed. If RtssRun is not executed in a console, or from a script executing in a console, a console will be created to display the output.

NOTE: RtssRun cannot be used to start components of the Subsystem, such as the Network Abstraction Layer (NAL) or RT-TCP/IP Stack.

NOTE: See RTSS/RTDLL Binary Compatibility with RTX64 Runtime for an overview of the validation workflow that is used to determine whether an RTSS/RTDLL binary is compatible with the RTX64 Runtime version that attempts to run it.

NOTE: As of RTX64 4.5, RtssRun does not provide message boxes that would delay a script when an error occurs.

Usage

RtssRun [/a affinity_mask] [/c] [/e expand_size] [/i initial_size] [/r start | firstalloc] [/p ideal_processor] [/s order_id] [/w] filename.rtss [args]

Parameters

/a (1,2,...,63)

Affinity mask - specifies the processor affinity mask, as a list of comma-separated processor numbers, for the RTSS application about to run.

Use integers or hexadecimal values to identify the processors. Be sure to use system-wide processor numbers.

NOTE: The affinity mask can only contain processors associated with RTSS during configuration of the Subsystem.

Checks compatibility of an RTSS and RTDLL binary with the target Runtime and lists any compatibility issues. Among its compatibility checks, this flag:

detects references to APIs that don’t exist in the Runtime.
detects references to APIs that have undergone breaking changes.

NOTE: This parameter must be called by itself.

/e expand_size

The amount of local memory, in kilobytes, by which to expand the process MSpace. This applies only when Use local memory is selected in RTX64 Control Panel.

NOTE: If this parameter is omitted, the process will use the globally configured value.

/i initial_size

The initial amount of local memory (allocated at process startup), in kilobytes, within the process external MSpace. This applies only when Use local memory is selected in Control Panel.

NOTE: If this parameter is omitted, the process will use the globally configured value.

/p n

Ideal processor - sets the ideal processor for the RTSS application about to run. Use an integer or hexadecimal value to identify the processor and be sure to use its system-wide processor number.

NOTE: If the processor affinity mask is specified by /a, then the ideal processor set by /p must be one of the processors specified in the affinity mask.

/r start | firstalloc

The time of allocation of the process external MSpace. This switch requires one of these valid arguments:

start - allocates the MSpace at process start
firstalloc - allocates the MSpace at the first memory request

NOTE: If this parameter is omitted, the process external MSpace will be allocated when the first allocation request which uses that MSpace occurs.

/s order_id

Adds the specified binary as a scheduled task with the specified <order id>. An <order id>of -1 places the scheduled task at the end of the list.

NOTE: You can obtain the order id of a scheduled task by running the command rtsskill /s.

NOTE: You must provide the full path name to the binary if it is not located in a folder listed in the RTX64 search path.

NOTE: If any of the /e, /i, or /r parameters are omitted when parameter /s is specified, the scheduled process will use the globally configured value for the omitted parameter(s).

Causes RtssRun to wait for the RTSS process to complete before exiting. When this parameter is specified, RtssRun displays the exit code of the RTSS process before it exits, unless an interruption occurs.

Behaviors for typical scenarios:

Scenario	Behavior
Normal termination of the RTSS process	RtssRun displays this message: Process has exited with the value <exit code>
RtssKill is used, or RtTerminateProcess is called, on the RTSS process	RtssRun displays this message: Process has exited with the value <exit code>
RTX64 Control Panel attempts to stop the Subsystem while RtssRun is waiting on the RTSS process	RtssRun exits without displaying an exit code
RtssRun is terminated	RtssRun exits without displaying an exit code

NOTE: This parameter is ignored when parameter /s is also specified.

filename

A simple file name, relative pathname, or absolute pathname to the RTSS application.

[args]

Parameters to the RTSS application being run.

Examples

Syntax	Description
Rtssrun /p 2 srtm.rtss /n 2 /f /h 60 Rtssrun /p 3 srtm.rtss /n 2 /f /h 60	If multiple cores are available, you can run instances of srtm.rtss on each processor to measure their latencies. NOTE: /n 2 /f /h 60 are arguments for srtm.rtss. See Using SRTM for more information.
Rtssrun /a (2,3) sample.rtss	Runs sample.rtss and specifies that the process thread will only run on processors 2 and 3.
Rtssrun /a (1,2) /p 2 srtm.rtss	Runs sample.rtss and specifies that the process thread will only run on processors 1 and 2 while setting the ideal processor to 2.
Rtssrun /s 0 srtm.rtss	Adds srtm.rtss as a scheduled task with an order id of 0.