GQDVL

GDDM-GKS V1R1 Programming Guide and Reference

GQDVL

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

Purpose


GQDVL	(wtype, devno, n, mldr, errind, dval, ol, pet, earea, loval, hival, ldr, datrec)

APL code	1502
GKS RCP code	X'3800DA00' (939579904)

Function: To inquire default valuator device data.

Inquiry function. Returns the default data for a valuator device at a workstation, from the workstation device 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 logical input device number (1 ... n).

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 array datrec.

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

dval (returned by GDDM) (short floating point)
The default initial value.

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).

loval (returned by GDDM) (short floating point)

hival (returned by GDDM) (short floating point)
The minimal and maximal values of the valuator.

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 valuator (GINVL)

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. If the list element requested is out of range, the closest values in range are returned.

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