GOPWK

GDDM-GKS V1R1 Programming Guide and Reference

GOPWK

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

Purpose


GOPWK	(wkid, conid, wtype)

APL code	1302
GKS RCP code	X'38000200' (939524608)

Function: To open workstation.

Control function. Opens a workstation.

Parameters

wkid (specified by user) (fullword integer)
A unique identifier that you assign to the workstation. Use this identifier on subsequent function calls that require a workstation identifier.

conid (specified by user) (fullword integer)
An integer in the range 0 through 9999 indicating the device to be opened. A unique connection identifier must be given for each graphics device opened.

The value given is interpreted according to the specified workstation type as follows:

Default workstation

If the workstation type parameter is 1, any valid connection identifier can be given. The default workstation, normally the user console, is opened.

WISS

If the workstation type parameter is 2 (WISS), the connection identifier is ignored.

Metafile input/output

For MO and MI workstations (workstation types 3 and 4), the value given identifies the file to be used.

GDF file output

For GDF file workstations (workstation type 5), the value given identifies the file to be used.

Other GDDM

devices If the workstation type parameter is in the range 6 through 13, GDDM-GKS searches for the entry GKWSnnnn in the nicknames defined for the user, where nnnn is the value specified by conid.

wtype (specified by user) (fullword integer)
An integer in the range 1 through 13 indicating the type of the workstation to be opened. The possible values are:

1

The default workstation (normally the user console)

2

WISS

3

Metafile output workstation

4

Metafile input workstation

5

GDF file workstation

6-13

Other supported graphics devices

The workstation types available are those that have been specified using the external default GKSWS.

Operating states

GKOP, WSOP, WSAC, SGOP

Related functions

Close workstation (GCLWK), Activate workstation (GACWK)

Description

This function opens a specified workstation by establishing a connection to the device, and by allocating and initializing a workstation state list for it. The workstation identifier is added to the list of open workstations held in the GKS state list. If GKS is in operating state GKOP, it is set into the state WSOP (at least one workstation open).

The workstation type and connection identifier (wkid and conid) determine which logical device will be used. See "Using GDDM-GKS workstations" in topic 4.6 for a detailed description of workstation types and the processing of the conid parameter.

The workstation identifier is subsequently used in other functions to refer to the workstation.

GKS allows a maximum of five open workstations at any time; only one WISS (workstation independent segment storage) can be open.

Principal errors

8: GKS not in proper state: GKS shall be in one of the states GKOP, WSOP, WSAC, or SGOP
20: Specified workstation identifier is invalid
21: Specified connection identifier is invalid
22: Specified workstation type is invalid
23: Specified workstation type does not exist
24: Specified workstation is open
26: Specified workstation cannot be opened
28: Workstation Independent Segment Storage is already open
42: Maximum number of simultaneously open workstations would be exceeded.

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