GMSG

GDDM-GKS V1R1 Programming Guide and Reference

GMSG

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

Purpose


GMSG	(wkid,mess)

Function: Control function. Displays a message at a workstation. Use this call only if your program is written in VS FORTRAN. Otherwise, use the function Message (GMSGS) instead.

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier, selected when the workstation was opened.

mess (specified by user) (character)
The message string to be displayed.

Operating states

WSOP, WSAC, SGOP

Related functions

None

Description

This function displays the message mess. If the workstation wkid is a plotter, a printer, a GDF-file workstation, or a display, the message is displayed at the user console. If the workstation is a metafile output workstation, a MESSAGE metafile item is written to the metafile.

This function cannot send a message to workstation independent segment storage (WISS). Messages sent to metafile input workstations are ignored.

The call does not affect the GKS state list or the execution of subsequent GKS functions. When a message is displayed at the user console, the screen is temporarily cleared while the message is shown.

If lstr is less than 0, GDDM-GKS will report error 2001.

Principal errors


        7  GKS not in proper state: GKS shall be in one of the states
           WSOP, WSAC, or SGOP
       20  Specified workstation identifier is invalid
       25  Specified workstation is not open
       36  Specified workstation is Workstation Independent Segment
           Storage
     2001  Output parameter size insufficient

Notices | Terms of use | Support | Contact z/OS