Run operation

A b3270 protocol message that initiates a b3270 action or sequence of actions.

The r-tag is a unique identifying string generated by the user interface. If given, it will be passed back by b3270 in a run-result indication when the actions are complete.

The type gives the origin of the operation. Supported values include keymap and macro (the default). This is largely used for debug purposes in traces, but some actions behave differently with different types.

actions is a list of actions to run. It uses standard action syntax. (In JSON, it can also be a struct with a separate action name and arguments, or an array of such structs.)

When the actions are complete, b3270 will send a run-result indication with the execution status and result string, if any. Note that since all UI actions are run asynchronously, these indications may arrive in a different order than the operations were sent. Also note that if there is an HTML syntax error in a run operation (e.g., a missing or unknown attribute), a ui-error indication will be produced instead.

Finally note that as with all b3270 macros, if one action in a multi-action sequence fails, the remaining actions will not be executed.

Examples
XML  JSON {"run":{"actions":"Enter PF(1)"},"r-tag":"ui-1234"} {  "run": { "actions": [ { "action":"Enter" }, { "action": "PF", "args": ["1"]} ],    "r-tag": "ui-9991" } }