The GRAPH_DIALOG function module is a feature of the old waiting mechanism, which is not recommended for new programs.

The GRAPH_DIALOG function module does not call a specific graphics program. Instead, GRAPH_DIALOG offers specific utility functions:

• closing windows

• performing waiting

The following table contains a list of all possible parameters you can use with this function module.

Note: ** denotes a dialog parameter

If you merely want to close windows, you only need the KWNID or CLOSE parameters.

If you merely want the function module to perform waiting, you only need the M_TYP and RWNID parameters. A STAT value of SPACE, a Wait value, is assumed by default. (The INBUF and RBUFF parameters are old and no longer needed. Do not use them when updating an existing programs.)

The primary reason to call GRAPH_DIALOG is to kill a window from the ABAP program. The program can close one or all windows at a time.

Normally, windows are closed by the online user. This action is merely reported back to the ABAP program by the function module waiting for user input.

Occasionally, however, there may be reasons why the ABAP program needs to close the window itself. In this case, the ABAP program should call GRAPH_DIALOG with the KWDID parameter set to a valid window ID.

You can also use GRAPH_DIALOG as the function module that waits for input from the user. This can simplify how you handle return parameters.

GRAPH_DIALOG doesn't call any graphics program of its own. This means that all messages received from graphics programs can be handled consistently. There is no need to distinguish between messages sent by the waiter's graphics program, and those sent by other graphics programs. An M_TYP (message type) parameter of 'I' is not possible when GRAPH_DIALOG is the waiter.

If your ABAP program allows the online user to open multiple windows or enter data with the mouse or keyboard, the application is interactive.