GDDM-GKS V1R1 Programming Guide and Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


GDSG

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



Purpose



 GDSG  (sgna)
   
 APL code  1360
 GKS RCP code  X'38003B00' (939539200)
   


Function: To delete segment.

Segment function. Deletes a segment from all workstations.

Parameters


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


Operating states


WSOP, WSAC, SGOP

Related functions


Create segment (GCRSG), Delete segment from workstation (GDSGWK), Set deferral state (GSDS)

Description


This function deletes the segment from all workstations. The segment name may then be reused by the application program.

The following actions are taken:

  • The segment name is removed from the list of segments at each workstation that contains it.
  • The segment name is deleted from the list of segment names in use in the GKS state list.
  • The segment state list for the segment is deleted.
    
    
Whether the segment is immediately deleted from the display of a workstation, or deletion is deferred, depends on the implicit regeneration mode for the workstation; this can be set using the function Set deferral state (GSDS).

Principal errors


7
GKS not in proper state: GKS shall be in one of the states WSOP, WSAC, or SGOP
120
Specified segment name is invalid
122
Specified segment does not exist
125
Specified segment is open

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012