GOPKS

GDDM-GKS V1R1 Programming Guide and Reference

GOPKS

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

Purpose


GOPKS	(errfil, bufa)

APL code	1300
GKS RCP code	X'38000000' (939524096)

Function: To open GKS.

Control function. Opens GKS, and opens an error file for GKS error messages.

Parameters

errfil (specified by user) (fullword integer)
The error message file. This parameter is an integer in the range 1 through 9999 and identifies the destination of error messages output when the Error logging (GERLOG) function is called.

bufa (specified by user) (fullword integer)
Number of memory units for buffer area. Not used in GDDM-GKS; it should be set to 0.

Operating states

GKCL

Related functions

Close GKS (GCLKS), Emergency close GKS (GECLKS)

Description

This function opens and initializes GKS. The GKS state list is allocated and initialized. The GKS description table and the workstation description tables are made available.

The "error file" entry in the GKS error state list is set to the value specified by errfil and the error file is opened. The name and characteristics of the error file opened are subsystem dependent. On VM/CMS, the file ADMJnnnn ADMERLOG is created (nnnn represents the value supplied in errfil. On other subsystems, an appropriate equivalent file is created, as described in "Using GDDM-GKS under various subsystems" in topic 4.9.

This call sets the GKS operating state to GKOP. It should be the first GKS function invoked by your application.

Principal errors

1: GKS not in proper state: GKS shall be in the state GKCL
200: Specified error file is invalid

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