Purpose
|
|
GINCH
|
(wkid, chdnr, istat, ichnr, pet,
xmin, xmax, ymin, ymax, ldr,
datrec) |
| |
|
| APL code |
1496 |
| GKS RCP code |
X'38004800' (939542528) |
| |
|
Function: To initialize choice.
Input function. Initializes a choice input device at a workstation.
Parameters
wkid (specified by user) (fullword integer)
The workstation identifier.
chdnr (specified by user) (fullword integer)
The choice device number. The possible values are:
- 1
- The Enter key
- 2
- The PF keys
- 3
- The alphanumeric light pen
- 4
- The data keys
- 5
- The mouse or tablet buttons
istat (specified by user) (fullword integer)
The initial status. The possible values are:
- 1 (GOK)
- OK
- 2 (GNCHOI)
- No choice
ichnr (specified by user) (fullword integer)
The initial choice number. If istat is GOK, this parameter must be
between 1 and the maximum number of choice alternatives (held in the
workstation description table) for the device.
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.
ldr (specified by user) (fullword integer)
The dimension of the data record array datrec.
datrec (specified by user) (array of 80-byte character tokens)
The data record array.
Operating states
WSOP, WSAC, SGOP
Related functions
Request choice (GRQCH), Set choice mode (GSCHM), Inquire number of
available logical input devices (GQLI), Inquire default choice device data
(GQDCH)
Description
This function initializes the choice device by defining the initial
status, initial choice number, prompt and echo type, echo area, and choice
data record. These are stored in the workstation state list entry for the
specified choice device.
GDDM-GKS provides one prompt and echo type:
- pet=1
- If wkid is an IBM 5080 Graphics System equipped with lighted PF
keys, the keys are lit. For PF keys on other workstations, and for
mouse and tablet devices, no prompt is displayed.
No choice echo is displayed; the echo area and choice data record are
not used.
Not all choice devices are available at all workstations. You can use the
function Inquire number of available logical input devices (GQLI) to
determine which devices are available at a particular workstation. You
can use the function Inquire default choice device data (GQDCH) to obtain
the maximum number of choice alternatives for a particular choice device.
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
- 2000
- Enumeration type out of range
|
GDDM-GKS V1R1 Programming Guide and Reference
Copyright IBM Corporation 1990, 2012