BASICO/S interoperability commands and functionsumessage command

umessage command

The umessage command sends a Windows-style message to the Client linked to the process executing the command. If the optional TO clause is used, the umessage command sends a Windows application launched by the uexecute command.

Format

 UMESSAGE [TO var,] expr1, expr2, expr3

Parameters

var Must be an identifier returned by the uexecute command
expr1 Windows message number
expr2 Numeric parameter
expr3 String parameter

Description

If the TO clause is used, var must be an identifier returned by the uexecute command RETURNING clause.

If the TO clause is not used, the message and parameters are sent to the process’s Client.

The following table lists connection message numbers and definitions:

Message Number Definition
1474 Connect message
1425 Disconnect message

Example(s)

 *
 * Program will launch notepad, Sleep 2 seconds
 * then close the window.
 *
   UEXECUTE "NOTEPAD.EXE EXISTING.TXT" RETURNING HANDLE
   SLEEP 2
   UMESSAGE TO HANDLE,16,0,""
 *
 * Program will now display a message in bottom of
 * mvTERM Window.
 *
   UMESSAGE 1527,0,"Remember to Close your files..."
 *

See also

O/S interoperability commands and functions, uclose command,

ucreate command, udelete command, uerror() function, uexecute command,

ulock command, ulseek() function, uopen command, uread command,

ureadline() function, usystem() function, uwaitfor command, uwrite command

Parent topic: O/S interoperability commands and functions