CLOSE WORKSTATION(3P) — SUNPHIGS LIBRARY

NAME

CLOSE WORKSTATION − close specified workstation

SYNOPSIS

C Syntax

void
pclosews ( ws )
Pintws;workstation identifier

FORTRAN Syntax

SUBROUTINE pclwk ( WKID )
INTEGERWKIDworkstation identifier

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

The CLOSE WORKSTATION function closes the specified workstation and releases all resources used by it.

C Input Parameter

wsThe identifier of the workstation to close.

FORTRAN Input Parameter

WKIDThe identifier of the workstation to close.

Execution

The CLOSE WORKSTATION function 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 flushed 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. • CGM output workstations write the END METAFILE element to the CGM file. • 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 on 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