Set() action

Set() allows various run-time resources (settings) to be displayed and modified.

A related action is the Toggle() action, which flips the value of a Boolean setting.

Parameters

If no parameters are specified, the names and values of all run-time settable resources are returned, one per line.

If one parameter is specified (without = and a value), it names a resource, the value of that resource is returned.

name: Name of resource to display

Otherwise the parameters are of the form name=value, or are given as pairs, where the first is the name and the second is the value.

name: Name of resource to change
value: New value

Deferred resources

New in 4.3

Some resources, such as the model resource, cannot be modified while connected. The -defer option of Set() makes setting these resources simpler.

When -defer is specified as the first parameter, the new values will not be applied until the connection is broken. (Note that if the reconnect resource is true, the connection is never considered broken, and reconnect needs to be set to false to allow the deferred resources to be applied.)

If -defer is the only parameter, or no values are given, deferred resource values will be displayed.

Examples

Display all resources.

Set()

Display one resource.

Set(monoCase)

Change one resource.

Set(monoCase,true)
Set(monoCase=true)

Change multiple resources.

Set(model,3279-2-E,oversize,81x24)
Set(model=3279-2-E,oversize=81x24)
Set(model=3279-2-E,oversize,81x24)

Change the model after the connection is broken.

Set(-defer,model,4)

Display deferred resources.

Set(-defer)