GQDCH

GDDM-GKS V1R1 Programming Guide and Reference

GQDCH

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

Purpose


GQDCH	(wtype, devno, n, mldr, errind, malt, ol, pet, earea, ldr, datrec)

APL code	1503
GKS RCP code	X'3800DB00' (939580160)

Function: To inquire default choice device data.

Inquiry function. Returns the default data for a choice device at a workstation, from the workstation description table. (See the section "GDDM-GKS restrictions" below.)

Parameters

wtype (specified by user) (fullword integer)
The workstation type.

devno (specified by user) (fullword integer)
The choice device number.

n (specified by user) (fullword integer)
The element requested from the list of available prompt and echo types. If the value specified is 0, the number of available prompt and echo types is returned in ol but pet is undefined.

mldr (specified by user) (fullword integer)
The dimension of the data record array datrec

errind (returned by GDDM) (fullword integer)
The error indicator

malt (returned by GDDM) (fullword integer)
The maximum number of alternatives. For some choice devices, for example, the Enter key, light pen, and tablet stylus, the value returned is 1; for these devices, if the operator triggers the device during a Request choice (GRQCH) operation, the choice number returned is always 0.

ol (returned by GDDM) (fullword integer)
The number of available prompt and echo types.

pet (returned by GDDM) (fullword integer)
Element n of the list of available prompt and echo types.

earea (returned by GDDM) (array of short floating-point numbers)
The echo area in device coordinates (XMIN, XMAX, YMIN, YMAX).

ldr (returned by GDDM) (fullword integer)
The number of elements used in the data record array.

datrec (returned by GDDM) (array of 80-byte character tokens)
The data record array.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Initialize choice (GINCH)

Description

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

If the inquired information is available, it is returned as output, and errind is returned as 0 (zero). If the inquired information is not available, all output is invalid, and errind returns an error indicator.

The parameter mldr reserves space for the data record returned by the inquiry. If you do not specify sufficient length to accommodate the data record, GKS reports error 2001 in errind.

GDDM-GKS Restrictions

GDDM-GKS ignores the mldr parameter; the data record returned is empty.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
22: Specified workstation type is invalid
23: Specified workstation type does not exist
38: Specified workstation is neither of category INPUT nor of category OUTIN
140: Specified input device is not present on workstation
2001: Output parameter size insufficient
2002: List element or set member not available

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