GWAIT

GDDM-GKS V1R1 Programming Guide and Reference

GWAIT

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

Purpose


GWAIT	(tout, wkid, icl, idnr)

APL code	1391
GKS RCP code	X'38005D00' (939547904)

Function: To await event.

Input function. Returns information concerning the oldest entry in the input queue. (See the section "GDDM-GKS restrictions" below.)

Parameters

tout (specified by user) (short floating point)
The time-out value in seconds.

wkid (returned by GDDM) (fullword integer)
The workstation identifier.

icl (returned by GDDM) (fullword integer)
The input class. The possible values are:

0 (GNCLAS)

None

1 (GLOCAT)

Locator

2 (GSTROK)

Stroke

3 (GVALUA)

Valuator

4 (GCHOIC)

Choice

5 (GPICK)

Pick

6 (GSTRIN)

String

If the time-out interval has elapsed, and the input queue is empty, the value none is returned.

idnr (returned by GDDM) (fullword integer)
The logical input device number.

Operating states

WSOP, WSAC, SGOP

Related functions

Set locator mode (GSLCM), Set stroke mode (GSSKM), Set valuator mode (GSVLM), Set choice mode (GSCHM), Set pick mode (GSPKM), Set string mode (GSSTM), Flush device events (GFLUSH)

Description

(See the section "GDDM-GKS restrictions" below.)

When an input device is set in event mode, the input data is stored in an input queue. This queue stores all events for all input devices that are in event mode. The Await event (GWAIT) function checks the content of the input queue and makes available the oldest event that took place.

GDDM-GKS Restrictions

GKS does not support this function at level 2b. If this function is invoked, GDDM-GKS reports error 143.

Principal errors

7: GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
143: EVENT and SAMPLE input mode are not available at this level of GKS
147: Input queue has overflowed
151: Timeout is invalid

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