GSDS

GDDM-GKS V1R1 Programming Guide and Reference

GSDS

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

Purpose


GSDS	(wkid, defmod, regmod)

APL code	1312
GKS RCP code	X'38000900' (939526400)

Function: To set deferral state.

Control function. Sets the deferral mode and regeneration mode for a workstation.

Parameters

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

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

0 (GASAP): As soon as possible
1 (GBNIG): Before the next interaction globally
2 (GBNIL): Before the next interaction locally
3 (GASTI): At some time

regmod (specified by user) (fullword integer)
The implicit regeneration mode. The possible values are:

0 (GSUPPD)

Suppressed

1 (GALLOW)

Allowed

Operating states

WSOP, WSAC, SGOP

Related functions

Update workstation (GUWK), Redraw all segments on workstation (GRSGWK), Inquire default deferral state values (GQDDS), Inquire dynamic modification of workstation attributes (GQDWKA), Inquire dynamic modification of segment attributes (GQDSGA), Inquire workstation deferral and update states (GQWKDU)

Description

This function sets the values given by defmod and regmod in the workstation state list of the workstation specified by wkid. Depending on the new value for deferral mode, deferred output at the workstation may be unblocked. If the new value for implicit regeneration mode is allowed and a new frame action is required at the workstation, the display is regenerated as in the function Redraw all segments on workstation (GRSGWK).

The deferral mode controls the time at which output functions have a visual effect at a workstation. You can set the deferral mode to GASAP or GBNIG to ensure that the display is updated before the operator responds to a request for input data by using a logical input device at any workstation. GBNIL is used to ensure that the display is updated before the operator responds to a request for input data from a device at the workstation wkid. Use GASTI if the display need not be updated before operator interactions. The deferral mode GASAP can be used to ensure that the visual effect occurs as soon as possible, but this is workstation-dependent.

The implicit regeneration mode controls the time at which functions requiring an implicit regeneration have their visual effect. If the implicit regeneration mode is suppressed and a function requiring implicit regeneration at the workstation is invoked, the "new frame necessary at update" entry in the workstation state list is set to yes. The display is not regenerated until you explicitly update the display using Update workstation (GUWK) or Redraw all segments on workstation (GRSGWK), or change the implicit regeneration mode to allowed.

If the implicit regeneration mode is allowed and an implicit regeneration is required, then it is performed immediately. An implicit regeneration is equivalent to an invocation of Redraw all segments on workstation (GRSGWK).

For example, color changes made by Set color representation (GSCR) can be controlled by this parameter. If the implicit regeneration mode is suppressed, a new frame will be redrawn only when an explicit function call to Redraw all segments on workstation (GRSGWK) or Update workstation (GUWK) is issued. However, when the implicit regeneration mode is allowed, the workstation will be immediately updated.

For each workstation type, the workstation description table indicates which changes lead to an implicit regeneration and which can be performed immediately. You can use the functions Inquire dynamic modification of workstation attributes (GQDWKA) and Inquire dynamic modification of segment attributes (GQDSGA) to determine dynamic modification capabilities. The following functions can cause an implicit regeneration to be required:

Set polyline representation (GSPLR)
Set polymarker representation (GSPMR)
Set text representation (GSTXR)
Set fill area representation (GSFAR)
Set pattern representation (GSPAR)
Set color representation (GSCR)
Set workstation window (GSWKWN)
Set workstation viewport (GSWKVP)
Set segment transformation (GSSGT)
Set visibility (GSVIS)
Set highlighting (GSHLIT)
Delete segment (GDSG)
Delete segment from workstation (GDSGWK)
Interpret item (GIITM)

In addition, an implicit regeneration may be required when adding primitives to an open segment overlapping a segment of higher priority, using the output primitive functions or Insert segment (GINSG), or if segment priorities affect the execution of the functions Associate segment with workstation (GASGWK) and Set segment priority (GSSGP).

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