qc_script_console :: QUARC MATLAB Functions

navigation bar

qc_script_console

Opens a console to monitor a script executable's standard input and output.

Syntax

qc_script_console(script, target_uri, 'all') % Opens a console for all script executables for the given target
qc_script_console(script, target_uri)        % Opens a console for the script executable on the given target
qc_script_console(script, 'all')             % Opens a console for all script executables for the associated target
qc_script_console(script)                    % Opens a console for the script executable on its associated target

Description

Opens a console to monitor a script executable's standard input and output when the executable runs on a QUARC target. If the executable name takes the form '*.rt-target type' then it will open a console for all script executables on the target. Alternatively, use a normal script executable name and the 'all' option.

If no target URI is specified then the default target URI is used for the script executable. This default is returned by the qc_get_target_uri function when passed the script executable name.

Note that the standard output and error streams are buffered so output will not appear immediately unless the output streams are flushed in the code.

Parameters

script

The name of the script executable to run, including extension e.g. myscript.rt-win64

target_uri

A string indicating the target URI. eg. tcpip://localhost:17000

flag

An optional 'all' flag indicating that all script executables on the target should be monitored.

Outputs

This function has no outputs.

Examples

qc_script_console('myscript.rt-win64');                   % Open a console to monitor myscript.rt-win64 on the associated Win64 target
qc_script_console('*.rt-win64');                          % Open a console to monitor all script executables on the default Win64 target
qc_script_console('*.rt-win64', 'tcpip://remhost:17000'); % Open a console to monitor all script executables on the remote Win64 target, remhost