Replication Assurance Result Criteria provide result criteria implementations that can be used to match operations on the basis of replication assurance request and result state.
The Replication Assurance Result Criteria component inherits from the Result Criteria
The properties supported by this managed object are as follows:
| Basic Properties: | Advanced Properties: |
|---|---|
| description | None |
| local-assurance-level | |
| remote-assurance-level | |
| assurance-timeout-criteria | |
| assurance-timeout-value | |
| response-delayed-by-assurance | |
| assurance-behavior-altered-by-control | |
| assurance-satisfied |
| Description | A description for this Result Criteria |
| Default Value | None |
| Allowed Values | A string |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The local assurance level values that will be allowed to match this Replication Assurance Result Criteria. |
| Default Value | none received-any-server processed-all-servers |
| Allowed Values | none - Indicates that no assurance is required from local servers. received-any-server - Indicates that at least one local server should have received the request before the response is returned to the client. processed-all-servers - Indicates that all available local servers should have completed processing for the operation before the response is returned to the client. |
| Multi-Valued | Yes |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The local assurance level values that will be allowed to match this Replication Assurance Result Criteria. |
| Default Value | none received-any-remote-location received-all-remote-locations processed-all-remote-servers |
| Allowed Values | none - Indicates that no assurance is required from remote servers. received-any-remote-location - Indicates that at least one remote server should have received the request before the response is returned to the client. received-all-remote-locations - Indicates that at least one server in each remote location should have received the request before the response is returned to the client. processed-all-remote-servers - Indicates that all available remote servers should have completed processing for the operation before the response is returned to the client. |
| Multi-Valued | Yes |
| Required | Yes |
| Admin Action Required | None. Modification requires no further action |
| Description | The criteria to use when performing matching based on the assurance timeout. |
| Default Value | any |
| Allowed Values | any - Indicates that the assurance timeout will not be considered when determining whether an operation matches this Replication Assurance Result Criteria. less-than-or-equal-to - Indicates that this Replication Assurance Result Criteria should only match operations with an assurance timeout that is less than or equal to the specified assurance-timeout-value. greater-than-or-equal-to - Indicates that this Replication Assurance Result Criteria should only match operations with an assurance timeout that is greater than or equal to the specified assurance-timeout-value. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | The value to use for performing matching based on the assurance timeout. This will be ignored if the assurance-timeout-criteria is "any". |
| Default Value | 0 ms |
| Allowed Values | A duration. Lower limit is 0 milliseconds. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Indicates whether this Replication Assurance Result Criteria should match operations based on whether the response to the client was delayed by assurance processing. |
| Default Value | any |
| Allowed Values | any - Indicates that whether the response was delayed by assurance processing will not impact whether an operation matches this Replication Assurance Result Criteria. true - Indicates that this Replication Assurance Result Criteria will only match operations whose response was delayed by assurance processing. false - Indicates that this Replication Assurance Result Criteria will only match operations whose response was not delayed by assurance processing. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
assurance-behavior-altered-by-control
| Description | Indicates whether this Replication Assurance Result Criteria should match operations based on whether the assurance requirements were altered by a control included in the request from the client. |
| Default Value | any |
| Allowed Values | any - Indicates that whether the assurance behavior was altered by a request control will not impact whether an operation matches this Replication Assurance Result Criteria. true - Indicates that this Replication Assurance Result Criteria will only match operations whose request behavior was altered by a request control. false - Indicates that this Replication Assurance Result Criteria will only match operations whose request behavior was not altered by a request control. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
| Description | Indicates whether this Replication Assurance Result Criteria should match operations based on whether the assurance requirements have been satisfied. |
| Default Value | any |
| Allowed Values | any - Indicates that whether the assurance requirements were satisfied will not impact whether an operation matches this Replication Assurance Result Criteria. both-satisfied - Indicates that only operations which satisfied both local and remote assurance requirements will match this Replication Assurance Result Criteria. either-satisfied - Indicates that only operations which satisfied either or both of the local or remote assurance requirements will match this Replication Assurance Result Criteria. at-least-local-satisfied - Indicates that only operations which satisfied the local assurance requirements (regardless of whether they satisfied the remote assurance requirements) will match this Replication Assurance Result Criteria. at-least-remote-satisfied - Indicates that only operations which satisfied the remote assurance requirements (regardless of whether they satisfied the local assurance requirements) will match this Replication Assurance Result Criteria. only-local-satisfied - Indicates that only operations which satisfied the local assurance requirements but not the remote assurance requirements will match this Replication Assurance Result Criteria. only-remote-satisfied - Indicates that only operations which satisfied the remote assurance requirements but not the local assurance requirements will match this Replication Assurance Result Criteria. either-not-satisfied - Indicates that only operations in which either or both of the local or remote assurance requirements were not satisfied will match this Replication Assurance Result Criteria. at-least-local-not-satisfied - Indicates that only operations which did not satisfy the local assurance requirements (regardless of whether they satisfied the remote assurance requirements) will match this Replication Assurance Result Criteria. at-least-remote-not-satisfied - Indicates that only operations which did not satisfy the remote assurance requirements (regardless of whether they satisfied the local assurance requirements) will match this Replication Assurance Result Criteria. neither-satisfied - Indicates that only operations in which neither the local nor the remote assurance requirements were satisfied will match this Replication Assurance Result Criteria. |
| Multi-Valued | No |
| Required | No |
| Admin Action Required | None. Modification requires no further action |
To list the configured Result Criteria:
dsconfig list-result-criteria
[--property {propertyName}] ...
To view the configuration for an existing Result Criteria:
dsconfig get-result-criteria-prop
--criteria-name {name}
[--tab-delimited]
[--script-friendly]
[--property {propertyName}] ...
To update the configuration for an existing Result Criteria:
dsconfig set-result-criteria-prop
--criteria-name {name}
(--set|--add|--remove) {propertyName}:{propertyValue}
[(--set|--add|--remove) {propertyName}:{propertyValue}] ...
To create a new Replication Assurance Result Criteria:
dsconfig create-result-criteria
--criteria-name {name}
--type replication-assurance
[--set {propertyName}:{propertyValue}] ...
To delete an existing Result Criteria:
dsconfig delete-result-criteria
--criteria-name {name}