This page creates a map entry that reads data from a remote SNMP agent for processing here.

Rule number simply tells you where you're at on the list of OID maps. Click "next" and "prev" to scroll through the list. To advance directly to a specific map, enter the desired number in the "Map #" box, then click Update.

For each remote OID to be read, enter the full OID and location (device). The names in the device list are defined in the Devices page.

Data hint helps the data parser figure out what the varible is. If ASN encoding is recognized as other than an octet string, the hint will be disregarded. If an octet string is found, then the parser needs to know if it should be treated as RFC 6340 floating point. If no hint is given (standard ASN), then the octet string will be treated as an ASCII character string, in which case ASCII to numeric conversion will be attempted automatically if the result object is numeric. Note that standard, well-known ASN types are recognized as well as the NetSnmp ASN type for opaque float.

When the remote OID is read, data may be manipulated before being written to the local object. The result will be multiplied by the scale factor if any non-zero scale factor is given. The offset is then added and this final result is written to the local object number given. The name is optional and used only for display purposes.

The periodic poll time determines how often the remote OID will be read. This number, if nonzero, will override the default poll time given in the Devices page for the remote device being read.

The default value will be stored into the local object after the given number of read failures if the fail count is non-zero. Setting the count to zero will disable the default, and the object will retain the most recent value obtained.

You have the option of enabling this rule only when a selected object contains a given value. Any local object may be used as the index object. As the name implies, you could have the same local object contain different values based on different rules as indexed by the index object.

Delete will remove the rule number shown in the "Map #" box. Insert will insert a new rule before the rule number shown, and is used for placing rules between existing rules. It is not necessary to use Insert to add rules to the bottom of the list or to define any rule presently having zero for a source object or "none" for remote type.

Entering zero (for none) for local object effectively deletes the rule even though it will still appear in the list until deleted. Unused rules at the end of the list will always show none as the type. If you wish to prevent these from being displayed, reduce the number of rules enabled.

The number of rules enabled simply limits the scope of rule review so that you do not have to review a lot of unused rules. If the displayed rules are used up and you need more, increase the enabled number.