GRQSTS

GDDM-GKS V1R1 Programming Guide and Reference

GRQSTS

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

Purpose


GRQSTS	(wkid, stdnr, mstr, stat, lostr, str)

APL code	1382
GKS RCP code	X'38005600' (939546112)

Function: To request string.

Input function. Obtains request mode input from a string input device at a workstation. If your program is written in FORTRAN IV or VS FORTRAN, use the function Request string (FORTRAN only) (GRQST) 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.

mstr (specified by user) (fullword integer)
The maximum string length. This is the maximum number of characters that can be returned in str.

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

0 (GNONE): None
1 (GOK): OK

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

str (returned by GDDM) (character)
The character string. This string consists of the characters entered by the application user starting at the initial cursor position. The length of the string entered must be less than or equal to the input buffer size, which is defined in the Initialize string (GINSTS) function call.

Operating states

WSOP, WSAC, SGOP

Related functions

Initialize string (GINSTS), 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