qc_set_default_target_uri :: QUARC MATLAB Functions

navigation bar

qc_set_default_target_uri

Sets the default URI for a particular protocol or model URL.

Syntax

qc_set_default_target_uri(protocol, uri)  % set default target URI for specified protocol
qc_set_default_target_uri(model_uri, uri) % set default target URI for default model URI
qc_set_default_target_uri(uri)            % set default target URI for the model URI of the default target type

Description

Sets the default target URI for the specified protocol or model URI. The default target URI is used as a template to derive the target URI from the URI for the model, according to the protocol used for the model URI. The default target URI may be retrieved using qc_set_default_target_uri. The default setting is persistent across Matlab sessions and is specific to the protocol. If a model URI is given, the protocol for the URI is extracted and used to look up the default target URI.

If no argument is specified then the default model URI associated with the default target type is used as the argument.

The default target URI may contain the following format specifiers, which are used to derive the target URI from the model URI:

%m	=	the model name
%h	=	the hostname from the model URI
%p	=	the port from the model URI (not usually used)
%P	=	the path from the model URI i.e. the portion following the '/' after the hostname and port (not usually used)
%o	=	the options from the model URI i.e. the portion following the '?' (not usually used)
%f	=	the fragment from the model URI i.e. the portion following the '#' (not usually used)

Parameters

protocol

A string specifying a valid QUARC communication protocol e.g. 'tcpip'.

model_uri

A string containing a model URI e.g. 'shmem://%m:1', or 'tcpip://qnx-dev:17001'.

uri

A string containing the new template used to derive the target URI from the model URI e.g. 'tcpip://%h:17000'

Outputs

This function has no outputs.

Examples

% Sets the default target URI for the TCP/IP protocol to 'tcpip://%h:17000'
qc_set_default_target_uri('tcpip', 'tcpip://%h:17000');