Inquiry functions

GDDM-GKS V1R1 Programming Guide and Reference

Inquiry functions

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




   GKS provides many inquiry functions that return information to your
   application programs about the current state of the system.  Inquiry
   functions return information about:

Primitives and segments
Normalization and workstation transformations
GKS operating levels
Workstation capabilities
Workstation types
Pick identifiers
Input device states
Default data for input devices.

The Inquiry functions return values derived from the state lists and description tables established by GKS (see Appendix A, "GKS data structures" in topic A.0 for more information).

A normal return is indicated by a zero in the error indicator output parameter; if the data requested is unavailable, the parameter contains a GKS error number.

The inquiry functions are useful if you need specific information about the system and its workstations. In this example, an inquiry function returns data needed to set the workstation viewport to be the lower left quadrant of the display surface.


          INQUIRE DISPLAY SPACE SIZE (wktype, error,
               dcunits, xdevice, ydevice, xraster, yraster)
          SET WORKSTATION VIEWPORT (wkid, 0.0, xdevice/2.0,
               0.0, ydevice/2.0)

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