Device item definitions

Device item configuration is optional, but is strongly recommended.

You may want to use the Device Item Definition table to create more user friendly names by associating the OID with an alias or name similar to its definition as seen in the MIB file. Once the device items are so configured, you can browse by name or by item reference.

After you configure item names, the SNMP can perform GET and SET operations. Item names and references must follow these syntax guidelines:

• The Name is the SNMP Communication Driver property or object name, or a user-defined alias.

• The Item Reference must be the full OID, all decimals and digits.

• When using the OID as the item reference, the Item Reference must start with a decimal point, same as the OID.

• Alternatively, the Item Reference can incorporate the datatype as a prefix with the full OID.

  Use <datatype>:OID in the Item Reference in order to use device item names in reads/writes.

• Most operations with SNMP devices are read operations. The <datatype>:OID syntax is required to perform write/SET operations to an item.

  In the illustration, two item references are configured with this syntax, sysName and sysLocation. These items permit read/write access. The datatype prefix allows writes to the item name.

  For more information, see Common SNMP Item References and Data Types.

• You can specify a trap using the following syntax: <TRAP>:<TRAPTYPE>.

  The TrapType can be a type of trap like COLDSTART or an OID when it is an Enterprise type trap.

The illustration shows a device item trap named "COLDSTART" with an item reference "TRAP:COLDSTART".

In this example, you could provide an OID in place of the type of trap, such as: TRAP:.1.3.6.1.6.3.1.1.5.4.

For more information, see Use traps.

Create or add device items

1. Right-click in the Device Items box and click Add.

2. In the Name column, type a unique item name. The maximum is 32 characters. For example, "snmpInTraps.0."

3. Double-click the line in the Item Reference column and enter the correlated item reference for the name you created. For SNMP, this is the OID.

Rename device items

• Right-click the device item to be renamed and click Rename. Make the changes.

• To delete device items, right-click the device item to be deleted from the list and click Delete.

Clear all device items

• Right-click in the Device Items box and click Clear All. All the device items listed are cleared after you confirm their deletion.

NOTE: You can import a .csv file containing your item definitions to help streamline configuration. See "Export and import CSV Files" in the Communication Drivers Pack Help.