[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPSPMS - Send Private Message

GPSPMS (ncid, shid, pass, major, minor, len, msg)

Purpose

Use GPSPMS to send an application message to another application process connected to the specified nucleus. To be able to send private messages, you previously must have set the message of the target application process to -1=ALL or set a unique password that matches the password supplied in the pass parameter. The message is limited to the size of the outbound buffer of the sending application and the size of the inbound buffer and event queue of the target application.

For information about sending and receiving messages between application processes, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

shid -- specified by user, fullword integer

Target application identifier.

pass -- specified by user, fullword integer

Password. This must match the password of the target application process.

major -- specified by user, fullword integer

Major code.

minor -- specified by user, fullword integer

Minor code.

len -- specified by user, fullword integer

Length of the message in bytes (>=0)

msg -- specified by user, variable data

Message.

Error Codes

197
MESSAGE STRING LENGTH < ZERO
202
SPECIFIED NUCLEUS DOES NOT EXIST
207
SPECIFIED APPLICATION IDENTIFIER DOES NOT EXIST
213
SPECIFIED PASSWORD IS INCORRECT

Related Subroutines

GPAWEV
Await Event
GPCVD
Convert Data
GPMSPW
Set Message Password
GPQNCR
Inquire Nucleus Resource Identifier
GPQSH
Inquire Shell Identifier
GPSBMS
Send Broadcast Message

RCP code

201341441 (X'0C003A01')


[ Previous | Next | Contents | Glossary | Home | Search ]