OPEN WORKSTATION (PHOP,*,*,*)

Purpose

Use Open Workstation to open and initialize a specified workstation. This subroutine function sets the workstation state value to Workstation Open (WSOP). The graPHIGS API requests the operating system to establish the specified connection. This subroutine function allocates and initializes the Workstation State List (WSL) according to the Workstation Descriptor Table (WDT) for the specified type. The workstation is associated with the specified identifier. Open Workstation adds this specified identifer to the set of open workstaions in the graPHIGS API state list.

The graPHIGS API External Defaults File (EDF) allows the application to denote, indirectly, the actual values of both the workstation type and the connection identifier. For more information, see The graPHIGS Programming Interface: Technical Reference, "Defaults and Nichnames," for contents and formats of the External Defaults File (EDF).

Language Bindings

C

Input Parameters

Pint    ws_id

Workstation indentifier.

const void   *conn_id

Connection identifier indicates the physical device to be opened. See The graPHIGS Programming Interface: Technical Reference for vaild connection identifiers. The connection identifier is a pointer to a character string.

Pint    ws_type

One of the graPHIGS API supported workstation types (1=6090, 2=5080, 3=GDDM, 4=GDF, 5=CGM, 6=X, 8=XSOFT, 9=XPEX, 10=IMAGE). See The graPHIGS Programming Interface; Technical Reference, for explanations of these workstation types.

FORTRAN

For example, the connection identifier of '*' is attained if the EDF contains the line:

AFMMNICK CONNID=99, TOCONNID=*

WSID=1
CONID=99
WTYPE=6
POPWK=(WKID, CONID, WTYPE)