Currently, the ecflow python api API provides quite extensive functionality.
However sometimes we just want to query simple state on the command line, and using the full-blown python apiAPI, can seem like an overkill.
Query can be used in these simple cases
...
- state return [unknown | complete | queued | aborted | submitted | active] to standard out
- dstate return [unknown | complete | queued | aborted | submitted | active | suspended] to standard out
- repeat returns current value as a string to standard out, can also retrieve the next and previous value of the repeat. See examples below
The next/prev will always stay within repeat bounds. hence calling 'next' on the last value of the repeat, will return last value.
Likewise calling 'prev' on a repeat that has not started, will return the first/start value. - event event return 'set' | 'clear' to standard out
- meter meter return return value of the meter to standard out
- limit limit return the current value of the limit
- limit_max return the maximum value of the limit
- label return label return new value otherwise the old value
- variable variable return value of the variable, repeat or generated variable to standard out, will search up the node tree
- trigger returns 'true' if the expression is true, otherwise 'false'
...
- repeat The repeat is not found
- event The event is not found
- meter The meter is not found
- limit/limit_max The limit is not found
- label The label is not found
- variable No No user or generated variable or repeat of that name found on node, or any of its parents
- trigger Trigger trigger Trigger does not parse, or reference to nodes/attributes in the expression are not valid\n"
Arguments:
- arg1 = [ state | event | meter | label | variable | trigger | limit | limit_max ]
- arg2 = <path> | <path>:name where name is name of a event, meter,limit or variable
- arg3 = trigger expression (optional) | prev | next # prev,next only used when arg1 is repeat
...