GRQLC

GDDM-GKS V1R1 Programming Guide and Reference

GRQLC

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

Purpose


GRQLC	(wkid, lcdnr, stat, tnr, px, py)

APL code	1377
GKS RCP code	X'38005100' (939544832)

Function: To request locator.

Input function. Obtains request mode input from a locator input device at a workstation.

Parameters

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

lcdnr (specified by user) (fullword integer)
The locator device number.

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

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

tnr (returned by GDDM) (fullword integer)
The normalization transformation number.

px (returned by GDDM) (short floating point)

py (returned by GDDM) (short floating point)
The locator position in world coordinates.

Operating states

WSOP, WSAC, SGOP

Related functions

Initialize locator (GINLC), Set locator mode (GSLCM).

Description

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

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

The measure of a locator device consists of a locator position in world coordinates and the normalization transformation number that was used in the conversion to world coordinates.

The normalization transformation is the one with the highest viewport input priority whose window contains the locator position.

If the operation invokes the break facility, the status is returned as none. The locator position entered by the operator must be within the workstation viewport.

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