graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPSBMS - Send Broadcast Message

GPSBMS (ncid, major, minor, len, msg)

Purpose

Use GPSBMS to send a broadcast message to all application processes that can accept messages and are connected to the specified nucleus. To be able to accept messages, you previously must have set the application's message password to -1=ALL 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.

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

Related Subroutines

GPAWEV: Await Event
GPCVD: Convert Data
GPMSPW: Set Message Password
GPQSH: Inquire Shell Identifier
GPSPMS: Send Private Message

RCP code

201341442 (X'0C003A02')