NAVIGATE_TO_SCREEN Function

RAMP-TS

NAVIGATE_TO_SCREEN Function

Navigates to a nominated 5250 screen.

Note that if you specify the name of the current destination the request will be ignored.

Syntax

NAVIGATE_TO_SCREEN(sScreenName, ForAction)

Parameters

SScreenName

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

ForAction

 

Char 256 – Optional.

String that contains a user defined value. This value will be returned to the Screen Wrapper in the vHandleArrive event.

 

Return Value

None

Remarks

This function typically initiates an asynchronous 5250 server side operation. Your RAMP-TS script(s) should end all processing immediately after invoking this function and then do nothing more until the asynchronous operation completes.

The completion of the asynchronous operation is typically indicated by the execution of the arrival script of the resulting 5250 screen display.  (Any queued script functions should be queued prior to executing this script function).

 

Example

 

NAVIGATE_TO_SCREEN("Enrol Employee");