User guide

RGS properties 136
8-3 Setting properties on the command line
Properties can also be set on the command line when the Receiver and Sender are started. Property values
entered on the command line override any properties set with other methods. All properties must begin with a "-"
on the command line to be recognized as a valid property. For example (on Linux):
rgreceiver.sh -Rgreceiver.Network.Timeout.Warning=10000
This command will start the RGS Receiver with the Rgreceiver.Network.Timeout.Warning property set to
10,000 milliseconds (10 seconds). If any property is set more than once on the command line, the value of the
last entry is used. No whitespace characters are allowed between the property name, the "=" character, and the
property value. For example:
rgreceiver.sh -Rgreceiver.IsSnap = 1
This property declaration is invalid because of the whitespace on both sides of the "=" character. Properties of
type int vector cannot be set on the command line.
CAUTION: If a property name is misspelled, no user notification is provided, and the misspelled property will
not take effect. If you specify a property in a configuration file or on a command line, and it does not appear
to take effect, first verify that the property name is spelled correctly and that upper/lower case usage is correct.
8-4 Receiver properties
This section describes the Receiver properties. RGS supports two types of Receiver properties:
• Per-Receiver properties—The per-Receiver properties affect all Remote Display Windows generated by the
Receiver. As noted in Section 2-8-3, “Many-to-one connection
,” a Receiver can connect to multiple Remote
Computers (and therefore generate multiple Remote Display Windows).
• Per-session properties—New in RGS 5.0, the per-session properties (also known as per-connection
properties) allow the user to specify the property values of each RGS connection. For example, in a many-to-
one configuration, per-session properties can be specified for each Remote Display Window displayed by
the Receiver.
8-4-1 Receiver property hierarchy
RGS supports the following hierarchy of methods to set the Receiver properties (see Figure 8-1).
Figure 8-1 Receiver property hierarchy
Properties set by methods higher on the list override properties set by methods lower on the list. For example, a
Receiver command line property can override a property specified in the rgreceiverconfig file. Similarly, an
archive file property (saved from the previous Receiver Control Panel session) can override a Receiver default
property.
Properties set using the Receiver Control Panel
The Receiver Control Panel enables the user to modify the values of many Receiver properties. For example, as
described in Section 6-6, “Remote Clipboard,” the user can enable/disable Remote Clipboard using the Receiver
Control Panel. This affects the Rgreceiver.Clipboard.IsEnabled property, as described in Section 8-4-10,
“Receiver clipboard properties
.”
Properties set using the Receiver Control Panel
Receiver command line properties
rgreceiverconfig file properties
Archive file properties
Receiver default properties
Highest
Lowest
Properties set using the Receiver Control Panel
are saved as archive file properties upon closing
of the Control Panel. Upon restarting the RGS
Receiver, the last-saved archive file properties
are in this position in the Receiver property hierarchy.