GQDLC

GDDM-GKS V1R1 Programming Guide and Reference

GQDLC

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

Purpose


GQDLC	(wtype, devno, n, mldr, errind, dpx, dpy, ol, pet, earea, ldr, datrec)

APL code	1512
GKS RCP code	X'3800D800' (939579392)

Function: To inquire default locator device data.

Inquiry function. Returns the default data for a locator device at a workstation, from the workstation description table.

Parameters

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

devno (specified by user) (fullword integer)
The logical input 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)
Dimension of array datrec.

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

dpx (returned by GDDM) (short floating point)

dpy (returned by GDDM) (short floating point)
Default initial position of locator in world coordinates.

ol (returned by GDDM) (fullword integer)
The number of available prompt and echo types (always 1 in GDDM-GKS).

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 default 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

Unpack data record (GURECS), Initialize locator (GINLC)

Description

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 Unpack data record (GURECS) utility is available to unpack the data record returned by GQDLC.

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. Usually, a maximum length of 80 (mldr=1) is sufficient.

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