RtssRun Usage

RtssRun can be used to run an RTSS application from a Windows command prompt.

Usage

RtssRun [/l][/n][/a affinity_mask][/p ideal_processor][/s order_id]  filename.rtss

Parameters

/l

If Request from Windows is enabled in the RTX64 control panel, the /l switch overrides this setting and causes RTSS applications to request memory from the RTX64 local memory pool instead whenever memory is allocated.

NOTE: /l and /n cannot be used at the same time.

/n

If Request from local memory pool is enabled in the RTX64 control panel, the /n switch overrides this setting and causes RTSS applications to request memory from the Windows non-paged pool instead whenever memory is allocated.

NOTE: /l and /n cannot be used at the same time.

/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. For example:

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.

/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.

/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 the path is not included in a search path.

 

filename

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

[arg]

Parameters to the RTSS application being run.

Examples

Syntax Description

Rtssrun /l /p 1 /s 0 srtm.rtss /h 15

Adds srtm.rtss to the scheduled task with order id 0 using local memory and sets the ideal processor to 1.

NOTE: /h 15 is an argument for srtm.rtss. See Using SRTM for more information.

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 srtm.rtss simultaneously to see the 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 processors 2 and 3 for the processor affinity mask.

Rtssrun /a (1,2) /p 2 srtm.rtss

Runs sample.rtss and specifies processors 1 and 2 for the processor affinity mask while setting the ideal processor to 2.

Related topics: