GSSTM

GDDM-GKS V1R1 Programming Guide and Reference

GSSTM

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

Purpose


GSSTM	(wkid, stdnr, mode, esw)

APL code	1376
GKS RCP code	X'38005000' (939544576)

Function: To set string mode.

Input function. Sets the operating mode and echo switch for a string device at a workstation. (See the section "GDDM-GKS restrictions" below.)

Parameters

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

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

mode (specified by user) (fullword integer)
The operating mode. The possible values are:

0 (GREQU): Request
1 (GSAMPL): Sample
2 (GEVENT): Event

esw (specified by user) (fullword integer)
The echo switch. The possible values are:

0 (GNECHO)

No Echo

1 (GECHO)

Echo

Operating states

WSOP, WSAC, SGOP

Related functions

Initialize string (GINSTS), Request string (GRQSTS)

Description

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

This function sets the operating mode and echo switch for the string input device stdnr at workstation wkid.

The echo switch determines whether or not an echo will be visible for the string device. The default values for all string devices is echo. The echo switch only controls whether the echo is on or off. Prompting is not affected.

GDDM-GKS Restrictions

Event and sample modes are not supported at GKS level 2b. If one of these modes is selected, 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
143: EVENT and SAMPLE input mode are not available at this level of GKS
2000: Enumeration type out of range

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