GSMLC

GDDM-GKS V1R1 Programming Guide and Reference

GSMLC

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

Purpose


GSMLC	(wkid, lcdnr, tnr, lpx, lpy)

APL code	1510
GKS RCP code	X'38005700' (939546368)

Function: To sample locator.

Input function. Obtains sample mode input from a locator input device at a workstation. (See the section "GDDM-GKS restrictions" below.)

Parameters

wkid (specified by user) (fullword integer)
The identifier selected when the workstation was opened.

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

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

lpx (returned by GDDM) (short floating point)

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

Operating states

WSOP, WSAC, SGOP

Related functions

Set locator mode (GSLCM)

Description

(See the section "GDDM-GKS restrictions" below.)

This function obtains sample mode input from the locator device associated with workstation wkid. The logical input value, which is the current measure of the locator device, is returned.

GDDM-GKS Restrictions

GKS does not support this function at level 2b. If this function is invoked, GDDM-GKS reports error 143.

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
142: Input device is not in SAMPLE mode
143: EVENT and SAMPLE input mode are not available at this level of GKS

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