GUWK

GDDM-GKS V1R1 Programming Guide and Reference

GUWK

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

Purpose


GUWK	(wkid, regfl)

APL code	1311
GKS RCP code	X'38000800' (939526144)

Function: To update workstation.

Control function. Updates a workstation according to the value of a control flag.

Parameters

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

regfl (specified by user) (fullword integer)
The update regeneration flag. This flag controls the way in which the workstation is updated. The possible values are:

0 (GPOSTP)

Postpone

1 (GPERFO)

Perform

Operating states

WSOP, WSAC, SGOP

Related functions

Set deferral state (GSDS), Inquire workstation deferral and update states (GQWKDU), Inquire dynamic modification of workstation attributes (GQDWKA), Inquire dynamic modification of segment attributes (GQDSGA), Redraw all segments on workstation (GRSGWK).

Description

This function causes all deferred actions for the workstation specified by wkid to be executed. Any blocked data for the workstation is transmitted. If the update regeneration flag regfl is set to perform, and the "new frame action necessary at update" entry in the workstation state list is yes, this function redraws all segments at the workstation in addition to performing the deferred actions.

If regfl is set to perform, and a new frame at update is necessary, this function regenerates the display in the same way as Redraw all segments on workstation (GRSGWK). The following actions are performed:

The display surface is cleared if not empty.
If the "workstation transformation update state" entry in the workstation state list is pending, the pending transformation is set (that is, the current workstation window and viewport are set to the values for the requested workstation window and viewport). The "workstation transformation update state" entry is set to notpending.
All visible segments at the workstation are redisplayed.
The "new frame action necessary at update" entry in the workstation state list is set to no.

A new frame at update would be necessary if implicit regeneration is suppressed and any action requiring implicit regeneration has been performed. The functions requiring implicit regeneration are those that modify workstation or segment attributes.

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
35: Specified workstation is of category INPUT
36: Specified workstation is Workstation Independent Segment Storage
2000: Enumeration type out of range

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