WaitForScreenGoTo

Syntax -

WaitForScreenGoTo  <LabelName> <TimeOut> <ScreenName> [<ScreenNameX> …]

       Where:

       <LabelName> is text containing the name of the Label.

       <TimeOut> is a numeric value.

       <ScreenName> and <ScreenNameX> are literal strings or variables that contain literal strings. If there are more than one they are separated by a space.

Description:

This command is used to stop the processing of the script until either the number of seconds defined in <TimeOut> is exceeded, or a screen is displayed that has one of the names in the list of <ScreenName> [<ScreenNameX> …].   If the time limit is exceeded or the screen does not exist, EMUE resumes the processing of the script at the label specified in <LabelName>.

Note: Label names should not be stored in a variable nor should it be in quotes.

Note: Screen names should be in quotes or stored in a variable.

Note: This command is used when the expected screen response from the previous command may be delayed for a few seconds.  It has been noted that in some cases, $XFR actions (as are used in the interaction with EAD) will cause the terminal session to report that it is ready before it has displayed a new screen.  If this occurs, the script will continue processing and may cause errors or unexpected results.  Using the WaitForScreenGoTo command after an $XFR can prevent the script from continuing until the terminal session has displayed the proper screen.

Sample:

       The following statement will look for the ScreenID "NPGEFN00" and if not found after 3 seconds will transfer control of the script to the label identified.

WaitForScreenGoTo Label_Name 3 "NPGEFN00"