TE_unlock_keyboard

Send Text Functions

Unlocks the keyboard of a mainframe terminal.

int TE_unlock_keyboard( void );

Use TE_unlock_keyboard to unlock a keyboard of a mainframe terminal after it became locked as a result of an error message. TE_unlock_keyboard is equivalent to pressing the F3 key.

Return Values

This function returns 0 if it succeeds, and a negative error code if it fails. It also sets the global variable TE_errno.

Parameterization

You cannot use standard parameterization for any arguments in this function.

Example

The following example checks the terminal for an application error message. If it finds one it will unlock the keyboard.

    int rc; 
    rc = TE_find_text ("application error", 0, 0, -1, -1, NULL, NULL, NULL); 
    if (rc == 0) 
        TE_unlock_keyboard();