Setting command history return value

3 views
Skip to first unread message

Lu L

unread,
Nov 20, 2025, 6:35:00 AMNov 20
to yamcs
Dear all,

I recently discovered that the command history tab in yamcs web has a "Return Value" checkbox, which should (when enabled) show the return value for each command sent. 

Screenshot 2025-11-11 142326.png

This setting would be highly desirable for us to use, since it simplifies operation quite a bit. I have been trying various options for setting the correct return parameter over the last couple of days, but unfortunately to no avail. 
From digging through the yamcs web code I am guessing it is connected to some "_RETURN" parameter, however none of the keys I tried seemed to work. Could you kindly point me to the right method of setting this parameter? Which functions/keys are intended for this?

Thanks in advance,
Lu

fabia...@spaceapplications.com

unread,
Nov 20, 2025, 7:16:03 AMNov 20
to yamcs
The return value of a command history entry is derived from the return value(s) of its verifiers. Specifically, if a verifier is successful and causes the command to be considered "COMPLETED", that verifier's return value is promoted to the return value of the command itself.

The UI looks for an attribute CommandComplete_Return (= return value associated to the built-in CommandComplete acknowledgment).

This functionality was introduced while working with a spacecraft that was REQUEST/REPLY-oriented. I had programmatic command verifiers (public class VerifyReplyAlgorithm extends AbstractAlgorithmExecutor implements ContainerConsumer) that would listen to incoming telemetry for the matching reply to a sent command (request). The "execute" method of the verifier has to return an AlgorithmExecutionResult where you can pass a return value. I cannot paste the implementation, but maybe you can do something with this information.

Reply all
Reply to author
Forward
0 new messages