GQVLS

GDDM-GKS V1R1 Programming Guide and Reference

GQVLS

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

Purpose


GQVLS	(wkid, vldnr, mldr, errind, mode, esw, ival, pet, earea, loval, hival, ldr, datrec)

APL code	1486
GKS RCP code	X'3800BD00' (939572480)

Function: To inquire valuator device state.

Inquiry function. Returns values giving the state of a valuator device at a workstation, from the workstation state list.

Parameters

wkid (specified by user) (fullword integer)
The workstation identifier.

vldnr (specified by user) (fullword integer)
The valuator device number (1 ... n).

mldr (specified by user) (fullword integer)
The dimensions of the data record array.

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

mode (returned by GDDM) (fullword integer)
The operating mode. The only possible value is:

0 (GREQU): Request

esw (returned by GDDM) (fullword integer)
The echo switch. The possible values are:

0 (GNECHO): No echo
1 (GECHO): Echo

ival (returned by GDDM) (short floating point)
The initial value of the device.

pet (returned by GDDM) (fullword integer)
The prompt and echo type (1 ... n).

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

loval (returned by GDDM) (short floating point)
The minimum valuator value.

hival (returned by GDDM) (short floating point)
The maximum valuator value.

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

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

Operating states

WSOP, WSAC, SGOP

Related functions

Unpack data record (GURECS), Initialize valuator (GINVL)

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.

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

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