GQSTS

GDDM-GKS V1R1 Programming Guide and Reference

GQSTS

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

Purpose


GQSTS	(wkid,stdnr,mldr,errind,mode,esw, lostr,istr,pet,earea, buflen,inipos,ldr,datrec)

Function: Inquiry function. Returns values giving the state of a string device at a workstation, from the workstation state list. Use this call only if your program is written in FORTRAN IV or VS FORTRAN. Otherwise, use the function Inquire string device state (GQSTSS) instead.

Parameters

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

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

mldr (specified by user) (fullword integer)
The dimension of the data record array datrec.

errind (returned by GDDM) (fullword integer)
The error indicator.

mode (returned by GDDM) (fullword integer)
The operating mode. The only possible value is:

0 (GREQU)

Request

esw (returned by GDDM) (fullword integer)
The echo switch. The possible values are:

0 (GNECHO)

No echo

1 (GECHO)

Echo

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

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

pet (returned by GDDM) (fullword integer)
The prompt and echo type (1 ... n).

earea (returned by GDDM) (array of short floating-point numbers)
The echo area in device coordinates (XMIN, XMAX, YMIN, YMAX).

buflen (returned by GDDM) (fullword integer)
The input buffer size.

inipos (returned by GDDM) (fullword integer)
The initial cursor position.

ldr (returned by GDDM) (fullword integer)
The number of array elements used in the data record array datrec.

datrec (returned by GDDM) (array of 80-byte character tokens)
The data record array.

Operating states

WSOP, WSAC, SGOP

Related functions

Unpack data record (FORTRAN only) (GUREC), Initialize string (FORTRAN only) (GINST)

Description

If the inquired information is available, it is returned as output, and errind is returned as 0 (zero). If the inquired information is not available, all output is invalid, and errind returns an error indicator.

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
     2001  Output parameter size insufficient

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