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


GGTST

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



Purpose



 GGTST  (lostr, str)
   


Function: Input function. Returns a character string. Use this call only if your program is written in FORTRAN IV or VS FORTRAN. Otherwise, use the function Get string (GGTSTS) instead. (See the section "GDDM-GKS restrictions" below.)

Parameters


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

str (returned by GDDM) (character)
The string. In a VS FORTRAN program, the string can be of variable length. For FORTRAN IV, you must define the string as CHARACTER*80.


Operating states


WSOP, WSAC, SGOP

Related functions


Initialize string (FORTRAN only) (GINST), Request string (FORTRAN only) (GRQST), 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