Skip to content

StateDMI / Command / SetWellRight

Overview

The SetWellRight commnd (for StateCU and StateMod) sets data in existing well rights or adds a new well right. If a new right is added, it is added in alphabetical order according to the right identifier.

Command Editor

The following dialog is used to edit the command and illustrates the command syntax.

SetWellRight command editor

SetWellRight Command Editor (see also the full-size image)

Command Syntax

The command syntax is as follows:

SetWellRight(Parameter="Value",...)

Command Parameters

Parameter                           Description Default                    
ID A single well right identifier to match or a pattern using wildcards (e.g., 20*). None – must be specified.
Name The name to be assigned for all matching well rights. If not specified, the original value will remain.
StationID The well station identifier to be assigned for all matching well rights. If not specified, the original value will remain.
AdministrationNumber The administration number to be assigned for all matching well rights. If not specified, the original value will remain.
Decree The water right decree to be assigned for all matching well rights. If not specified, the original value will remain.
OnOff The on/off switch value to be assigned for all matching well rights, either 1 for on or 0 for off, a positive 4-digit year to turn the right on starting in the year, or a negative 4-digit year to turn the right off starting in the year. If not specified, the original value will remain.
IfNotFound Used for error handling, one of the following:
  • Add – add the water right if the ID is not matched and is not a wildcard
  • Fail – generate a failure message if the ID is not matched
  • Ignore – ignore (don’t add and don’t generate a message) if the ID is not matched
  • Warn – generate a warning message if the ID is not matched
 Warn
IfFound Used for error handling, one of the following:
  • Set – set the water right data
  • Fail – generate a failure message if the ID is matched
  • Ignore – ignore (don’t set and don’t generate a message) if the ID is matched
  • Warn – generate a warning message if the ID is matched
 Warn

Examples

See the automated tests.

Troubleshooting

See the main troubleshooting documentation

See Also