GRQVL

GDDM-GKS V1R1 Programming Guide and Reference

GRQVL

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

Purpose


GRQVL	(wkid, vldnr, stat, val)

APL code	1379
GKS RCP code	X'38005300' (939545344)

Function: To request valuator.

Input function. Obtains request mode input from a valuator input device at a workstation. (See the section "GDDM-GKS restrictions" below.)

Parameters

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

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

stat (returned by GDDM) (fullword integer)
The status of the device. The possible values are:

0 (GNONE): None
1 (GOK): OK

val (returned by GDDM) (short floating point)
The value returned. This is a real number in the range given by the lower and upper limit specified in the Initialize valuator (GINVL) function.

Operating states

WSOP, WSAC, SGOP

Related functions

Initialize valuator (GINVL), Set valuator mode (GSVLM)

Description

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

This function obtains request mode input from the valuator device associated with workstation wkid. If the operation is successful, status OK is returned together with the logical input value that is the current measure of the valuator device. If the operator invokes the break facility, the status is returned as none. The value delivered is within the range defined by the Initialize valuator (GINVL) function.

You can control the valuator input process by using the functions Initialize valuator (GINVL) and Set valuator mode (GSVLM).

GDDM-GKS Restrictions

This function can report error 304 (I/O error while sending data to a workstation) if the echo area defined, or used by default, for the valuator device overlaps an alphanumeric field created by calls to GDDM Base alphanumeric functions.

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
141: Input device is not in REQUEST mode

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