GCSGWK

GDDM-GKS V1R1 Programming Guide and Reference

GCSGWK

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

Purpose


GCSGWK	(wkid, sgna)

APL code	1363
GKS RCP code	X'38003E00' (939539968)

Function: To copy segment to workstation.

Segment function. Sends segment primitives to the workstation for display after transformation and clipping.

Parameters

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

sgna (specified by user) (fullword integer)
The segment name selected when the segment was created.

Operating states

WSOP, WSAC

Related functions

Create segment (GCRSG), Associate segment with workstation (GASGWK), Open workstation (GOPWK)

Description

This function sends segment primitives from workstation independent segment storage (WISS) to the display surface of workstation wkid. Primitives in the segment sgna are sent after being transformed and clipped with the stored clipping rectangle (the normalization transformation viewport current when each primitive was created).

All primitives keep the values of the primitive attributes assigned to them when they were created.

If the segment sgna is not present in WISS, error 124 is reported. The workstation wkid cannot be the WISS.

This function cannot be invoked when a segment is open. The primitives copied to the workstation are not stored in a segment; they remain only until the workstation is updated or cleared. By contrast, the Associate segment with workstation (GASGWK) function makes the segment a permanent part of the workstation output.

Principal errors

6: GKS not in proper state: GKS shall be either in the state WSOP or in the state WSAC
20: Specified workstation identifier is invalid
25: Specified workstation is not open
27: Workstation Independent Segment Storage 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
120: Specified segment name is invalid
124: Specified segment does not exist on Workstation Independent Segment Storage

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