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

GPSSS - Select Structure Store

GPSSS (ssid)

Purpose

Use GPSSS to select a structure store. A structure store must be attached using the Create Structure Store (GPCRSS) subroutine or the Attach Resource (GPATR) subroutine before your application can call this structure element. The selected structure store becomes the target of all subsequent structure manipulation/editing subroutines until your application issues another call to GPSSS

If a structure is currently open when a structure store is selected, then the graPHIGS API closes the structure. The specified structure store becomes the selected structure store and the structure state is set to Structure Closed (STCL)

Note: Creating a structure store or attaching a structure store does not automatically select the structure store for editing. If you did not suppress default connection processing during Open graPHIGS (GPOPPH), then this subroutine is automatically invoked as part of the GPOPPH processing. See GPOPPH for more information.

Parameters

ssid -- specified by user, fullword integer

Structure store identifier.

Error Codes

13
FUNCTION REQUIRES STATE SSOP
222
SPECIFIED STRUCTURE STORE DOES NOT EXIST

Related Subroutines

GPASSW
Associate Structure Store with Workstation
GPATR
Attach Resource
GPCRSS
Create Structure Store
GPOPPH
Open graPHIGS

RCP code

201331459 (X'0C001303')


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