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


GGTCH

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



Purpose



 GGTCH  (stat, chnr)
   
 APL code  1398
 GKS RCP code  X'38006200' (939549184)
   


Function: To get choice.

Input function. Returns a choice number. (See the section "GDDM-GKS restrictions" below.)

Parameters


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

0 (GOK)
OK
0 (GNCHOI)
No choice

The status indicates whether or not the choice number obtained from the operator is valid.

chnr (returned by GDDM) (fullword integer)
The choice number. The choice number is an integer that represents one of a number of choices available on a choice device.


Operating states


WSOP, WSAC, SGOP

Related functions


Initialize choice (GINCH), Request choice (GRQCH), Set choice mode (GSCHM)

Description


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

This function returns the choice logical input value in the current event report.

GDDM-GKS Restrictions

GKS does not support this function at level 2b. If this function is invoked, GDDM-GKS reports error 143.

Principal errors


7
GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
143
EVENT and SAMPLE input mode are not available at this level of GKS
150
No input value of the correct class is in the current event report

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012