CLOSE WORKSTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

CLOSE WORKSTATION − close a workstation

SYNOPSIS

C Syntax

void
pclose_ws ( ws_id )
Pintws_id;workstation identifier

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

CLOSE WORKSTATION closes the specified workstation and releases all resources it uses.

C Input Parameter

ws_idThe identifier of the workstation to close.

Execution

CLOSE WORKSTATION performs the following functions:

• An implicit UPDATE WORKSTATION is performed on the specified workstation, with the regeneration flag set to PERFORM

• The workstation state list is released

• The workstation identifier is deleted from the set of open workstations in the PHIGS state list

• The workstation identifier is deleted from the list of workstations to which structures are posted in the structure state list

• Any events in the input queue from devices on this workstation are removed from the queue

• The specific workstation description table for this workstation, created when the workstation was opened, becomes unavailable and the workstation type value associated with it becomes undefined

• The connection to this workstation is released

• If no other workstations are open, the PHIGS workstation operating state is set to WSCL

If an input queue overflow has been caused by a logical input device associated the workstation being closed, the error state list entry, identification of one of the logical input devices that caused an input queue overflow, will become undefined when the workstation is closed.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

256Warning, the input queue has overflowed

Museum