1 Messages and Path Names

1.1 Add message with allow partial false, single object, required parameters succeed

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, and all required parameters to be set upon Object Creation succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add1'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
       }
     }
   }
 }

Allow the EUT to send an AddResp.
Record the instance identifier of the created object as reported by the EUT.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a GetResp.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT sends an AddResp.
The AddResp contains a single CreatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains no parameter errors and 3 elements in the unique key map: Alias, Recipient, and ID. Alternatively, the OperationSuccess contains 2 elements in the unique key map if the Alias parameter is not supported: Recipient, and ID.
The EUT creates the Subscription object.
The Subscription object's values match the values set in the param_settings element.

1.2 Add message with allow partial true, single object, required parameters succeed

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to true, and all required parameters to be set upon Object Creation succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: true
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add2'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
        }
      }
    }
  }

Allow the EUT to send an AddResp.
Record the instance identifier of the created object as reported by the EUT.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a GetResp.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT AddResp is valid.
The AddResp contains a single CreatedObjectResult that has an OperationStatus of OperationSuccess. The OperationSuccess contains no parameter errors and 3 elements in the unique key map: Alias, Recipient, and ID. Alternatively, the OperationSuccess contains 2 elements in the unique key map if the Alias parameter is not supported: Recipient, and ID.
The EUT creates the Subscription object.
The Subscription object's values match the values set in the param_settings element.

1.3 Add message with allow partial false, single object, required parameters fail

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, and at least one required parameter fails, and only a single object is set.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'InvalidValue'
           required: true
         }
        param_settings {
           param: 'ID'
           value: 'add3'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
         }
        }
      }
    }
  }

Allow the EUT to send an Error message.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends an Error message.
The Error message contains an appropriate error code with the param_errs element containing a single error with a param_path that indicates the Enable parameter, and an appropriate error code.
The EUT did not create a new Subscription object.

1.4 Add message with allow partial false, single invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, and a single invalid object is set.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.InvalidObject.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add4'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
         }
        }
      }
    }
  }

Allow the EUT to send an Error message.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends an Error message.
The Error message contains an appropriate error code with the param_errs element containing a single error with a param_path of 'Device.LocalAgent.InvalidObject.', and an appropriate error code.
The EUT did not create a new Subscription object.

1.5 Add message with allow partial false, multiple objects

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, multiple objects are attempted, and all required parameters to be set upon Object Creation succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add51'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
        }
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add52'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.EndpointID'
           required: true
         }
        }
      }
    }
  }

Allow the EUT to send an AddResp.
Record the instance identifiers of the created objects as reported by the EUT.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier 1>.'
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier 2>.'
    }
  }
}

Allow the EUT to send a GetResp.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
msg_id: '<msg_id>'
msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier 1>.'
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier 2>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT AddResp is valid.
The AddResp contains two CreatedObjectResults that each have an OperationStatus of OperationSuccess. The OperationSuccess elements contains no parameter errors and 3 elements in the unique key map: Alias, Recipient, and ID. Alternatively, the OperationSuccess contains 2 elements in the unique key map if the Alias parameter is not supported: Recipient, and ID.
The EUT creates the Subscription objects.
The first Subscription object's values match the values set in the param_settings element.
The second Subscription object's values match the values set in the param_settings element.

1.6 Add message with allow partial false, multiple objects with an invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, multiple objects are attempted, and one of the objects is invalid.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add61'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
        }
      create_objs {
        obj_path: 'Device.LocalAgent.InvalidObject.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add62'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.EndpointID'
           required: true
         }
        }
      }
    }
  }

Allow the EUT to send an Error.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends an Error message.
The Error message contains an appropriate error code with the param_errs element containing a single error with a param_path of 'Device.LocalAgent.InvalidObject.', and an appropriate error code.
The EUT did not create a new Subscription object.

1.7 Add message with allow partial false, multiple objects, required parameters fail in single object

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to false, and at least one required parameter fails in one of multiple objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'InvalidValue'
           required: true
         }
        param_settings {
           param: 'ID'
           value: 'add71'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
        }
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'true'
         }
        param_settings {
           param: 'ID'
           value: 'add72'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        }
      }
    }
  }

Allow the EUT to send an Error.
Send a Get message to the EUT with the request path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends an Error message.
The Error message contains an appropriate error code with the param_errs element containing a single error with a param_path that indicates the Enable parameter, and an appropriate error code.
The GetResp from the EUT does not contain a Subscription instance with ID 'add71' or 'add72'.

1.8 Add message with allow partial true, required parameters fail, invalid type, single object

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to true, and at least one required parameter fails (with an invalid value) in a single object.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: true
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'InvalidValue'
           required: true
         }
        param_settings {
           param: 'ID'
           value: 'add8'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
           required: true
         }
        }
      }
    }
  }

Allow the EUT to send an AddResp.
Send a Get message to the EUT with the request path of 'Device.LocalAgent.Subscription.'.

Test Metrics

The EUT sends an AddResp message.
The AddResp contains a single CreatedObjectResult that has an OperationStatus that is an element of type OperationFailure. The OperationFailure element contains an appropriate error code.
The GetResp from the EUT does not contain a Subscription instance with ID 'add8'.

1.9 Add message with allow partial true, required parameters fail, multiple objects

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the allow_partial element is set to true, and at least one required parameter fails in one of multiple objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: true
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'add91'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.SoftwareVersion'
          }
        }
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'add91'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.SoftwareVersion'
          }
        param_settings {
            param: 'InvalidParameter'
            value: 'IrrelevantValue'
            required: true
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp.
Record the instance identifier of the created object as reported by the EUT.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT sends an AddResp message.
The AddResp contains two CreatedObjectResults.

a. One CreateObjectResult is an element of type OperationSuccess. The OperationSuccess element contains no parameter errors and 3 elements in the unique key map: Alias, Recipient, and ID. Alternatively, the OperationSuccess contains 2 elements in the unique key map if the Alias parameter is not supported: Recipient, and ID.

b. The other CreateObjectResult is an element of type OperationFailure. The OperationFailure element contains an appropriate error code.
The EUT creates the first Subscription object, and does not create the second Subscription object.
The Subscription object's values match the values set in the param_settings element.

1.10 Add message with unique key addressing in path

Purpose

The purpose of this test is to validate that the EUT properly handles an Add message when the Controller uses unique key addressing.

Functionality Tag

Conditional Mandatory (Product supports at least one nested multi-instance object)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Controller.[EndpointID=="< EndpointID>"&&Alias=="<Alias if supported>"].BootParameter.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ParameterName'
            value: 'Device.LocalAgent.SoftwareVersion'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp.
Record the instance identifier of the created object as reported by the EUT.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Controller.<instance identifier of Controller>.BootParameter.<instance identifier>.'
    }
  }
}

Allow the EUT to send a GetResp.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Controller.<instance identifier of Controller>.BootParameter.<instance identifier>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT sends an AddResp.
The AddResp contains a single CreatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains no parameter errors and 2 elements in the unique key map: Alias and ParameterName. Alternatively, the OperationSuccess contains one element in the unique key map if the Alias parameter is not supported: ParameterName.
The EUT creates the BootParameter object.
The BootParameter object's values match the values set in the param_settings element.

1.11 Set message with allow partial false, required parameters pass

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to false, and all required parameters to be updated succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains a single UpdatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdateInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element.

1.12 Set message with allow partial true, required parameters pass

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to true, and all required parameters to be updated succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: true
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
  body {
    request {
      get {
        param_paths: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.NotifRetry'
      }
    }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains a single UpdatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdateInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element.

1.13 Set message with allow partial false, multiple objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to false, and all required parameters to be updated succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT, and the instance identifiers are known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<second instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
         }
        }
      }
    }
  }

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.NotifRetry'
      param_paths: 'Device.LocalAgent.Subscription.<second instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains two UpdatedObjectResults that each have an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdateInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element for each object.

1.14 Set message with allow partial false, required parameters fail

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to false, and a required parameter fails.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.'
        param_settings {
         param: 'InvalidParameter'
         value: 'IrrelevantValue'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send an Error.
Send a Get message to the EUT with a request path of 'Device.LocalAgent.Subscription..'.

Test Metrics

The EUT sends an Error.
The Error contains an appropriate error code and a single ParamError element. The ParamError element contains a param_path of 'Device.LocalAgent.Subscription..InvalidParameter' and an appropriate error code.
The GetResp contains a single Subscription instance that does not include a 'InvalidParameter' parameter.

1.15 Set message with allow partial false, multiple objects, required parameters fail in single object

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to false, and required parameters in one of multiple objects fail.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT, and the instance identifiers are known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
         }
      }
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<second instance identifier from test setup>.'
        param_settings {
         param: 'InvalidParameter'
         value: 'IrrelevantValue'
         required: true
         }
        }
      }
    }
  }

Allow the EUT to send an Error.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends an Error.
The Error contains an appropriate error code and a single ParamError element. The ParamError element contains a param_path of 'Device.LocalAgent.Subscription..InvalidParameter' and an appropriate error code.
The GetResp contains at least two Subscription instances, neither of which contain a InvalidParameter parameter and the first instance from the test setup does not have an updated NotifRetry value.

1.16 Set message with allow partial true, required parameter fails, multiple objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to true, and a required parameter on one of multiple objects fails.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT, and the instance identifiers are known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: true
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<second instance identifier from test setup>.'
        param_settings {
         param: 'InvalidParameter'
         value: 'IrrelevantValue'
         required: true
         }
        }
      }
    }
  }

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains two UpdatedObjectResults.

a. The first UpdatedObjectResult has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdatedInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.

b. The second UpdatedObjectResult has an OperationStatus that is an element of type OperationFailure. The OperationFailure contains an appropriate error code and a single UpdatedInstanceFailure element. The UpdatedInstanceFailure has an affected_path with a value of 'Device.LocalAgent.Subscription..', and a single ParameterError element.

c. The ParameterError has a param element with a value of 'InvalidParameter' and an appropriate error code.
The retrieved value matches the value set in the param_settings element for the first object.

1.17 Set message with allow partial true, non-required parameter fails, multiple parameters

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the allow_partial element is set to true, and one of multiple non-required parameters fail.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: true
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
       }
        param_settings {
         param: 'InvalidParameter'
         value: 'IrrelevantValue'
       }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains a single UpdatedObjectResult with an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdatedInstanceResult element.

a. The UpdatedInstanceResult affected_path is equal to 'Device.LocalAgent.Subscription..'.

b. The UpdatedInstanceResult has a single entry in the updated_params map containing 'NotifRetry' as the key.

c. The UpdatedInstanceResult has a single ParameterError element, with the 'param' field set to 'InvalidParameter', and an appropriate error code.
The retrieved value of NotifRetry matches the value set in the param_settings element.

1.18 Set message with unique key addressing in path

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the Controller uses unique key addressing.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the unique keys and their values are known by the traffic generator.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {

    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<unique key instance identifier from test setup>.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains a single UpdatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdateInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element.

1.19 Set message with wildcard search path, allow partial false, required parameters pass

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the Controller uses a wildcard search path and the requested updates succeed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.*.'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<first instance identifier from test setup>.NotifRetry'
      param_paths: 'Device.LocalAgent.Subscription.<second instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains an UpdatedObjectResults element that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains at least two UpdateInstanceResults, each with the affected_path equal to 'Device.LocalAgent.Subscription..' of the respective instance, and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element for each object.

1.20 Set message with wildcard search path, allow partial false, required parameters fail

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the Controller uses a wildcard search path, allow_partial element is set to false, and required parameters in multiple objects fail.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {

    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.*.'
        param_settings {
         param: 'InvalidParameter'
         value: 'IrrelevantValue'
         required: true
          }
        }
      }
    }
  }

Allow the EUT to send a SetResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends a SetResp.
The SetResp contains an UpdatedObjectResults element.
The UpdatedObjectResults has an OperationStatus that is an element of type OperationFailure. The OperationFailure contains an appropriate error code and at least one UpdatedInstanceFailure element. The UpdatedInstanceFailure has an affected_path with a value of ‘Device.LocalAgent.Subscription..’ for the respective failed instance, and a single ParameterError element. The ParameterError has a param element that indicates the InvalidParameter parameter, and an appropriate error code.
In the GetResp there are no Subscription instances with an 'InvalidParameter' parameter.

1.21 Set message with wildcard search path, allow partial true, required parameters fail

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the Controller uses a wildcard search path, the allow_partial element is set to true, and a required parameter on multiple objects fails.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: true
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.*.'
        param_settings {
         param: 'Enable'
         value: 'InvalidValue'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains an UpdatedObjectResults element.
The UpdatedObjectResults has an OperationStatus that is an element of type OperationFailure. The OperationFailure contains an appropriate error code and at least one UpdatedInstanceFailure elements. The UpdatedInstanceFailure has an affected_path with a value of 'Device.LocalAgent.Subscription..' for the respective failed instance, and a single ParameterError element. The ParameterError has a param element that indicates the Enable parameter, and an appropriate error code.
The EUT has no Subscription objects that have an Enable parameter set to 'InvalidValue'.

1.22 Set message with search expression search path

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the Controller uses a search path.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT with a value for the NotifExpiration that is greater than 0.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.[NotifExpiration>0].'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier from test setup>.NotifRetry'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains at least one UpdatedObjectResult that has an OperationStatus that is an element of type OperationSuccess. The OperationSuccess contains a single UpdateInstanceResult, with the affected_path equal to 'Device.LocalAgent.Subscription..', and a single entry in the updated_params map containing 'NotifRetry' as the key.
The retrieved value matches the value set in the param_settings element.

1.23 Set message with path that matches no objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Set message when the requested path is a search path that does not match any objects, returning an empty oper_success element.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: true
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.[Recipient=="InvalidValue"].'
        param_settings {
         param: 'NotifRetry'
         value: '<Valid Value>'
         required: true
        }
      }
    }
  }
}

Allow the EUT to send a SetResp.

Test Metrics

The EUT sends a SetResp.
The SetResp contains one UpdatedObjectResult with an empty oper_success element (i.e. oper_success {}).

1.24 Delete message with allow partial false, valid object instance

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to false, and the object to be deleted is valid.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that a Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains a single deleted_obj_response with a requested_path equal to 'Device.LocalAgent.Subscription..' and an oper_success element, with one affected_path element equal to the path name of the Deleted object.
The GetResp does not contain the Subscription instance that was deleted.

1.25 Delete message with allow partial false, object instance doesn't exist

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to false, and the object instance to be deleted does not exist.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned any existing Subscription objects and their instance identifiers.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: false
       obj_paths: 'Device.LocalAgent.Subscription.<non-existent instance identifier>.'
     }
   }
 }

Allow the EUT to send an DeleteResp.

Test Metrics

The EUT sends a DeleteResp containing an empty oper_success element.

1.26 Delete message with allow partial false, invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to false, and the object to be deleted is invalid.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
 }
 body {
   request {
     delete {
       allow_partial: false
       obj_paths: 'Device.LocalAgent.InvalidObject.'
     }
   }
 }

Allow the EUT to send an Error message.

Test Metrics

The EUT sends an Error message.
The Error contains an appropriate error code with the param_errs element containing a single error with a param_path of 'Device.LocalAgent.InvalidObject.', and an appropriate error code.

1.27 Delete message with allow partial false, multiple objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to false, with multiple valid objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT, and the instance identifiers are known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: false
       obj_paths: 'Device.LocalAgent.Subscription.<first instance identifier>.'
       obj_paths: 'Device.LocalAgent.Subscription.<second instance identifier>.'
     }
   }
  }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains two deleted_obj_results, each with a requested_path equal to the obj_paths of the Delete message, and an oper_success element containing an affected_path element equal to the path name of the deleted object.
The GetResp does not contain the deleted Subscription objects.

1.28 Delete message with allow partial false, multiple objects, invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to false, and one of the objects to be deleted is invalid.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: false
       obj_paths: 'Device.LocalAgent.Subscription.<instance identifier.>'
       obj_paths: 'Device.LocalAgent.InvalidObject.'
     }
   }
 }

Allow the EUT to send an Error message.
Send a Get message to the EUT with a request path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends an Error message.
The Error contains an appropriate error code with the param_errs element containing a single error with a param_path of 'Device.LocalAgent.InvalidObject.', and an appropriate error code.
The GetResp contains the Subscription that was not deleted by step 1.

1.29 Delete message with allow partial true, object instance doesn't exist

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to true, and the object instance to be deleted does not exist.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: true
       obj_paths: 'Device.LocalAgent.Subscription.<invalid instance identifier>.'
     }
   }
 }

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT sends a DeleteResp containing an empty oper_success element (i.e., oper_success{}).

1.30 Delete message with allow partial true, invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to true, and the object is not valid in the Agent's supported data model.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
 }
 body {
   request {
     delete {
       allow_partial: true
       obj_paths: 'Device.LocalAgent.InvalidObject.'
     }
   }
 }

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains a single deleted_obj_result message with a requested_path of 'Device.LocalAgent.InvalidObject.' and an oper_failure element, with an appropriate error code.

1.31 Delete message with allow partial true, multiple objects, invalid object

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to true, and one of multiple objects is invalid.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: true
       obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
       obj_paths: 'Device.LocalAgent.InvalidObject.'
     }
   }
 }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains two deleted_obj_results elements, one with an oper_success element, containing an affected_path element with the value 'Device.LocalAgent.Subscription..', and the other with an oper_failure element containing an appropriate error code.
The GetResp does not contain the Subscription instance deleted in step 1.

1.32 Delete message with allow partial true, multiple objects, object doesn't exist

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the allow_partial element is set to true, and one of multiple objects does not exist in the Agent's instantiated data model.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the instance identifier is known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
body {
  request {
    delete {
      allow_partial: true
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
      obj_paths: 'Device.LocalAgent.Subscription.<invalid instance identifier>.'
      }
     }
    }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription..

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains two deleted_obj_results elements. One contains an oper_success element with an affected_path element listing 'Device.LocalAgent.Subscription..'. The second contains an empty oper_success element (i.e., oper_success{}).
The GetResp does not contain the Subscription instance deleted in step 1.

1.33 Delete message with unique key addressing

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the Controller uses unique key addressing.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Obtain the unique key values of the Device.LocalAgent. object that correlates with the source of the test USP messages.
Ensure that at least one Device.LocalAgent.Controller.{i}.BootParameter. object exists on the EUT, and the instance identifier of the object is known by the traffic generator.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Controller.[EndpointID=="< EndpointID>"&&Alias=="<Alias if supported>"].BootParameter.<instance identifier>.'
      }
    }
  }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Controller.<instance ID>.BootParameter.

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains a single deleted_obj_result with a requested path equal to the path specified in the obj_path of the Delete message, containing an oper_success element, with one affected_path element equal to the path name of the Deleted object.
The affected_path element uses instance number addressing.
The GetResp does not contain the BootParameter deleted in step 1.

1.34 Delete message with wildcard search path, valid objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the Controller uses a wildcard search to delete multiple valid objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.*.'
      }
    }
  }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Subscription.

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains a single deleted_obj_result with a requested path equal to 'Device.LocalAgent.Subscription.*.' and an oper_success element with one or more affected_path elements equal to the path names of the Deleted objects.
The GetResp does not contain any of the Subscription instances deleted in step 1.

1.35 Delete message with search expression search path

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message when the Controller uses a search expression to delete one or more valid objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the instance identifier of the Controller object that represents the traffic generator is known by the traffic generator.
Ensure that at least two Device.LocalAgent.Controller..BootParameter. objects exist on the EUT. At least one of these BootParameter objects has a value of 'false' for its 'Enable' parameter, and at least one of these BootParameter objects has a value of 'true' for its 'Enable' parameter.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Controller.<instance identifier>.BootParameter.[Enable==true].'
      }
    }
  }

Allow the EUT to send a DeleteResp.
Send a Get message to the EUT with a requested path of Device.LocalAgent.Controller.<instance ID>.BootParameter..

Test Metrics

The EUT sends a DeleteResp.
The DeleteResp contains a single deleted_obj_results element, with a requested_path equal to 'Device.LocalAgent.Controller..BootParameter.[Enable==true]' and an oper_success element with the affected_path elements equal to the path names of the successfully Deleted objects.
The BootParameter whose Enable parameter was equal to 'false' was not deleted.
The GetResp does not contain any BootParameter instances where Enable==true.

1.36 Get message with full parameter path

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when a single full parameter path is specified.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.EndpointID'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The req_path_results has no errors, a requested_path equal to 'Device.LocalAgent.EndpointID', and contains a single resolved_path_results element. The resolved_path_results element contains a resolved_path equal to 'Device.LocalAgent.' and a single result_params element with a key of 'EndpointID' and a value equal to the EUT's EndpointID.

1.37 Get message with multiple full parameter paths, same object

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when multiple full parameter paths are specified within the same object.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.EndpointID'
      param_paths: 'Device.LocalAgent.SoftwareVersion'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains two req_path_results elements. The requested_path_results have no errors. Each contains a single resolved_path_results element. One resolved_path_result element contains a requested_path equal to 'Device.LocalAgent.EndpointID', a single resolved_path equal to 'Device.LocalAgent.', and a single result_params element with a key of 'EndpointID' and a value equal to the EUT EndpointID. The other resolved_path_result element contains a requested_path equal to 'Device.LocalAgent.SoftwareVersion', a single resolved_path equal to 'Device.LocalAgent.', and a single result_params element with a key of 'SoftwareVersion' with a valid value.

1.38 Get message with multiple full parameter paths, different objects

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when multiple full parameter paths are specified within multiple objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and its instance identifier is known by the traffic generator.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.EndpointID'
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier>.Enable'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains two req_path_results elements. The requested_path_results have no errors. Each contains a single resolved_path_results element. One resolved_path_result element contains a requested_path equal to 'Device.LocalAgent.EndpointID', a single resolved_path equal to 'Device.LocalAgent.', and a single result_params element with a key of 'EndpointID' and a value equal to the EUT EndpointID. The other resolved_path_result element contains a requested_path equal to 'Device.LocalAgent.Subscription..Enable', a single resolved_path equal to 'Device.LocalAgent.Subscription..', and a single result_params element with a key of 'Enable' with a valid value.

1.39 Get message with object path

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when an object path is specified.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.', and a set of resolved_path_results elements. One contains a resolved_path of 'Device.LocalAgent.', and a number of result_params elements contain keys and values of the parameters of 'Device.LocalAgent.'. Additional resolved_path_results exist for each of the sub-objects of Device.LocalAgent., with result_params containing the keys and values of each sub-object's parameters.
The keys of all result_params elements are relative paths.

1.40 Get message with object instance path

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when a path to an object instance is specified.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and its instance identifier is known by the traffic generator.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription..', and a single resolved_path_results element, with a resolved_path of 'Device.LocalAgent.Subscription..', and a series of result_params elements containing the keys and values of the parameters of the instance.
The keys of all result_params elements are relative paths.

1.41 Get message with invalid parameter

Purpose

The purpose of this test is to ensure the Agent can properly handle a Get message when a single invalid parameter is requested.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.InvalidParameter'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has a requested_path equal to 'Device.LocalAgent.InvalidParameter', and an appropriate error code.

1.42 Get message with invalid parameter and valid parameter

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when both a valid and invalid parameter are requested.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
       param_paths: 'Device.LocalAgent.EndpointID'
       param_paths: 'Device.LocalAgent.InvalidParameter'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains two req_path_results elements. One requested_path_results has no errors, and contains a single resolved_path_results element. The resolved_path_results element contains a requested_path equal to 'Device.LocalAgent.EndpointID', a single resolved_pathequal to 'Device.LocalAgent.', and a single result_params element with a key of 'EndpointID' and a value equal to the EUT EndpointID. The other requested_path_results has a requested_path equal to 'Device.LocalAgent.InvalidParameter', and an appropriate error code.

1.43 Get message using unique key addressing

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses unique key addressing.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the unique keys and their values are known by the traffic generator.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<unique key identifier>.Enable'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription..Enable', and a single resolved_path_results element, with a resolved_path of 'Device.LocalAgent.Subscription..', and a result_params element containing a key of 'Enable' and a valid value.

1.44 Get message using wildcard search path on full parameter

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a wildcard to retrieve a single parameter from multiple objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.*.Enable'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.*.Enable', and at least two resolved_path_results elements, each with a resolved_path of 'Device.LocalAgent.Subscription..', and a result_params element containing a key of 'Enable' and a valid value.

1.45 Get message using wildcard search path on object path

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a wildcard to retrieve all parameters from multiple object instances.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.*.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.*.', and a set of resolved_path_results elements. Each contains a resolved_path of 'Device.LocalAgent.Subscription..', and a number of result_params elements containing keys and values of the parameters of each Subscription object.
The keys of all result_params elements are relative paths.

1.46 Get message using search expression search path (equivalence)

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a search path to retrieve objects that that parameters that match a particular value.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT. At least one of these Subscription objects should have a value of 'true' for its Enable parameter, and at least one should have a value of 'false' for its Enable parameter.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[Enable==true].'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.[Enable==true].', and a set of resolved_path_results elements. Each contains a resolved_path of 'Device.LocalAgent.Subscription..', and a number of result_params elements containing keys and values of the parameters of each Subscription object where the Enable parameter is 'true'.
The keys of all result_params elements are relative paths.
The EUT does not return any parameters from Subscription objects whose Enable parameter is 'false'.

1.47 Get message using search expression search path (non-equivalence)

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a search path that does not match a particular value.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT. At least one of these Subscription objects should have a value of 'true' for its Enable parameter, and at least one should have a value of 'false' for its Enable parameter.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[Enable!=true].'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.[Enable!=true].', and a set of resolved_path_results elements. Each contains a resolved_path of 'Device.LocalAgent.Subscription..', and a number of result_params elements containing keys and values of the parameters of each subscription object where the Enable parameter is 'false'.
The keys of all result_params elements are relative paths.
The EUT does not return any parameters from Subscription objects whose Enable parameter is 'true'.

1.48 Get message using search expression search path (exclusive greater comparison)

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a search path to retrieve objects that that parameters that are greater than a particular value.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT. At least one of these Subscription objects should have a value of '10' for its NotifExpiration parameter, and at least one with a value of '20' for its NotifExpiration parameter.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[NotifExpiration>10].'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.[NotifExpiration>10].', and a set of resolved_path_results elements. Each contains a resolved_path of 'Device.LocalAgent.Subscription..', and a number of result_params elements containing keys and values of the parameters of each Subscription object where the NotifExpiration parameter is greater than 10.
The keys of all result_params elements are relative paths.
The EUT does not return any parameters from Subscription objects whose NotifExpiration parameter is equal to or less than 10.

1.49 Get message using search expression search path (exclusive lesser comparison)

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model when the requested path uses a search path to retrieve objects that that parameters that are less than a particular value.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least two Subscription objects exist on the EUT. At least one of these Subscription objects should have a value of '10' for its NotifExpiration parameter, and at least one with a value of '5' for its NotifExpiration parameter.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[NotifExpiration<10].'
    }
  }
}


2. Allow the EUT to send a GetResp.

### Test Metrics

1. The EUT sends a GetResp.

2. The GetResp contains a single `req_path_results` element. The `requested_path_results` has no errors, has a `requested_path` equal to 'Device.LocalAgent.Subscription.[NotifExpiration<10].', and a set of `resolved_path_results` elements. Each contains a `resolved_path` of 'Device.LocalAgent.Subscription.<instance identifier>.', and a number of `result_params` elements contain keys and values of the parameters of each Subscription object where the NotifExpiration parameter is less than 10.

3. The keys of all `result_params` elements are relative paths.

4. The EUT does not return any parameters from Subscription
objects whose NotifExpiration parameter is equal to or greater than 10.

## 1.50 Get message using search expression search path (inclusive greater comparison)

### Purpose

The purpose of this test is to ensure the Controller can retrieve the
values of parameters in the Agent's Instantiated Data Model when the
requested path uses a search path to retrieve objects that that
parameters that are greater than or equal to a particular value.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary
information to send and receive USP Records to each other.

2. Ensure that at least three Subscription objects exist on the
EUT. At least one of these Subscription objects should have a value of
'10' for its NotifExpiration parameter, at least one with a value of
'20' for its NotifExpiration parameter, and at least one with a value of '5'
for its NotifExpiration parameter.

### Test Procedure

1. Send a Get message to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
      msg_id: '<msg_id>'
      msg_type: GET
    }
    body {
      request {
        get {
          param_paths: 'Device.LocalAgent.Subscription.[NotifExpiration>=10].'
        }
      }
    }
    ```

2. Allow the EUT to send a GetResp.

### Test Metrics

1. The EUT sends a GetResp.

2. The GetResp contains a single `req_path_results` element.
The `requested_path_results` has no errors, has a `requested_path` equal
to 'Device.LocalAgent.Subscription.[NotifExpiration>=10].', and a
set of `resolved_path_results` elements. Each contains a
`resolved_path` of 'Device.LocalAgent.Subscription.<instance identifier>.',
and a number of `result_params` elements containing keys and values of the
parameters of each Subscription object where the NotifExpiration parameter is
greater than or equal to 10.

3. The keys of all `result_params` elements are relative paths.

4. The EUT does not return any parameters from Subscription
objects whose NotifExpiration parameter is less than 10.

## 1.51 Get message using search expression search path (inclusive lesser comparison)

### Purpose

The purpose of this test is to ensure the Controller can retrieve the
values of parameters in the Agent's Instantiated Data Model when the
requested path uses a search path to retrieve objects that that
parameters that are less than or equal to a particular value.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary
information to send and receive USP Records to each other.

2. Ensure that at least three Subscription objects exist on the
EUT. At least one of these Subscription objects should have a value of
'10' for its NotifExpiration parameter, at least one with a value of
'20' for its NotifExpiration parameter, and at least one with a value of '5'
for its NotifExpiration parameter.

### Test Procedure

1. Send a Get message to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
      msg_id: '<msg_id>'
      msg_type: GET
    }
    body {
      request {
        get {
          param_paths: 'Device.LocalAgent.Subscription.[NotifExpiration<=10].'
        }
      }
    }

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.[NotifExpiration<=10].', and a set of resolved_path_results elements. Each contains a resolved_path of 'Device.LocalAgent.Subscription..', and a number of result_params elements containing keys and values of the parameters of each Subscription object where the NotifExpiration parameter is less than or equal to 10.
The keys of all result_params elements are relative paths.
The EUT does not return any parameters from Subscription objects whose NotifExpiration parameter is greater than 10.

1.52 Notify - Subscription creation using Value Change

Purpose

The purpose of this test is to ensure that the Agent will create Subscriptions requested by the Controller, and notifies the Controller when the conditions of the subscription are triggered. This test uses the ValueChange event to exercise these functions, validating the behavior of ValueChange in the process.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not 'TestValue52'.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify52'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue52'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Test Metrics

The EUT sends a successful AddResp.
The EUT sends a Notify message with a subscription_id field equal to 'Notify52', and an event element of value_change with a param_path of 'Device.LocalAgent.Controller..ProvisioningCode' and a param_value of 'TestValue52'.

1.53 Notify - Subscription Deletion Using Value Change

Purpose

The purpose of this test is to ensure that the Agent will remove and terminate a Subscription when the Controller uses the Delete message.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not 'TestValue53'.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify53'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp, and store the instance identifier of the Subscription object.

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue53'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Send a Delete message with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
      }
    }
  }

Allow the EUT to send a DeleteResp.
Repeat step 3, changing the value of ProvisioningCode to 'notify53-2'.
Wait 20 seconds.

Test Metrics

The EUT sends a successful DeleteResp.
The EUT does not send a Notify message based on the activity in the ProvisioningCode parameter.

1.54 Notification Retry using Value Change

Purpose

The purpose of this test is to ensure that the Agent will attempt to resend Notify messages when the NotifRetry parameter in a Subscription object is set to true and the Controller does not send a NotifyResp.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not 'TestValue54'.
Ensure that the Device.LocalAgent.Controller..USPNotifRetryMinimumWaitInterval is set to its default value (5).

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify54'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue54'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Do not send a NotifyResp to the EUT.
Wait 10 seconds to allow the EUT to send a Notify message.
Do not send a NotifyResp to the EUT.
Wait 20 seconds to allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Test Metrics

The EUT retries the Notify message.
The first retry occurs within 5-10 seconds. The second retry occurs within 10-20 seconds.

1.55 Subscription Expiration using Value Change

Purpose

The purpose of this test is to ensure that the Agent removes a Subscription from the Subscription table after its TimeToLive has expired.

Functionality Tag

Conditionally Mandatory (Supports TimeToLive in Device.LocalAgent.Subscription.)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not 'TestValue55'.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify55'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        param_settings {
            param: 'TimeToLive'
            value: '20'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue55'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.
Wait 20 seconds.

Send a GetInstances message to the EUT with the following structure:

header {
      msg_id: '<msg_id>'
      msg_type: GET_INSTANCES
    }
body {
      request {
        get_instances {
          obj_paths: 'Device.LocalAgent.Subscription.'
        }
      }
    }

Allow the EUT to send a GetInstancesResponse.
Repeat step 3 with a value of 'TestValue55-2'.
Wait 10 seconds.

Test Metrics

The EUT sends a Notify message after step 3.
The GetInstancesResponse does not list the instance of the Subscription object created in step 1.
The EUT does not send a Notify message after step 9.

1.56 Notification Retry Expiration using Value Change

Purpose

The purpose of this test is to ensure that the Agent will cease attempts to retry Notify messages after an amount of time specified in value of the NotifExpiration parameter in the Subscription object has passed.

Functionality Tag

Conditional Mandatory (supports Subscription.{i}.NotifExpiration parameter).

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not 'TestValue56'.
Ensure that the Device.LocalAgent.Controller..USPNotifRetryMinimumWaitInterval is set to its default value (5).

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify56'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        param_settings {
            param: 'NotifExpiration'
            value: '20'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue56'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Do not send a NotifyResp to the EUT.
Wait 10 seconds to allow the EUT to send a Notify message.
Do not send a NotifyResp to the EUT.
Wait 20 seconds to allow the EUT to send a Notify message.
Do not send a Notify Response to the EUT.
Wait 30 seconds.

Test Metrics

The EUT retries the Notify message within 20 seconds.
The EUT does not retry the Notify message after 20 seconds.

1.57 ObjectCreation Notification

Purpose

The purpose of this test is to ensure that the Agent will send a Notify message to the Controller when the Controller is Subscribed to the ObjectCreation event.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify57'
          }
        param_settings {
            param: 'NotifType'
            value: 'ObjectCreation'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Subscription.'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify57-2'
          }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp
Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Test Metrics

The EUT sends a successful AddResp.
The EUT sends a Notify message with a subscription_id field equal to 'Notify57', and an event element of obj_creation with a obj_path of 'Device.LocalAgent.Subscription..' and a map element of unique_keys with values of 'ID, 'Notify57-2' and 'Recipient, Device.LocalAgent.Controller..'.

1.58 ObjectDeletion Notification

Purpose

The purpose of this test is to ensure that the Agent will send a Notify message to the Controller when the Controller is Subscribed to the ObjectDeletion event.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that at least one Subscription object exists on the EUT, and the unique keys and their values are known by the traffic generator.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
            param: 'Enable'
            value: 'true'
          }
        param_settings {
            param: 'ID'
            value: 'notify58'
          }
        param_settings {
            param: 'NotifType'
            value: 'ObjectDeletion'
          }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Subscription.'
            required: true
          }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
          }
        }
      }
    }
  }

Allow the EUT to send an AddResp

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier from test setup 2>.'
      }
    }
  }

Allow the EUT to send a DeleteResp
Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Test Metrics

The EUT sends a successful AddResp.
The EUT sends a Notify message with a subscription_id field equal to 'Notify58', and an event element of obj_deletion with a obj_path of 'Device.LocalAgent.Subscription..'

1.59 Event Notification using Periodic!

Purpose

The purpose of this test is to ensure that the Agent will send a Notify message to the Controller when the Controller is Subscribed to an Event notification that correlates with an event defined in its supported data model.

Functionality Tag

Conditional Mandatory (supports Controller:1 profile and Device.LocalAgent.Controller.{i}.PeriodicNotifTime parameter)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Set message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: SET
}
body {
    request {
        set {
          allow_partial: false
            update_objs {
                obj_path: 'Device.LocalAgent.Controller.<Controller ID>.'
                param_settings {
                    param: 'PeriodicNotifInterval'
                    value: '60'
                }
                param_settings {
                    param: 'PeriodicNotifTime'
                    value: '2019-01-01T00:00:00Z'
                }
            }
        }
    }
}

Send an Add message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: ADD
}
body {
    request {
        add {
          allow_partial: false
          create_objs {
              obj_path: 'Device.LocalAgent.Subscription.'
              param_settings {
                      param: 'Enable'
                      value: 'true'
                  }
              param_settings {
                      param: 'ID'
                      value: 'sub-103'
                  }
              param_settings {
                      param: 'NotifType'
                      value: 'Event'
                  }
              param_settings {
                      param: 'ReferenceList'
                      value: 'Device.LocalAgent.Periodic!'
                  }
              }
        }
    }
}

Wait for a Notification from the EUT.
Wait for a Notification from the EUT.

Test Metrics

The EUT sends a SetResponse with an oper_success after step 1.
The EUT sends an AddResponse with an oper_success after step 2.
The EUT sends a Notification with an Periodic! event element.
A second Periodic event is sent by the EUT 60 (+/- 4) seconds after the first.

1.60 OnBoardRequest Notification

Purpose

The purpose of this test is to ensure that the Agent will send a Notify message to the Controller when the Controller initiates a SendOnBoardRequest() operation.

Functionality Tag

Conditional Mandatory (supports Device.LocalAgent.Controller.{i}.SendOnBoardRequest() command)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: OPERATE
}
body {
  request {
    operate {
      command: 'Device.LocalAgent.Controller.<instance identifier of traffic generator>.SendOnBoardRequest()'
      command_key: 'test60'
      send_resp: false
    }
  }
}

Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.

Test Metrics

The EUT sends a Notify message with (at minimum) a subscription_id field set to an empty string, and an event element of on_board_req with appropriate values for the oui, product_class, serial_number, and agent_supported_protocol_versions fields.

1.61 Operate message using Reboot() with send_resp true

Purpose

The purpose of this test is to ensure that the Agent will correctly process an Operate message using the Reboot() operation as a trigger when send_resp is true.

Functionality Tag

Conditional Mandatory (supports Reboot:1 or any other command)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: OPERATE
}
body {
  request {
    operate {
      command: 'Device.Reboot()'
      command_key: 'test61'
      send_resp: true
    }
  }
}

Allow the EUT to send an OperateResp
Allow the EUT to reboot.

Test Metrics

The EUT sends an OperateResp message with a single operation_results element containing an executed_command of 'Device.Reboot()' and a req_output_args element containing an empty output_args element.
The EUT reboots and resumes connectivity with the test system.

1.62 Operate message using Reboot() with send_resp false

Purpose

The purpose of this test is to ensure that the Agent will correctly process an Operate message using the Reboot() operation as a trigger when send_resp is false.

Functionality Tag

Conditional Mandatory (supports Reboot:1 or any other command)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: OPERATE
}
body {
  request {
    operate {
      command: 'Device.Reboot()'
      command_key: 'test62'
      send_resp: false
    }
  }
}

Allow the EUT to reboot.

Test Metrics

The EUT reboots and resumes connectivity with the test system.

1.63 Operate message using input arguments (DEPRECATED by 1.79)

The purpose of this test is to ensure that the Agent will correctly process an Operate message with input arguments.

Note: as of TP-469 Amendment 1, this test has been deprecated to sync with the deprecation of Device.LocalAgent.Controller.{i}.ScheduleTimer() in Device:2.14. The command was replaced with Device.ScheduleTimer() and is covered by test 1.79

Functionality Tag

Conditional Mandatory (supports Device.LocalAgent.Controller.{i}.ScheduleTimer() command or at least one operation that contains input arguments)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that a Subscription object exists on the EUT, subscribed to the Timer! event.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: OPERATE
}
body {
    request {
        operate {
            command: 'Device.LocalAgent.Controller.<Controller instance>.ScheduleTimer()'
            command_key: 'test63'
            send_resp: true
            input_args {
                key: 'DelaySeconds'
                value: '30'
            }
        }
    }
}

Allow the EUT to send a Timer! event.

Test Metrics

The EUT sends an OperateResp message with a single operation_results element containing an executed_command of 'Device.LocalAgent.Controller..ScheduleTimer()' and a req_output_args element containing an empty output_args element.
The EUT sends a Notify message containing a Event message with obj_path of 'Device.LocalAgent.Controller..ScheduleTimer()'.

1.64 Asynchronous operation with send_resp true

Purpose

The purpose of this test is to ensure that the Agent will correctly process an Operate message where the operation is asynchronous and send_resp is set to true.

Functionality Tag

Conditional Mandatory (supports the TraceRoute:1 profile or at least one other asynchronous operation)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that a Subscription object exists on the EUT that is subscribed to the OperationComplete notification for the supported asynchronous operation.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: OPERATE
}
body {
    request {
        operate {
            command: '<supported async operation>'
            command_key: 'test64'
            send_resp: true
            input_args {
               key: '<required input argument>'
               value: '<value>'
            }
        }
    }
}

Allow the EUT to send an OperateResp message with an executed_command which matches the command sent in the Operate message.
Allow the EUT to send a Notify message with an inner OperationComplete message with a obj_path element matching the command sent in the Operate Message.

Test Metrics

The EUT sends an OperateResp message with a single operation_results element containing an executed_command matching the command sent in the Operate message and a req_obj_path field containing a path name to the Request object created by the EUT.
The EUT sends a Notify message with obj_path and command_name forming the command sent in the Operate message, and a command_key of 'test64'.

1.65 Asynchronous operation with send_resp false

Purpose

The purpose of this test is to ensure that the Agent will correctly process an Operate message where the operation is asynchronous and send_resp is set to false.

Functionality Tag

Conditional Mandatory (supports the TraceRoute:1 profile or at least one other asynchronous operation)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that a Subscription object exists on the EUT that is subscribed to the OperationComplete notification for the supported asynchronous operation.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: OPERATE
}
body {
    request {
        operate {
            command: '<supported async operation>'
            command_key: 'test65'
            send_resp: false
            input_args {
               key: '<required input argument>'
               value: '<value>'
            }
        }
    }
}

Allow the EUT to send a Notify message containing an OperationComplete message with obj_path and command_name forming the command sent in the Operate message.

Test Metrics

The EUT does not send an OperateResp message.
The EUT sends a Notify message containing an OperationComplete message with obj_path and command_name forming the command in the Operate message, and a command_key of 'test65'.

1.66 GetInstances using a single object, first_level_only true

Purpose

The purpose of this test is to ensure that the Agent will correctly process a GetInstances message on a single object when first_level_only is true.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the Agent has at least one entry in the Device.LocalAgent.Controller.{i}. table and supports at least one multi-instance sub-object (e.g., .MTP.{i}., etc.)

Test Procedure

Send a GetInstances message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: GET_INSTANCES
}
body {
    request {
        get_instances {
            obj_paths: 'Device.LocalAgent.Controller.'
            first_level_only: true
        }
    }
}

Test Metrics

The EUT sends a GetInstancesResp with one req_path_results elements containing a requested_path of 'Device.LocalAgent.Controller.' and at least one cur_insts element.
All instantiated_obj_path elements in the GetInstancesResp only contain 'Device.LocalAgent.Controller.' instances.

1.67 GetInstances using a single object, first_level_only false

Purpose

The purpose of this test is to ensure that the Agent will correctly process a GetInstances message on a single object when first_level_only is false.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the Agent has at least one entry in the Device.LocalAgent.Controller.{i}. table and supports at least one multi-instance sub-object (e.g., .MTP.{i}., etc.)

Test Procedure

Send a GetInstances message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: GET_INSTANCES
}
body {
    request {
        get_instances {
            obj_paths: 'Device.LocalAgent.Controller.'
            first_level_only: false
        }
    }
}

Test Metrics

The EUT sends a GetInstancesResp with one req_path_results elements containing a requested_path of 'Device.LocalAgent.Controller.', and lists all instances of the Controller object, plus any instances of all sub-objects.

1.68 GetInstances with multiple objects

Purpose

The purpose of this test is to ensure that the Agent will correctly process a GetInstances message on multiple objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetInstances message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: GET_INSTANCES
}
body {
    request {
        get_instances {
            obj_paths: 'Device.LocalAgent.Controller.'
            obj_paths: 'Device.LocalAgent.MTP.'
            first_level_only: true
        }
    }
}

Test Metrics

The EUT sends a GetInstancesResp with two req_path_results elements containing a requested_path of 'Device.LocalAgent.Controller.' and 'Device.LocalAgent.MTP.'
Both req_path_results and each having at least one cur_insts element.

1.69 DELETED

Note: This test was formerly named "GetInstances with root object" and was invalid. It has been removed from this version of the test plan and exists only as a placeholder for numeric consistency.

1.70 GetInstances with wildcard search path

Purpose

The purpose of this test is to ensure that the Agent will correctly process a GetInstances message when a wildcard search path is used.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetInstances message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: GET_INSTANCES
}
body {
    request {
        get_instances {
            obj_paths: 'Device.LocalAgent.Controller.*.MTP.'
            first_level_only: true
        }
    }
}


### Test Metrics

1. The EUT sends a GetInstancesResp with at least one
   `req_path_results` element containing a
   'Device.LocalAgent.Controller.{i}.MTP.' instance.

## 1.71 GetInstances with search expression search path

### Purpose

The purpose of this test is to ensure that the Agent will correctly process
a GetInstances message when a search expression search path is used.

### Functionality Tag

Conditional Mandatory (Supports least one nested multi-instance object)

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.
2. Ensure there is at least one BootParameter for the Controller instance
   used for testing.
3. Ensure the Alias of the Controller used for testing is known.

### Test Procedure

1. Send a GetInstances message to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
        msg_id: '<msg_id>'
        msg_type: GET_INSTANCES
    }

    body {
        request {
            get_instances {
                obj_paths: 'Device.LocalAgent.Controller.[Alias=="<Controller alias>"].BootParameter.'
                first_level_only: false
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetInstancesResp with at least one
   `req_path_results` element containing a
   'Device.LocalAgent.Controller.<Controller instance>.BootParameter.' instance.

## 1.72 GetSupportedDM using a single object, first_level_only false, all options

### Purpose

The purpose of this test is to ensure that the Agent will correctly process
a GetSupportedDM message using a single object, when `first_level_only` is false
and all options are true.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
        msg_id: '<msg id>'
        msg_type: GET_SUPPORTED_DM
    }
    body {
        request {
            get_supported_dm {
                obj_paths: 'Device.LocalAgent.'
                first_level_only: false
                return_commands: true
                return_events: true
                return_params: true
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetSupportedDMResp.
2. Every `req_obj_results` element contains all
   parameters, events, and commands below the
   specified partial path, plus the supported data model information of all
   sub-objects.
3. Each SupportedParamResult field contains the `param_name`, `access`, `value_type`, and `value_change` fields with valid information, if the element is a parameter.
4. Each SupportedCommandResult field contains the `command_name` field, `command_type` field, and a set of `input_arg_names` and `output_arg_names` fields with valid information, if the element is a command.
5. Each SupportedEventResult field contains the `event_name` field and a set of `arg_names` fields with valid information, if the element is an event.

## 1.73 GetSupportedDM using a single object, first_level_only true, all options

### Purpose

The purpose of this test is to ensure that the Agent will correctly process
a GetSupportedDM message using a single object, when `first_level_only` is true
and all options are true.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

    ```
    header {
        msg_id: '<msg id>'
        msg_type: GET_SUPPORTED_DM
    }
    body {
        request {
            get_supported_dm {
                obj_paths: 'Device.LocalAgent.'
                first_level_only: true
                return_commands: true
                return_events: true
                return_params: true
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetSupportedDMResp containing `req_object_results` elements
for the specified object and each immediate child object.
2. Only the `req_obj_results` element of the object specified in `obj_paths` contains parameters, events, and commands.
3. Each SupportedParamResult field contains the `param_name`, `access`, `value_type`, and `value_change` fields with valid information, if applicable.
4. Each SupportedCommandResult field contains the `command_name` field, `command_type` field, and a set of `input_arg_names` and `output_arg_names` fields with valid information, if applicable.
5. Each SupportedEventResult field contains the `event_name` field and a set of `arg_names` fields with valid information, if applicable.

## 1.74 GetSupportedDM using a single object, first_level_only true, no options

### Purpose

The purpose of this test is to ensure that the Agent will correctly process
a GetSupportedDM message using a single object, when `first_level_only` is true
and all options are false.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
        msg_id: '<msg id>'
        msg_type: GET_SUPPORTED_DM
    }
    body {
        request {
            get_supported_dm {
                obj_paths: 'Device.LocalAgent.'
                first_level_only: true
                return_commands: false
                return_events: false
                return_params: false
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetSupportedDMResp containing `req_object_results` elements
for the specified object and each immediate child object.
2. None of the `req_obj_results` elements contain
   any commands, events, or params.


## 1.75 GetSupportedDM using multiple objects, first_level_only true, all options

### Purpose

The purpose of this test is to ensure that the Agent will correctly process
a GetSupportedDM message using multiple objects, when `first_level_only` is true
and all options are true.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
        msg_id: '<msg id>'
        msg_type: GET_SUPPORTED_DM
    }
    body {
        request {
            get_supported_dm {
                obj_paths: 'Device.LocalAgent.Controller.'
                obj_paths: 'Device.LocalAgent.MTP.'
                first_level_only: true
                return_commands: true
                return_events: true
                return_params: true
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetSupportedDMResp containing `req_object_results` elements
for the specified objects and each immediate child object.
2. Only the `req_obj_results` element of the object specified in `obj_paths`
contains parameters, events, and commands.
3. Each SupportedParamResult field contains the `param_name`, `access`, `value_type`, and `value_change` fields with valid information, if applicable.
4. Each SupportedCommandResult field contains the `command_name` field, `command_type` field, and a set of `input_arg_names` and `output_arg_names` fields with valid information, if applicable.
5. Each SupportedEventResult field contains the `event_name` field and a set of `arg_names` fields with valid information, if applicable.

## 1.76 GetSupportedDM on root object, all options

### Purpose

The purpose of this test is to ensure the Agent will correctly process
a GetSupportedDM message when the requested path is the root of the data model.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

    ```{filter=pbv type=Msg}
    header {
        msg_id: '<msg id>'
        msg_type: GET_SUPPORTED_DM
    }
    body {
        request {
            get_supported_dm {
                obj_paths:'Device.'
                first_level_only: false
                return_commands: true
                return_events: true
                return_params: true
            }
        }
    }
    ```

### Test Metrics

1. The EUT sends a GetSupportedDMResp message with one or more `req_obj_results` specifying its entire supported data model, listing commands, parameters, and events.
2. Each SupportedParamResult field contains the `param_name`, `access`, `value_type`, and `value_change` fields with valid information, if applicable.
3. Each SupportedCommandResult field contains the `command_name` field, `command_type` field, and a set of `input_arg_names` and `output_arg_names` fields with valid information, if applicable.
4. Each SupportedEventResult field contains the `event_name` field and a set of `arg_names` fields with valid information, if applicable.

## 1.77 GetSupportedDM on unsupported object

### Procedure

The purpose of this test is to ensure the Agent will correctly process
a GetSupportedDM message when the requested path is an unsupported object.

### Functionality Tag

Mandatory

### Test Setup

1. Ensure that the EUT and test equipment have the necessary information to
   send and receive USP Records to each other.

### Test Procedure

1. Send a GetSupportedDM to the EUT with the following structure:

```{filter=pbv type=Msg}
header {
    msg_id: '<msg_id>'
    msg_type: GET_SUPPORTED_DM
}
body {
    request {
        get_supported_dm {
            obj_paths:'Device.LocalAgent.UnsupportedObject.'
            first_level_only: false
            return_commands: true
            return_events: true
            return_params: true
        }
    }
}

Test Metrics

The EUT returns a GetSupportedDMResp with a single req_obj_results with an appropriate error code.

1.78 Removal of subscriptions that have no associated controller

Purpose

According to the Device.LocalAgent.Subscription.{i}.Recipient parameter:

The value MUST be the Path Name of the Controller instance that will receive the Notification associated with this Subscription. If the referenced object is deleted, this instance MUST also be deleted (so the parameter value will never be an empty string).

This test validates that if a Controller is removed from the Agent's Device.LocalAgent.Controller.{i}. table, any associated Subscription objects are also removed.

Functionality Tag

Conditional Mandatory (supports Controller:1 profile with the ability to create instances of the Device.LocalAgent.Controller. object)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the EUT has two Controller instances in its Device.LocalAgent. Controller.{i}. table, and that both Controllers can be simulated by the test equipment. Consider one to be the primary Controller, and the other to be the secondary Controller. Record the secondary Controller's instance identifier.
Ensure that there is at least one Subscription object in the EUT Device.LocalAgent.Subscription.{i}. table created by the secondary Controller.

Test Procedure

Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Controller.<instance identifier of secondary Controller>.'
    }
  }
}

Allow the EUT to send an DeleteResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The Subscription table does not contain the Subscription object outlined in test setup step 3.

1.79 Operate message using input arguments

Purpose

The purpose of this test is to ensure that the Agent will correctly process an Operate message with input arguments.

Functionality Tag

Conditional Mandatory (supports Device.ScheduleTimer() command or at least one operation that contains input arguments)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that a Subscription object exists on the EUT with NotifType OperationComplete on Device.ScheduleTimer().

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: OPERATE
}
body {
  request {
      operate {
          command: 'Device.ScheduleTimer()'
          command_key: 'test79'
          send_resp: true
          input_args {
              key: 'DelaySeconds'
              value: '30'
          }
      }
  }
}

Wait at least 30 seconds.
Allow the EUT to send a Notify message.

Test Metrics

The EUT sends an OperateResp message with the req_obj_path field, containing an Object Instance Path to the Request Object created as a result of this asynchronous operation.
The EUT sends a Notify message containing a valid OperationComplete event, with a command_name of 'ScheduleTimer()', an obj_path of 'Device.', and a command_key of 'test79'.

1.80 GetSupportedProtocol

Purpose

The purpose of this test is to ensure the Controller can learn the supported USP protocol version(s) of the EUT.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetSupportedProtocol message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET_SUPPORTED_PROTO
}
body {
  request {
    get_supported_protocol {
      controller_supported_protocol_versions: '<comma-separated list of USP specification versions>'
    }
  }
}

Allow the EUT to send a GetSupportedProtocolResponse.

Test Metrics

The EUT sends a GetSupportedProtocolResponse.
The agent_supported_protocol_versions element contains a comma-separated list of supported USP specification versions.

1.81 Automatic unique key generation

Purpose

The purpose of this test is to validate that the EUT assigns unique keys which are not supplied in the Add message.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
If the EUT has a limit on the number of instances of the Subscription object, ensure that the number of existing Subscription object instances is less than the maximum supported.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
    request {
      add {
        allow_partial: false
          create_objs {
              obj_path: 'Device.LocalAgent.Subscription.'
                param_settings {
                    param: 'Enable'
                    value: 'true'
                  }
                param_settings {
                    param: 'NotifType'
                    value: 'ValueChange'
                  }
                param_settings {
                    param: 'ReferenceList'
                    value: 'Device.LocalAgent.SoftwareVersion'
                  }
              }
          create_objs {
              obj_path: 'Device.LocalAgent.Subscription.'
                param_settings {
                  param: 'Enable'
                  value: 'true'
                }
                param_settings {
                  param: 'NotifType'
                  value: 'ValueChange'
                }
                param_settings {
                  param: 'ReferenceList'
                  value: 'Device.LocalAgent.EndpointID'
                }
            }
        }
    }
  }

Allow the EUT to send an AddResp.
Record the instance identifiers of the created objects as reported by the EUT.

Clean-up: Send a Delete message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: DELETE
}
body {
  request {
    delete {
      allow_partial: false
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier 1>.'
      obj_paths: 'Device.LocalAgent.Subscription.<instance identifier 2>.'
    }
  }
}

Allow the EUT to send a DeleteResp.

Test Metrics

The EUT AddResp is valid.
The AddResp contains two CreatedObjectResults that each have an OperationStatus of OperationSuccess. The OperationSuccess elements contains no parameter errors and 3 elements in the unique key map: Alias, Recipient, and ID. The values of Alias and ID must differ between the two CreatedObjectResults, and the values of Recipient must be identical. Alternatively, the OperationSuccess contains 2 elements in the unique key map if the Alias parameter is not supported: 'Recipient', and 'ID'. In this case the values of ID must differ between the two CreatedObjectResults, and the values of Recipient must be identical.

1.82 Get message with unmatched search expression

Purpose

The purpose of this test is to verify that the EUT sends a successful empty response when a Get request using a search expression returns no objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that no Subscription objects exist on the EUT.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[Enable==true].'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a GetResp.
The GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Subscription.[Enable==true].', and an empty resolved_path_results element (i.e., resolved_path_results{}).

1.83 GetInstances message with unmatched search expression

Purpose

The purpose of this test is to verify that the EUT sends a successful empty response when a GetInstances request using a search expression returns no objects.

Functionality Tag

Conditional Mandatory (supports least one nested multi-instance object)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetInstances message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET_INSTANCES
}
body {
  request {
    get_instances {
      obj_paths: 'Device.LocalAgent.Controller.[Alias=="<non-existent alias>"].BootParameter.'
    }
  }
}

Allow the EUT to send a GetInstancesResp.

Test Metrics

The EUT sends a GetInstancesResp.
The GetInstancesResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.Controller.[Alias==""].BootParameter.', and an empty curr_insts element (i.e., curr_insts{}).

1.84 Notification - Subscription using search paths

Purpose

The purpose of this test is to ensure that the Agent will create and acknowledge Subscriptions containing a search path, and notifies the Controller when the conditions of the subscription are triggered.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure there are at least 2 enabled BootParameter instances under the Controller used for testing.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: "<msg_id>"
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: "Device.LocalAgent.Subscription."
        param_settings: {
            param: "Enable"
            value: "true"
        }
        param_settings: {
            param: "ID"
            value: "notify84"
        }
        param_settings: {
            param: "NotifType"
            value: "ValueChange"
        }
        param_settings: {
            param: "ReferenceList"
            value: "Device.LocalAgent.Controller.<instance identifier of Controller>.BootParameter.*.Enable"
            required: true
        }
      }
    }
  }
}

Allow the EUT to send an AddResp

Send a Set message to the EUT with the following structure:

header {
  msg_id: "<msg_id>"
  msg_type: SET
}

body {
  request {

    set {
      allow_partial: false
      update_objs {
        obj_path: "Device.LocalAgent.Controller.<instance identifier of Controller>.BootParameter.<valid BootParameter instance>"
        param_settings: {
         param: "Enable"
         value: "false"
         required: true
        }
      }
    }
  }
}

Test Metrics

The EUT sends an AddResp.
The EUT sends a notification for the created subscription containing the BootParameter modified in step 3.

1.85 (For future work) Get message with unresolved instances - addressing by instance number

Purpose

This test was left out of version 1.2 of this document. There is some ambiguity in TR-369 Amendment 2 (USP 1.2) with regards to how paths that use instance number addressing should be treated when they address non-existant objects. This will be clarified in a future release.

1.86 Get message with unresolved instances - using a search path

Purpose

The purpose of this test is to ensure that the Agent successfully responds to a Get request when the requested Instantiated Object Path is valid but does not resolve to an existing object when using a search path.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that no enabled Subscription objects exist on the EUT.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.[Enable==true].'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT's sends a GetResp.
The GetResp contains no errors.
The GetResp contains a single req_path_results element. The requested_path_results element is empty (i.e. requested_path_results{}).

1.87 Get message with unresolved instances - using an object path

Purpose

The purpose of this test is to ensure that the Agent successfully responds to a Get request when the requested Instantiated Object Path is valid but does not resolve to an existing object when using an Object Path.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that no Subscription objects exist on the EUT.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT's sends a GetResp.
The GetResp contains no errors.
The GetResp contains a single req_path_results element. The requested_path_results element is empty (i.e. requested_path_results{}).

1.88 Add message fails when unique key is invalid

Purpose

The purpose of this test is to validate that the EUT will deliver an error after it receives an Add message that includes a unique key parameter that is not required but is set to an invalid value.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
           param: 'Enable'
           value: 'True'
         }
        param_settings {
           param: 'Alias'
           value: '88InvalidAlias'
         }
        param_settings {
           param: 'NotifType'
           value: 'ValueChange'
         }
        param_settings {
           param: 'ReferenceList'
           value: 'Device.LocalAgent.SoftwareVersion'
         }
        }
      }
    }
  }

Allow the EUT to send an Error message.

Test Metrics

The EUT sends an Error message containing an appropriate error code.
The EUT does not create the new Subscription object.

1.89 Get message using max_depth

Purpose

The purpose of this test is to ensure the Controller can retrieve the values of parameters in the Agent's Instantiated Data Model using the max_depth field to limit the tree depth of result_params.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.'
      max_depth: 1
    }
  }
}

Allow the EUT to send a GetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.'
      max_depth: 2
    }
  }
}

Allow the EUT to send a GetResp.

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.'
      max_depth: 0
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The first GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.', and a set of resolved_path_results elements. One contains a resolved_path of 'Device.LocalAgent.', and a number of result_params elements ONLY containing keys and values of the parameters of 'Device.LocalAgent.'. No additional resolved_path_results elements are included.
The second GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.', and a set of resolved_path_results elements. One contains a resolved_path of 'Device.LocalAgent.', and a number of result_params elements contain keys and values of the parameters of 'Device.LocalAgent.'. Additional resolved_path_results exist for each of the immediate-child sub-objects of Device.LocalAgent., with result_params containing the keys and values of each sub-object's parameters.
The third GetResp contains a single req_path_results element. The requested_path_results has no errors, has a requested_path equal to 'Device.LocalAgent.', and a set of resolved_path_results elements. One contains a resolved_path of 'Device.LocalAgent.', and a number of result_params elements contain keys and values of the parameters of 'Device.LocalAgent.'. Additional resolved_path_results exist for each of the sub-objects of Device.LocalAgent., and their sub-objects, with result_params containing the keys and values of each sub-object's parameters.
The keys of all result_params elements are Relative Paths.

1.90 Delete message with search expression that matches no objects

Purpose

The purpose of this test is to validate that the EUT properly handles a Delete message using a search path that matches no objects.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that no Subscription objects exist in the Agent's Instantiated Data Model with the Enable parameter set to 'false'.

Test Procedure

Send a Delete message to the EUT with the following structure:

 header {
   msg_id: '<msg_id>'
   msg_type: DELETE
  }
 body {
   request {
     delete {
       allow_partial: false
       obj_paths: 'Device.LocalAgent.Subscription.[Enable==false].'
     }
   }
 }

Allow the EUT to send an DeleteResp.

Test Metrics

The EUT sends a DeleteResp containing an empty oper_success element.

1.91 Unknown arguments in an Operate message

Purpose

The purpose of this test is to ensure the Agent ignores unknown arguments that are included in an operate message, using Device.ScheduleTimer() as an example.

Functionality Tags

Conditional Mandatory (supports Device.ScheduleTimer() command)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: OPERATE
}
body {
    request {
        operate {
            command: 'Device.ScheduleTimer()'
            send_resp: true
            input_args {
                key: 'DelaySeconds'
                value: '10'
            }
            input_args {
                key: 'InvalidArgument'
                value: '2'
            }
        }
    }
}

Wait for the EUT to send an OperateResp.

Test Metrics

The EUT sends a successful OperateResponse with 'ScheduleTimer()' in the executed_command element.

1.92 Agent uses default values for Operate arguments

Purpose

The purpose of this test is to ensure that the Agent will correctly use default values for non-mandatory command arguments that include defaults defined in the data model.

Functionality Tag

Conditional Mandatory (supports the TraceRoute:1 profile)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Operate message to the EUT with the following structure:

header {
    msg_id: '<msg_id>'
    msg_type: OPERATE
}
body {
    request {
        operate {
            command: 'Device.IP.Diagnostics.TraceRoute()'
            command_key: 'test92'
            send_resp: true
            input_args {
               key: 'Host'
               value: '<remote host IP>'
            }
            input_args {
               key: 'ProtocolVersion'
               value: 'Any'
            }
        }
    }
}

Allow the EUT to send an Operate Response message with an executed_command which matches the command sent in the Operate message.
Do not reply to the TraceRoute ICMP requests.

Test Metrics

The EUT sends an OperateResp message with a single operation_results element containing an executed_command of 'Device.IP.Diagnostics.TraceRoute()' and a req_obj_path field containing a path name to the Request object created by the EUT.
The EUT attempts a TraceRoute diagnostic against the supplied host name. It retries 3 times within a 1% range of a 5000 millisecond delay between each retry, which are the default values.

1.93 Subscription using TriggerAction Config

Purpose

The purpose of this test is to ensure that the Agent will update its configuration when the conditions of a subscription are fulfilled.

Functionality Tag

Conditional Mandatory (supports the Device.LocalAgent.Subscription.{i}.TriggerAction and Device.LocalAgent.Subscription.{i}.TriggerConfigSettings parameters)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not ‘TestValue93’.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
          param: 'Enable'
          value: 'true'
        }
        param_settings {
          param: 'TriggerAction'
          value: 'Config'
        }
        param_settings {
            param: 'ID'
            value: 'notify93'
        }
        param_settings {
            param: 'NotifType'
            value: 'ValueChange'
        }
        param_settings {
            param: 'ReferenceList'
            value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
            required: true
        }
        param_settings {
            param: 'NotifRetry'
            value: 'true'
        }
      }
    }
  }
}

Allow the EUT to send an AddResp
Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.'
        param_settings {
          param: 'TriggerConfigSettings'
          value: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.Enable=false'
          required: true
        }
      }
    }
  }
}

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue93'
          required: true
        }
      }
    }
  }
}

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.Enable'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a successful AddResp.
The EUT sends a GetResp that contains a result_params element with a key of ‘Enable’ and a value set to ‘false’.

1.94 Subscription using TriggerAction NotifyAndConfig

Purpose

The purpose of this test is to ensure that the Agent will update its configuration and notify the Controller when the conditions of a subscription are fulfilled.

Functionality Tag

Conditional Mandatory (supports the Device.LocalAgent.Subscription.{i}.TriggerAction and Device.LocalAgent.Subscription.{i}.TriggerConfigSettings parameters)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the traffic generator has learned the instance identifier of the Device.LocalAgent.Controller. object that represents the Controller simulated by the traffic generator.
Set the Device.LocalAgent.Controller..ProvisioningCode to an arbitrary value that is not ‘TestValue94’.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
          param: 'Enable'
          value: 'true'
        }
        param_settings {
          param: 'TriggerAction'
          value: 'NotifyAndConfig'
        }
        param_settings {
          param: 'ID'
          value: 'notify94'
          }
        param_settings {
          param: 'NotifType'
          value: 'ValueChange'
        }
        param_settings {
          param: 'ReferenceList'
          value: 'Device.LocalAgent.Controller.<instance identifier>.ProvisioningCode'
          required: true
        }
        param_settings {
          param: 'NotifRetry'
          value: 'true'
        }
      }
    }
  }
}

Allow the EUT to send an AddResp
Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.'
        param_settings {
          param: 'TriggerConfigSettings'
          value: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.Enable=false'
          required: true
        }
      }
    }
  }
}

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}
body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Controller.<instance identifier>.'
        param_settings {
          param: 'ProvisioningCode'
          value: 'TestValue94'
          required: true
        }
      }
    }
  }
}

Allow the EUT to send a Notify message.
Send a NotifyResp to the EUT.
Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier from step 2>.Enable'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The EUT sends a successful AddResp.
The EUT sends a Notify message with a subscription_id field equal to ‘Notify94’, and an event element of value_change with a param_path of ‘Device.LocalAgent.Controller..ProvisioningCode’ and a param_value of ‘TestValue94’.
The EUT sends a GetResp that contains a result_params element with a key of ‘Enable’ and a value set to ‘false’.

1.95 Add message with search expression

Purpose

The purpose of this test is to ensure the EUT properly handles an Add message that contains a search expression.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.
Ensure that the EUT has at least two Controller instances in its Device.LocalAgent.Controller.{i}. table.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}
body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Controller.[Enable==true].BootParameter.'
        param_settings {
          param: 'Enable'
          value: 'true'
        }
        param_settings {
          param: 'ParameterName'
          value: 'Device.LocalAgent.SoftwareVersion'
        }
      }
    }
  }
}

Allow the EUT to send an AddResp.
Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Controller.*.BootParameter.'
    }
  }
}

Allow the EUT to send a GetResp.

Test Metrics

The AddResp contains at least one CreatedObjectResult object that has an OperationStatus that has an element of type OperationSuccess.
The EUT sends a GetResp that contains the new BootParameter object.

1.96 Non-functional Unique Key Immutability

Purpose

The purpose of this test is to ensure the EUT does not allow a non-functional unique key to be changed.

Functionality Tag

Mandatory

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send an Add message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: ADD
}

body {
  request {
    add {
      allow_partial: false
      create_objs {
        obj_path: 'Device.LocalAgent.Subscription.'
        param_settings {
          param: 'ID'
          value: 'add96'
        }
      }
    }
  }
}

Send a Get message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: GET
}
body {
  request {
    get {
      param_paths: 'Device.LocalAgent.Subscription.<instance identifier>.'
    }
  }
}

Send a Set message to the EUT with the following structure:

header {
  msg_id: '<msg_id>'
  msg_type: SET
}

body {
  request {
    set {
      allow_partial: false
      update_objs {
        obj_path: 'Device.LocalAgent.Subscription.<instance identifier from step 1>.'
        param_settings {
        param: 'ID'
        value: 'add96-NEW'
        required: true
        }
      }
    }
  }
}

Allow the EUT to send an Error.

Test Metrics

The EUT sends an Error indicating it did not allow a non-functional unique key to be changed.

1.97 GetSupportedDM on root object, commands

Purpose

The purpose of this test is to ensure the EUT provides correctly formatted input arguments for commands returned in GetSupportedDM Resp.

Functionality Tag

Conditionally Mandatory (Supports a command that includes one or more input arguments)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetSupportedDM to the EUT with the following structure:

header {
    msg_id: '<msg id>'
    msg_type: GET_SUPPORTED_DM
}
body {
    request {
        get_supported_dm {
            obj_paths:'Device.'
            first_level_only: false
            return_commands: true
            return_events: false
            return_params: false
        }
    }
}

Test Metrics

The EUT sends a GetSupportedDMResp message with one or more req_obj_results specifying its entire supported data model, listing only commands.
Each SupportedCommandResult field contains a command_name field, an input_arg_names field, an output_arg_names field, and a command_type field.
The command_type field indicates if the command is asynchronous or synchronous.
At least one input_arg_fields contains a list of one or more input arguments. The input arguments are relative paths.

1.98 GetSupportedDM on root object, events

Purpose

The purpose of this test is to ensure the EUT provides correctly formatted fields for events returned in GetSupportedDM Resp.

Functionality Tag

Conditionally Mandatory (Supports an event that includes one or more arguments)

Test Setup

Ensure that the EUT and test equipment have the necessary information to send and receive USP Records to each other.

Test Procedure

Send a GetSupportedDM to the EUT with the following structure:

header {
    msg_id: '<msg id>'
    msg_type: GET_SUPPORTED_DM
}
body {
    request {
        get_supported_dm {
            obj_paths:'Device.'
            first_level_only: false
            return_commands: false
            return_events: true
            return_params: false
        }
    }
}

Test Metrics

The EUT sends a GetSupportedDMResp message with one or more req_obj_results specifying its entire supported data model, listing only events.
Each SupportedEventResult field contains the event_name field and an arg_names field.
At least one arg_names field contains a list of one or more arguments. The arguments are relative paths.

Files

01-messages-and-path-names.md

Latest commit

History

01-messages-and-path-names.md

File metadata and controls

1 Messages and Path Names

1.1 Add message with allow partial false, single object, required parameters succeed

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.2 Add message with allow partial true, single object, required parameters succeed

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.3 Add message with allow partial false, single object, required parameters fail

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.4 Add message with allow partial false, single invalid object

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.5 Add message with allow partial false, multiple objects

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.6 Add message with allow partial false, multiple objects with an invalid object

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.7 Add message with allow partial false, multiple objects, required parameters fail in single object

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.8 Add message with allow partial true, required parameters fail, invalid type, single object

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.9 Add message with allow partial true, required parameters fail, multiple objects

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.10 Add message with unique key addressing in path

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.11 Set message with allow partial false, required parameters pass

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.12 Set message with allow partial true, required parameters pass

Purpose

Functionality Tag

Test Setup

Test Procedure

Test Metrics

1.13 Set message with allow partial false, multiple objects