Q_NAVIGATE_TO_SCREEN Function

RAMP-TS

previous page next page

Q_NAVIGATE_TO_SCREEN Function

Navigates to a nominated 5250 screen, the request is queued up and processed when the next screen arrives.

Syntax

Q_NAVIGATE_TO_SCREEN(argCondition, sScreenName)

Parameters

argCondition

Optional. May be passed as:

  • null or "", indicating that no condition applies
  • "=<<screen name when the queued instruction is executed>>" indicating that the resulting SENDKEY/SETVALUE should only be performed if the next screen is as named.
  • "!=<<screen name when the queued instruction is executed>>" indicating that the resulting SENDKEY/SETVALUE should only be performed if the next screen is not as named.

The screen name condition is tested when the next or resulting screen arrives. The name specified does not have anything to do with the current screen name.

  

SScreenName

Required. A string that contains the name of a screen.

 

 

Return Value

None

Example

 

Q_NAVIGATE_TO_SCREEN("=WorkwithCustomers","WorkwithCustomers_Generic");

 

Note that this function should only be invoked from a button script.

 

 

 

previous page start next page