GDDM-GKS V1R1 Programming Guide and Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


GINVL

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



Purpose



  GINVL
                                    
                                    
 (wkid, vldnr, ival, pet, xmin,
 xmax, ymin, ymax, loval, hival,
 ldr, datrec)
   
 APL code  1495
 GKS RCP code  X'38004700' (939542272)
   


Function: To initialize valuator.

Input function. Initializes a valuator input device at a workstation.

Parameters


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

vldnr (specified by user) (fullword integer)
The valuator device number. GDDM-GKS provides only one valuator device at a workstation. The valuator device number is always 1.

ival (specified by user) (short floating point)
The initial value of the valuator device. This value must lie in the range set by the minimum and maximum values, loval and hival.

pet (specified by user) (fullword integer)
The prompt and echo type.

xmin (specified by user) (short floating point)

xmax (specified by user) (short floating point)

ymin (specified by user) (short floating point)

ymax (specified by user) (short floating point)
The echo area in device coordinates.

loval (specified by user) (short floating point)

hival (specified by user) (short floating point)
The minimum and maximum values defining the valuator range. The maximum value, hival, must be greater than the minimum value; loval; otherwise, error 146 is reported.

ldr (specified by user) (fullword integer)
The dimension of the data record array.

datrec (specified by user) (array of 80-byte character tokens)
The valuator data record array.


Operating states


WSOP, WSAC, SGOP

Related functions


Request valuator (GRQVL), Set valuator mode (GSVLM)

Description


This function initializes the valuator device by defining the initial value, prompt and echo type, echo area, and range of values.

GDDM-GKS provides one prompt and echo type:

pet=1
Echo the current valuator value within the echo area.

The initial value is displayed as a string starting in the lower left corner of the echo area. The value can be overtyped by the operator with a number within the range loval through hival.

The data record is not used.

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
51
Rectangle definition is invalid
140
Specified input device is not present on workstation
141
Input device is not in REQUEST mode
144
Specified prompt and echo type is not supported on this workstation
145
Echo area is outside display space
146
Contents of input data record are invalid
152
Initial value is invalid

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012