Help Centre › Building Processes
Description
These actions handle complex terminal interactions: multi-screen navigation sequences, transaction execution, screen identification, and structured data extraction.
Navigation
- terminal-navigate – Execute a multi-screen navigation sequence. Each step sends text or keys, then waits for expected text before proceeding. Define steps as JSON:
[{"send": "LOGON", "keys": "enter", "wait_for": "Password"}] - terminal-execute-transaction – Execute a transaction code (CICS, TSO, AS/400 commands like WRKACTJOB). Types the code, presses Enter, and optionally waits for the resulting screen.
- terminal-identify-screen – Identify the current screen by matching text patterns at fixed positions. Useful for screen-driven logic in loops.
Data Extraction
- terminal-scrape-table – Parse tabular data from a screen region into a list of dicts. Define columns with position and width:
[{"name": "id", "col": 1, "length": 10}]. Empty rows are automatically skipped. Use with paging (PF8/pagedown) to scrape multi-page tables.
Common Patterns
Login Sequence
Use terminal-navigate with steps to enter credentials and wait for the main menu.
Transaction Loop
Use terminal-execute-transaction to enter a transaction, then terminal-scrape-table to extract results, and terminal-send-keys with PF8 to page through results.