requestMonitorApproval

Signal a Screen Change event so that an operator working with a Viewer Monitor window can Approve or Reject the actions of the application.

bool HostScreen.requestMonitorApproval(String aidKey, String statusInfo,

int timeout, [Out] String comment);

Arguments

aidKey

Required. Aid/Enter key to be displayed to the user of the Monitor. This is the proposed key to be used to enter the current screen

statusInfo

Any additional information to assist the Monitor user in understanding the state/phase of the current transaction

timeout

Number of milliseconds to wait for the response from the monitor. Note that a timeout is treated the same way as a Reject, so this value should be high enough to give the user time to react and process the proposed screen change

comment

Any comment entered by the user of the Viewer Monitor--can then be saved in an application log file to assist in fixing any issues identified in this transition

Returns

True if the transition is approved (or no monitor is active), False if rejected.

Remarks

The heart of the Viewer Test Monitor use, this method provides the monitoring user information on how the current screen is to be entered.

The calling application using this request should cancel any further operations on the session if the False (rejected) value is returned.

Requirements

Flynet Viewer