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

GPMSPW - Set Message Password

GPMSPW (ncid, pass)

Purpose

Use GPMSPW to set a password for application message receiving. The graPHIGS API uses this password to authorize the Send Private Message (GPSPMS) subroutine or Send Broadcast Message (GPSBMS) subroutine issued by other application processes.

For more information about the use of broadcast and private messages, see The graPHIGS Programming Interface: Understanding Concepts and The graPHIGS Programming Interface: Writing Applications

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

pass -- specified by user, fullword integer

Password.
0=None
Application will not receive messages.
-1=All
Application will receive any broadcast or private messages.
Unique Integer
Application will receive only private messages.

Error Codes

202
SPECIFIED NUCLEUS DOES NOT EXIST

Related Subroutines

GPSBMS
Send Broadcast Message
GPSPMS
Send Private Message

RCP code

201341443 (X'0C003A03')

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