Name

POPWK − Uses a connection identifier to associate a workstation identifier with a generic workstation type. 

Operating States: PHOP, ∗, ∗, ∗
PHIGS standard function

Syntax

POPWK (WKID, CONID, WTYPE)

Argument     Data Type      Access     Description
---------------------------------------------------------------------------
WKID         Integer        Read       Workstation identifier
CONID        Integer        Read       Connection identifier
WTYPE        Integer        Read       Workstation type
-------------------------------------------------------------------------

Description

POPWK uses a connection identifier (a logical name or environment variable, PHIGS constant value, or file specification) to associate a workstation identifier with a generic workstation type.  The function creates a specific workstation description table and a state list for the opened workstation. 

This function causes Digital PHIGS to perform the following actions:

•Sets the workstation state to WSOP. 

•Creates a workstation description table for the open workstation type; Digital PHIGS derives specific data for this new table from the generic data provided by the device.  Digital PHIGS replaces the generic workstation type in the workstation state list with the new specified workstation type. 

•Establishes the specified connection for the specified workstation through a request to the operating system.  The workstation is characterized in the workstation description table by the specified workstation type. 

•Allocates and initializes the workstation state list, where Digital PHIGS maintains the current state of each open workstation. 

•Adds the specified workstation identifier to the set of open workstations in the PHIGS state list. 

Digital PHIGS maintains one generic workstation description table for each workstation type available in the system.  Multiple workstation identifiers can belong to a workstation type.  The system maintains one workstation state list and a specific workstation description table for each open workstation. 

You can use inquiry functions in the application program to return information about generic capabilities prior to opening a workstation.  You can also use inquiry functions to return information about specific capabilities while a workstation is open by first inquiring about the workstation type.  You then use that type as an argument to the inquiry functions that query the workstation description table. 

Until the workstation is explicitly closed with the PCLWK function, the application program can reference the workstation by the workstation identifier specified in the POPWK function. 

The CONID argument is either the unit number of the device, or DDCNID if you want Digital PHIGS to use the predefined value of PHIGS$CONID (OpenVMS) or PHIGSconid (ULTRIX or Digital UNIX).  The WTYPE argument is the workstation type.  If it is DDWSTY, Digital PHIGS uses the predefined value of PHIGS$WSTYPE (OpenVMS) or PHIGSwstype (ULTRIX or Digital UNIX). 

See Also

PCLWK
PQEWK
PQOPWK
PQWKC
PQWKST
POPHH