MESSAGE(3P) — SUNPHIGS LIBRARY

NAME

MESSAGE − display a message on a workstation

SYNOPSIS

C Syntax

void
pmessage ( ws, msg )
Pintws;workstation identifier
Pchar∗msg;message string

FORTRAN Syntax

SUBROUTINE pmsg ( WKID, MESS )
INTEGERWKIDworkstation identifier
CHARACTER∗(∗)MESS message

FORTRAN Subset Syntax

SUBROUTINE pmsgs ( WKID, LSTR, MESS )
INTEGERWKIDworkstation identifier
INTEGERLSTRlength of string (in characters)
CHARACTER∗80MESS message

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

MESSAGE displays a message (character string) on the specified workstation. See Execution below for a description of the placement of the message on the workstation.

C Input Parameters

wsThe workstation to send the message to.

msgThe null terminated array of Pchar (character string) to display on the workstation.

FORTRAN Input Parameters

WKIDThe workstation to send the message to.

MESSThe array of characters to display on the workstation.

Execution

MESSAGE displays the specified character string on the specified workstation. The location of the message’s display is dependent upon the workstation type as follows:

Sun_Tool and Sun_Canvas workstation types
If the workstation has a text subwindow associated with it the message is written to that window. If a STRING input device is also active and using the text subwindow, the message will be interleaved (correctly) with the operator input.

If the workstation does not have a text subwindow associated with it the message will be written to the lower left corner of the workstation’s graphics window, and will be removed upon the next clearing of that window. See UPDATE WORKSTATION and SET DISPLAY UPDATE STATE for a description of when the window is cleared. See WORKSTATION TYPE SET for a description of how to associate a text subwindow with a workstation.

CGM output workstation types
A CGM message element is written to the CGM file. The interpretation of this element is dependent on the subsequent reader of the file.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

Museum