HFSS15: DSO Configurations in the Registry

The DSO configuration information is encoded into the registry using several pathnames. When DSO configurations are changed using the User Interface, the code ensures that the settings in the registry are consistent. Care should be taken when editing the registry to ensure that the different registry settings are consistent. For example, each DSO configuration has an associated name and all configuration names must be different.

The number of DSO configurations (an integer) is stored in the registry setting Desktop/DSOConfigurations/NumItems. The first configuration is stored in registry setting Desktop/DSOConfigurations/Item0. Additional configurations, if any, are stored in settings Desktop/DSOConfigurations/Item1, Desktop/DSOConfigurations/Item2, Desktop/DSOConfigurations/Item3, etc.

Each configuration is stored in a string of format $begin 'name' $begin '' host_list $end '' $end 'name', where

name is the name of the configuration, and

host_list is the list of hosts, described below.

The host_list is a list of entries of format 'hostname'='true' or 'hostname'='false'. Here, hostname is the name or IP address of a host. The value after the equal sign is 'true' if the entry is enabled. The value after the equal sign is 'false' if the entry is disabled. The entries must be separated by white space.

In this format, single quotes are used to enclose names and values. The names in the "$begin ''" and "$end ''" parts of the format are empty strings, so they appear as adjacent single quotes. The backslash character () is used as an escape character in single quoted strings. The escape character removes the special meaning of the following character. For example, to include a single quote within a single quoted string, prefix the single quote within the string with the backslash character. For example, the value represented by the single quoted string 'Mel's Diner' is Mel's Diner. To include a backslash in a single quoted string, two backslashes must be present; the first backslash removes the special meaning of the second backslash. Because UNC hostnames begin with two backslashes, to include an UNC hostname in a host_list, the single quoted hostname must begin with four backslashes. For example, '\\myhost'='true' indicates that UNC hostname \myhost is enabled in the DSO configuration.

Extra white space in a DSO confguration string is ignored unless it is part of a name or value within single quotes.

Related Topic

General Information on DSO Configurations