SET USER-COMMAND

Basic form

SET USER-COMMAND f.

Effect

Only with report output:

Interprets the contents of the field f as a user command and executes it as soon as the list is next displayed, i.e. the list display is suppressed and the event AT LINE-SELECTION or AT USER-COMMAND is processed or, in the case of a system function code (list of reserved function codes ), the appropriate system function is executed.
The effect is exactly as if the user had entered the function in the command field and pressed ENTER. This means in particular that the current position of the list (SCROLL ) and the cursor (SET CURSOR ) are taken into account.

Note

You can use SET USER-COMMAND recursively, i.e. request the statement again within the event processed by SET USER-COMMAND.
If a list of several consecutive functions is defined when creating a list, only the last of these is effective.
If the ENTER function key itself contains a function code in the GUI status of the relevant list, the system executes this and not the function requested with SET USER-COMMAND.

Example

Processing a block of selected lines immediately


WRITE ...  "create a list
SET CURSOR LINE 7.


SET USER-COMMAND 'PICK'.

The event AT LINE-SELECTION is processed at once for the list line 7.

Example

Immediate processing of a function


WRITE ...  "create a list


SET USER-COMMAND 'FUN'.

The event AT USER-COMMAND is processed and the system field SY-UCOMM contains the function code 'FUN'.

Example

Leave list immediately


WRITE ...  "create a list


SET USER-COMMAND 'BACK'.

The list is not displayed and the user leaves it immediately.

Example

Generate list with pop-up 'Find by...'


WRITE ...  "create a list


SET USER-COMMAND '%SC'.