GDDM-GKS V1R1 Programming Guide and Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


GMSGS

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00
Purpose
 GMSGS  (wkid, lstr, mess)
   
 APL code  1490
 GKS RCP code  X'38000A00' (939526656)
   
Function: To message.
Control function. Displays a message at a workstation. If your program is written in VS FORTRAN, use the function Message (VS FORTRAN only) (GMSG) instead.
Parameters

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

lstr (specified by user) (fullword integer)
The number of characters in mess.

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

Go to the previous page Go to the next page
Notices | Terms of use | Support | Contact z/OS



Copyright IBM Corporation 1990, 2012