GRQST

GDDM-GKS V1R1 Programming Guide and Reference

GRQST

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

Purpose


GRQST	(wkid,stdnr,stat,lostr,str)

Function: Input function. Obtains request 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 Request string (GRQSTS) 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. GDDM-GKS provides only one string device at a workstation. The string device number is always 1.

stat (returned by GDDM) (fullword integer)
The device status. The possible values are:

0 (GNONE)

None

1 (GOK)

lostr (returned by GDDM) (fullword integer)
The length of the returned string.

str (returned by GDDM) (character)
The character string. In a VS FORTRAN program, the string can be of variable length. For FORTRAN IV, you must define the string as CHARACTER*80. This string consists of the characters entered by the application user. The length of the string entered must be less than or equal to the input buffer size, which is defined in the Initialize String function call.

Operating states

WSOP, WSAC, SGOP

Related functions

Initialize string (FORTRAN only) (GINST), Set string mode (GSSTM)

Description

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

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

If the operation is successful, status OK is returned together with the logical input value that is the current measure of the string device.

If the operator invokes the break facility, the status is returned as none.

GDDM-GKS restrictions

This function can report error 304 (I/O error occurred while sending data to a workstation) if the echo area defined, or used by default, for the string device overlaps an alphanumeric field created by calls to GDDM Base alphanumeric functions.

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
      141  Input device is not in REQUEST mode

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