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

GPCRSS - Create Structure Store

GPCRSS (ssid, ncid, sstype, ssdesc)

Purpose

Use GPCRSS to create a structure store and attach it to your application.

If the current structure state is Structure Store Close (SSCL), it is set to Structure Store Open (SSOP)

A structure store is required if your application is to display graphical data on a workstation using output primitives and their attributes.

Before any editing of a structure is allowed, the application must select a structure store by issuing the Select Structure Store (GPSSS) subroutine. Before displaying any structure data on a workstation, the application must associate the structure store to the workstation by issuing the Associate Structure Store with Workstation (GPASSW) subroutine. For compatibility with previous releases, this subroutine, along with the Select Structure Store (GPSSS) subroutine, is called automatically during Open graPHIGS (GPOPPH) processing unless otherwise suppressed. If you suppress the default nucleus connection processing by using the Define Nucleus Connection Processing (DEFNUC) procopt default in either the Application Defaults Interface Block (ADIB) or the External Defaults File (EDF), then you must invoke this subroutine prior to opening a structure.

For information about structure stores, see The graPHIGS Programming Interface: Understanding Concepts

Parameters

ssid -- specified by user, fullword integer

Structure store identifier.

ncid -- specified by user, fullword integer

Nucleus identifier.

sstype -- specified by user, fullword integer

Structure store type (1=NORMAL )

ssdesc -- specified by user, variable data

Structure store descriptor. This parameter includes structure store type dependent data. For the structure store type 1=NORMAL , no descriptive data is required and so this parameter must be specified as a zero.

Error Codes

202
SPECIFIED NUCLEUS DOES NOT EXIST
217
RESOURCE CREATION REQUEST EXCEEDS NUCLEUS TABLE CAPACITY
221
SPECIFIED STRUCTURE STORE IDENTIFIER ALREADY IS IN USE
223
SPECIFIED STRUCTURE STORE TYPE IS NOT SUPPORTED

Related Subroutines

GPASSW
Associate Structure Store with Workstation
GPDTR
Detach Resource
GPOPST
Open Structure
GPQSTV
Inquire Structure State Value
GPSSS
Select Structure Store

RCP code

201340929 (X'0C003801')


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