...
Query the status of attributes i.e. state, dstate, repeat,event, meter, variable or trigger expression without blocking
- 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 return 'set' | 'clear' to standard out
- meter return value of the meter to standard out
- 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'\n\n"
...
The command will fail if the node path to the attribute does not exist in the definition and if:
- repeat The repeat is not found
- event The event is not found
- meter The meter is not found\
- variable No user or generated variable or repeat of that name found on node, or any of its parents
- trigger Trigger does not parse, or reference to nodes/attributes in the expression are not valid\n"
...
- arg1 = [ state | event | meter | variable | trigger ]
- arg2 = <path> | <path>:name where name is name of a event, meter or variable
- arg3 = trigger expression (optional) | prev | next # prev,next only used when arg1 is repeat
Usage:
- ecflow_client --query state /path/to/node # return node state to standard out
- ecflow_client --query dstate /path/to/node # state that can includes suspended
ecflow_client --query repeat /path/to/node # return the current value as a string
ecflow_client --query repeat /path/to/node prev # return the previous value as a string, does not modify real repeat
ecflow_client --query repeat /path/to/node next # return the next value as a string, does not modify real repeat
- ecflow_client --query event /path/to/task/with/event:event_name # return set | clear to standard out
- ecflow_client --query meter /path/to/task/with/meter:meter_name # returns the current value of the meter to standard out
- ecflow_client --query variable /path/to/task/with/var:var_name # returns the variable value to standard out
- ecflow_client --query trigger /path/to/node/with/trigger \"/suite/task == complete\" # return true if expression evaluates false otherwise
...