[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPOPST - Open Structure

GPOPST (strid)

Purpose

Use GPOPST to open a structure. The structure state is set to Structure Open (STOP)

When the application opens a structure, the graPHIGS API sets the elment pointer to the last element of the currently specified structure. If the specified structure does not exist in the currently selected structure store, then the graPHIGS API creates an empty structure and sets the element pointer to zero.

The currently selected structure store is locked to structure manipulation requests generated by other application processes, and the graPHIGS API considers the application process that opened the structure as the owning application process. The graPHIGS API postpones the requests from the other application processes until the open structure is closed (at which time the owning application process relinquishes its lock on the structure store and the structure store becomes available for structure requests by other application processes) This ownership of the structure store ensures that other application processes cannot interfere with the structure requests of the owning application process until it closes the structure.

Parameters

strid -- specified by user, fullword integer

Structure identifier.

Error Codes

11
FUNCTION REQUIRES STATE STCL

Related Subroutines

GPCLST
Close Structure

RCP code

201331457 (X'0C001301')


[ Previous | Next | Contents | Glossary | Home | Search ]