[ 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 ]