Terminal wait functions

Waiting for terminal readiness, text appearance, and field values.

Help CentreBuilding Processes

Description

These actions pause the process until a terminal condition is met, with a configurable timeout (default 30 seconds).


Wait Actions

  • terminal-wait-for-ready – Wait until the terminal keyboard is unlocked and ready for input. Use after sending keys that trigger host processing.
  • terminal-wait-for-text – Wait until specific text appears anywhere on the screen
  • terminal-wait-for-text-at – Wait until specific text appears at a specific row and column position
  • terminal-wait-for-field – Wait until a field (by index) contains the expected text

Best Practices

  • Always use terminal-wait-for-ready after sending Enter or PF keys before reading the screen
  • Use terminal-wait-for-text to detect screen transitions (e.g., waiting for a menu title)
  • Set appropriate timeouts for slow host responses (CICS transactions, batch queries)

See it working on your own data

Everything documented here ships with the platform – try the document tools free, or go live in 7 days.