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)

Parameters

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");