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


GGTSTS

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



Purpose



 GGTSTS  (mstr, lostr, str)
   
 APL code  1401
 GKS RCP code  X'38006400' (939549696)
   


Function: To get string.

Input function. Returns a character string. If your program is written in FORTRAN IV or VS FORTRAN, use the function Get string (FORTRAN only) (GGTST) instead. (See the section "GDDM-GKS restrictions" below.)

Parameters


mstr (specified by user) (fullword integer)
The maximum number of characters in str.

lostr (returned by GDDM) (fullword integer)
The number of characters returned.

str (returned by GDDM) (character)
The string.


Operating states


WSOP, WSAC, SGOP

Related functions


Initialize string (GINSTS), Request string (GRQSTS), Set string mode (GSSTM)

Description


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

This function returns the string 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