PySNMP: Protocol: API: Alpha: Get/GetNext/Set/InformRequest/Report PDU API methods

### Alpha API to Get/GetNext/Set/InformRequest and Report PDU objects

Alpha API implements the following API methods to the Get/GetNext/SetRequest and GetBulk/InformRequest and Report PDU objects.

apiAlphaGetRequestId()

  Returns a reference to RequestId object.

apiAlphaSetRequestId(value)

  Stores value as Request ID at PDU where value is either a RequestId object or a value suitable for RequestId object initialization.

apiAlphaGetVarBindList()

  Returns a reference to VarBindList object at PDU.

apiAlphaSetVarBindList(*varBinds)

  Stores varBinds arguments at the VarBindList PDU object, where each argument must be either a VarBind object or a tuple of (name, value) conforming to apiAlphaSetOidVal arguments.

apiAlphaReply([rspPdu])

  Returns new or initializes rspPdu instance of rfc1157.GetResponsePdu/ rfc1905.ResponsePdu object with the same RequestId value.

apiAlphaMatch(rspPdu)

  Returns true if RequestId at rspPdu (which must be a rfc1157.GetResponsePdu or rfc1905.ResponsePdu instance) is equal to request ID of this request PDU.

apiAlphaGetTableIndices(rspPdu, *headerOids)

  Returns two-dimentional array of integer indices of VarBind's at VarBindList (as returned by apiAlphaGetVarBindList()) representing SNMP table as held at rspPdu PDU. The headerOids arguments (indicate table header row) must be ObjectIdentifier objects. For example:

      >>> varBindList = rspPdu.apiAlphaGetVarBindList()
      >>> varBindList
      VarBindList(VarBind(name=ObjectName('.1.3.6.1.2.1.2.2.1.6.19'), \
      value=ObjectSyntax(simple=SimpleSyntax(string=OctetString('')))), \
      VarBind(name=ObjectName('.1.3.6.1.2.1.2.2.1.7.19'), \
      value=ObjectSyntax(simple=SimpleSyntax(number=Integer(1)))))
      >>> tableRows = reqPdu.apiAlphaGetTableIndices(rspPdu, \
                                ObjectIdentifier('.1.3.6.1.2.1.2.2.1.6'),
                                ObjectIdentifier('.1.3.6.1.2.1.2.2.1.7'))
      >> tableRows
      [[0, 1]]
      >>> tableCol = tableRows[0]
      >>> varBindList[tableCol[0]]
      VarBind(ObjectName('.1.3.6.1.2.1.2.2.1.6.19'), OctetString(''))

  Index value of -1 indicates a End-Of-Mib condition for headerOids variables at corresponding columns.