Wait for a specific condition on the terminal emulation screen that will be sent by the host.
If the condition is true, the corresponding statement is executed.
If the condition is false, or if the time period defined in the
system variable RESPONSE has exceeded without
receiving a screen from the host, the next statement is executed.
WAITFOR screenvariable operator string command
screenvariable represents the variable
*SCREEN (syntax see below).
operator is one of the following:
EQ
|
equal |
NE
|
not equal |
GE
|
greater than or equal to |
LE
|
less than or equal to |
GT
|
greater than |
LT
|
less than |
For command, you can use any Entire Connection command except the following:
IF
IFNOT
WAITFOR
*SCREEN The variable *SCREEN can only be used
once per WAITFOR.
*SCREEN [row column [length]]
row is a value between 1 and the maximum number of lines +1.
column is a value between 1 and the maximum line size.
length is a value between 1 and the screen size.
For example:
*SCREEN means the whole screen.
*SCREEN 2 1 means from row 2, column 1 to the end of the
screen.
*SCREEN 2 1 80 means from row 2, column 1, the next 80
positions.
Check whether the string CP READ occurs on the screen
and, if the condition is true, branch to the LOGON tag:
WAITFOR *SCREEN EQ 'CP READ' GOTO LOGON
Check whether the string NEXT occurs on the screen,
starting in row 2, column 1, and, if the condition is true, send
CR to the host:
WAITFOR *SCREEN 2 1 EQ 'NEXT' TYPE CR
Check the value defined in the local variable
#PARM1 and, if the condition is true, branch to
the CONTINUE tag:
WAITFOR *SCREEN EQ #PARM1 GOTO CONTINUE
Waitcmds.ncp
If the condition is true, the screen position of the string is returned in the following local variables:
#ROW - valid values are between 1 and the maximum number
of lines +1
#COL - valid values are between 1 and the maximum line
size
| Procedure File: | Yes |
| Command Line: | No |
| Key: | No |
| API: | No |