GQWKT

GDDM-GKS V1R1 Programming Guide and Reference

GQWKT

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

Purpose


GQWKT	(wkid, errind, tus, rwindo, cwindo, rviewp, cviewp)

APL code	1483
GKS RCP code	X'3800B900' (939571456)

Function: To inquire workstation transformation.

Inquiry function. Returns workstation transformation values for a workstation, from the workstation state list.

Parameters

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

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

tus (returned by GDDM) (fullword integer)
The workstation transformation update state. The possible values are:

0 (GNPEND): Not pending
1 (GPEND): Pending

rwindo (returned by GDDM) (array of short floating-point numbers)
The requested workstation window in normalized device coordinates (XMIN, XMAX, YMIN, YMAX).

cwindo (returned by GDDM) (array of short floating-point numbers)
The current workstation window in normalized device coordinates (XMIN, XMAX, YMIN, YMAX).

rviewp (returned by GDDM) (array of short floating-point numbers)
The requested workstation window in device coordinates (XMIN, XMAX, YMIN, YMAX).

cviewp (returned by GDDM) (array of short floating-point numbers)
The current workstation viewport in device coordinates (XMIN, XMAX, YMIN, YMAX).

Operating states

WSOP, WSAC, SGOP

Related functions

Set workstation window (GSWKWN), Set workstation viewport (GSWKVP)

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.

If the workstation transformation update state is pending, a workstation transformation change has been requested but not yet performed.

The values for requested and current windows or viewports are different only if the update state is pending.

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
33: Specified workstation is of category MI
36: Specified workstation is Workstation Independent Segment Storage

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