Running an RTSS Application

When you use RtssRun to run an RTSS process, it uses the RTX64 loader to launch the RTSS process with the provided parameters.

The user must be a member of the RTX64Users group to be able to run an RTSS application with RTSSRun.

NOTE: Environment variables are not automatically expanded.

RtssRun does not support loading RTSS and RTDLL files that have pathnames containing Unicode characters with code points greater than 255. Unsupported characters include all Japanese, Chinese, Greek, Hebrew, Cyrillic, and Korean characters, as well as characters from many other non-Latin languages. The only supported characters are ASCII and ISO Latin-1 (ISO/IEC 8859-1), which includes characters with Unicode code points between 128 and 255, such as 'µ', 'ö', 'é', 'ß', 'ñ', 'ç'.

To run an RTSS application:

Type the following at a command prompt:

RtssRun [/a affinity_mask] [/p ideal_processor] filename.rtss

NOTE: If the RTSS application you are trying to run has not be stamped by the StampTool, an error message will appear:

This application was not built with a valid license.

See StampTool for instructions on stamping RTSS applications.

NOTE: You cannot run an RTSS process from a mapped drive.

NOTE: Members of the RTX64Users group can run RTSS applications via RtssRun, which starts the RTX64 Subsystem. However, these members will not be able to see the run status of the Subsystem, due to the group's access restrictions. For more information, see User Groups and Access Permissions.

Examples

The following command runs sample.rtss and displays a message if sample.rtss fails to load:
RtssRun sample.rtss

The following command runs sample.rtss, specifying processors 2 and 3 for the processor affinity mask.
RtssRun /a (2,3) sample.rtss

The following command runs sample.rtss, specifying processor 2 as the ideal processor.
RtssRun /p 2 sample.rtss