Connected: An Internet Encyclopedia
RFC 1157 - 4.1.2. The GetRequest-PDU

Top: Connected: An Internet Encyclopedia
Up: Requests For Comments
Up: RFC 1157
Up: 4. Protocol Specification
Up: 4.1. Elements of Procedure
Prev: 4.1.1. Common Constructs
Next: 4.1.3. The GetNextRequest-PDU

### 4.1.2. The GetRequest-PDU

                 The form of the GetRequest-PDU is:
                      GetRequest-PDU ::=
                          [0]
                              IMPLICIT SEQUENCE {
                                  request-id
                                      RequestID,

                                  error-status        -- always 0
                                      ErrorStatus,

                                  error-index         -- always 0
                                      ErrorIndex,

                                  variable-bindings
                                      VarBindList
                              }

The GetRequest-PDU is generated by a protocol entity only at the request of its SNMP application entity.

Upon receipt of the GetRequest-PDU, the receiving protocol entity responds according to any applicable rule in the list below:

1. If, for any object named in the variable-bindings field, the object's name does not exactly match the name of some object available for get operations in the relevant MIB view, then the receiving entity sends to the originator of the received message the GetResponse-PDU of identical form, except that the value of the error-status field is noSuchName, and the value of the error-index field is the index of said object name component in the received message.

2. If, for any object named in the variable-bindings field, the object is an aggregate type (as defined in the SMI), then the receiving entity sends to the originator of the received message the GetResponse-PDU of identical form, except that the value of the error-status field is noSuchName, and the value of the error-index field is the index of said object name component in the received message.

3. If the size of the GetResponse-PDU generated as described below would exceed a local limitation, then the receiving entity sends to the originator of the received message the GetResponse-PDU of identical form, except that the value of the error-status field is tooBig, and the value of the error-index field is zero.

4. If, for any object named in the variable-bindings field, the value of the object cannot be retrieved for reasons not covered by any of the foregoing rules, then the receiving entity sends to the originator of the received message the GetResponse-PDU of identical form, except that the value of the error-status field is genErr and the value of the error-index field is the index of said object name component in the received message.

If none of the foregoing rules apply, then the receiving protocol entity sends to the originator of the received message the GetResponse-PDU such that, for each object named in the variable- bindings field of the received message, the corresponding component of the GetResponse-PDU represents the name and value of that variable. The value of the error- status field of the GetResponse- PDU is noError and the value of the error-index field is zero. The value of the request-id field of the GetResponse-PDU is that of the received message.

Next: 4.1.3. The GetNextRequest-PDU

Connected: An Internet Encyclopedia
RFC 1157 - 4.1.2. The GetRequest-PDU