Segment functions

GDDM-GKS V1R1 Programming Guide and Reference

Segment functions

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




   When primitives are grouped together in a segment, you can perform
   operations on them as a single object.  You form a segment by calling the
   Create segment (GCRSG) function, and then the output functions to create
   the primitives for the segment.  The Close segment (GCLSG) function is
   called to define the end of the current segment.

The segment function Create segment (GCRSG) sets the system to the operating state SGOP. Only one segment can be open at a time. A segment state list is initialized with default values for the current segment. Each existing segment has a segment state list associated with it until the segment is deleted from all existing workstations. You assign to each segment a unique identifier. All subsequent output primitives are collected into the named segment until the next Close segment (GCLSG) call is made.

When you create a segment, it is automatically stored at all workstations that are active. If you activate a workstation independent segment storage (WISS), you can copy any segment from WISS to any other workstation that is activated after the segment is created.

There are three segment functions that require the presence of an open WISS. You can choose between two of them to display a segment on a workstation that was not active when the segment was created. Associate segment with workstation (GASGWK) stores a segment on a workstation as though it had been active at segment creation. Copy segment to workstation (GCSGWK) displays the primitives in a segment on a workstation, but does not store the segment on the workstation state list. The third function, Insert segment (GINSG), adds the contents of a segment stored in WISS to the current open segment, or into the stream of primitives outside segments if no segment is open.

You can delete a segment from GKS with Delete segment (GDSG), or you can delete it from a specified workstation with Delete segment from workstation (GDSGWK).

Subtopics:

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