Table of Contents

Field Options

Namespace
Skyline.DataMiner.Net.Messages
Assembly
SLNetTypes.dll

Options to be passed along to the script. These options include info about which elements are linked to which dummies.

public SA Options

Returns

SA
Options to be passed along to the script. These options include info about which elements are linked to which dummies.

Remarks

  • CHECKSETS: To set the option "After executing a SET command, check if the read parameter has been set to the new value", provide an entry with the value "CHECKSETS:TRUE". Otherwise, provide an entry "CHECKSETS:FALSE".
  • "OPTIONS:int": A number of options can be set by providing an entry "OPTIONS:X, where X is a number that is a bitwise combination of the flags defined below. 
    	<table><thead><tr><th class="term">Name</th><th class="term">Value</th><th class="term">Description</th></tr></thead><tbody><tr><td class="term">None</td><td class="term">0x0</td><td class="term">None</td></tr><tr><td class="term">Lock</td><td class="term">0x1</td><td class="term">Lock elements</td></tr><tr><td class="term">Force lock</td><td class="term">0x2</td><td class="term">Force lock elements. Note: when this is set, "Lock elements" must also be set.</td></tr><tr><td class="term">NoWait</td><td class="term">0x4</td><td class="term">Disable wait when locked or busy.</td></tr><tr><td class="term">SchedulerMarkElementsInUseVisio</td><td class="term">0x8</td><td class="term">Mark dummy elements 'In Use' once task is active and scheduled (RN 5687).</td></tr><tr><td class="term">AllowUndef</td><td class="term">0x10</td><td class="term">Allows GetParameter to return NULL when parameter value is undefined.</td></tr><tr><td class="term">SkipInfoEventsSet</td><td class="term">0x20</td><td class="term">Information events should NOT be generated for SETs executed from script.</td></tr><tr><td class="term">Debug</td><td class="term">0x40</td><td class="term">Comment type statements will be logged to information messages.</td></tr></tbody></table>

	For example, to run a script with the "Disable wait when locked or busy" and "Mark dummy elements 'In Use' once task is active and scheduled", add an entry "OPTIONS:12".
	</li><li>"PROTOCOL:protid:dmaid:eid": Defines a protocol mapping. To specify a dummy, provide an entry "PROTOCOL:X:Y:Z", where X is the 1-based dummy number, Y is the Agent ID of the element and Z is the element ID of the element (e.g. "PROTOCOL:1:132:512460"). If the dummy can be empty, you can also specify "*" as values for Y and Z.</li><li>"PROTOCOLBYNAME:protName:dmaid:eid": Defines a protocol mapping by name. To specify a dummy, provide an entry "PROTOCOLBYNAME:X:Y:Z", where X is the name of the dummy, Y is the Agent ID of the element and Z is the element ID of the element (e.g. "PROTOCOLBYNAME:myDummy:132:512460"). If the dummy can be empty, you can also specify "*" as values for Y and Z.</li><li>"PARAMETER:id:value": To specify the value of a script parameter, provide an entry "PARAMETER:X:Y", where X is the 1-based parameter number and Y is the parameter value (e.g. "PARAMETER:1:MyValue").</li><li>"PARAMETERBYNAME:paramName:value": To specify the value of a script parameter by name, provide an entry "PARAMETERBYNAME:X:Y", where X is the script parameter name and Y is the parameter value (e.g. "PARAMETERBYNAME:myParam:MyValue").</li><li>"MEMORY:id:filename": To specify a memory file, provide an entry "MEMORY:X:Y", where X is the 1-based memory and Y is the memory file name (e.g. "MEMORY:1:memory 2")</li><li>"MEMORYBYNAME:id:filename": To specify a memory file by name, provide an entry "MEMORYBYNAME:X:Y", where X is the memory description and Y is the memory file name (e.g. "MEMORYBYNAME:myMemory:memory 2")</li><li>"INTERACTIVE" To allow interactive execution, provide the following entries: "INTERACTIVE". When the "INTERACTIVE" option is provided, the DEFER option should be set to TRUE.</li><li>"DEFER:bool": To activate the option "Wait for the script to finish before continuing", provide the following entry: "DEFER:FALSE".</li><li>"EXTENDED_ERROR_INFO": To return the error info and HRESULT in the response, specify "EXTENDED_ERROR_INFO".</li><li>"USER:cookie": User executing the script.</li><li>"SKIP_STARTED_INFO_EVENT:bool": Disables the 'Script started' information event generation. This is supported from DataMiner 10.3.0/10.2.8 onwards.</li></ul>
Improve this page