RSC/MP 7.2 Programming Manual

Unsolicited Message Service
HP NonStop Remote Server Call (RSC/MP) Programming Manual—522360-004
8-7
Sending Messages Using RSCCOM
Sending Messages Using RSCCOM
The RSCCOM TELL command can send informational messages to sessions on
remote workstations. The following example sends the message “HELLO” to
workstation TERM01 whose group alias is TEST:
(( TELL TERM01 GROUP TEST HELLO
See the Remote Server Call (RSC/MP) Installation and Configuration Guide for more
information about the RSCCOM commands.
UMS Header Description
When using the UMS header that is included in the RSC.H file, place the message
data in a buffer immediately following this header.
typedef struct
{
SHORT nCode;
USHORT uVersion;
CHAR acTerminalName [ RSC_TERMNAME_SIZE ];
CHAR acAlias [ RSC_ALIAS_SIZE ];
USHORT uAliasType;
} RSC_UMS_HEADER;
where each value is defined as:
nCode
The RSC/MP return code of the UMS SEND operation. The return codes are
defined in the RSC.H header file. A return value of zero indicates that the operation
was successful. See the Remote Server Call (RSC/MP) Messages Manual for
other possible values.
uVersion
The version of RSC/MP with which the application was compiled. After an
application is compiled, the version number is input to the RSC_VERSION value in
the RSC.H file. The version of your application is compared to the version of
RSC/MP to ensure you are using the UMS header that corresponds to the version
of your application.
acTerminalName
The TERM_NAME of the workstation that receives the message or an asterisk (*)
for all terminals. The name must be terminated with NULL characters or filled to
the end with blank characters.