Initiate a b3270 action or sequence of actions.
Attribute | Required? | Purpose |
---|---|---|
r-tag | no | Unique UI-generated tag |
type | no | Type of action |
actions | yes | Actions and parameters |
The r-tag is a unique identifying string generated by the user interface. If given, it will be passed back by the emulator 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 b3270 actions to run. It is in standard s3270 syntax.
When the actions are complete, the emulator 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.
Example:
<run r-tag="ui-1234" type="keymap" actions="Enter() PF(1)"/>