writesetting

Modify settings within SourcePoint.

Syntax

writesetting(type, name, value)

Where:

type	is an nstring or string constant specifying the type of setting.
name	is an nstring or string constant specifying the setting name.
value	is an ord4 specifying the value to assign to the setting.

Discussion

This writesetting command is used to modify settings within SourcePoint. Usually, these settings are changed via the UI (e.g., the Emulator Configuration dialog box). There are times, however, when it is convenient to be able to change these settings within a macro file.

The type argument specifies the type of setting to change. Currently, the only type supported is ”em” for emulator configuration settings.

The name argument specifies the name of the setting to change. The name is not what is displayed in the UI, but rather the name used in the SourcePoint project file. Names can be obtained by looking in the project file in the Emulator Configuration section.

The value argument can be obtained by changing the emulator configuration setting in question and looking in the project file. For checkbox settings, the value is TRUE or FALSE. For radio buttons, the value usually (but not always) is the zero-based index of the button selected. For drop down lists, the value usually (but not always) is the zero-based index of the entry selected. The safest way to determine value is to look in the project file.

Note: Values in the project file are usually decimal. Regardless, values in the command language are specified using the current command language input radix (specified with the base control variable). If the input radix is hex, and you want to specify a value of 200 decimal, then you need to use 200T as 200 is interpreted as 200H = 512 decimal.

Example

The following example sets the Adaptive TCK setting. The possible values are 0, 1 and 2 corresponding to which radio button is selected in the UI.

Command input:

writesetting("em", "AdaptiveTck", 0)     // 0 = Don't use adaptive TCK

Related Topics:

readsetting