findnodebysysname.adoc

FindNodeBySysName()

FindNodeBySysName(sysname, currentNode) => Node

Look up [class-node] object by SNMP sysName.

If trusted node validation is enforced, currentNode should point to execution context object (instance of [class-netobj], $node in most cases). If trusted nodes are disabled (default server configuration), currentNode can be omitted or set to null.

Table 1. Parameters

sysname	String	SNMP sysName.
currentNode	[class-netobj]	Lookup context or null if trusted nodes validation is disabled. Optional parameter.

Return

Instance of [class-node] object or null if not found or not accessible.

Example

node = FindNodeBySysName("switch-main");
if (node != NULL) println(node.name); // Prints node name if node with given sysName is found