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


GCLWK

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00
Purpose
 GCLWK  (wkid)
   
 APL code  1303
 GKS RCP code  X'38000300' (939524864)
   
Function: To close workstation.
Control function. Disengages a workstation from GKS.
Parameters

wkid (specified by user) (fullword integer)
The identifier selected when the workstation was opened.
Operating states
WSOP, WSAC, SGOP
Related functions
Open workstation (GOPWK), Close GKS (GCLKS), Deactivate workstation (GDAWK), Update workstation (GUWK)
Description
This function performs an implicit Update workstation (GUWK) (with the update regeneration flag parameter set to perform) and then closes the workstation, by taking the following actions:
  1. The workstation state list is released.
  2. The workstation identifier is deleted from the list of open workstations in the GKS state list.
  3. The workstation identifier is deleted from the list of associated workstations in the segment state list of each segment at the workstation. If this is the last workstation associated with the segment, the segment is deleted.
  4. The connection to the workstation is released. The display surface of the workstation is not cleared explicitly, but if it is the user console, it can be cleared when functions causing output to the console (for example the Message (GMSGS) function) are called, or when GKS is closed.
If no other workstation is open, this function sets the GKS operating state to GKOP.
Note that, if one of the errors listed below is reported, the workstation is not closed. However, other errors, outside the control of GDDM-GKS, may be detected, while allowing the function to complete; for example, error 304 can be reported if GDDM-GKS cannot access the device because your program has closed it using a GDDM DSCLS call.
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
29
Specified workstation is active

Go to the previous page Go to the next page
Notices | Terms of use | Support | Contact z/OS



Copyright IBM Corporation 1990, 2012