GSMST

GDDM-GKS V1R1 Programming Guide and Reference

GSMST

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

Purpose


GSMST	(wkid,stdnr,lostr,str)

Function: Input function. Obtains sample mode input from a string input device at a workstation. Use this call only if your program is written in FORTRAN IV or VS FORTRAN. Otherwise, use the function Sample string (GSMSTS) instead. (See the section "GDDM-GKS restrictions" below.)

Parameters

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

stdnr (specified by user) (fullword integer)
The string device number.

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

Set string mode (GSSTM)

Description

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

This function obtains sample mode input from the string device associated with workstation wkid.

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
       20  Specified workstation identifier is invalid
       25  Specified workstation is not open
       38  Specified workstation is neither of category INPUT nor of
           category OUTIN
      140  Specified input device is not present on workstation
      142  Input device is not in SAMPLE mode
      143  EVENT and SAMPLE input mode are not available at this level
           of GKS

Notices | Terms of use | Support | Contact z/OS