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

GPOPPH - Open graPHIGS

GPOPPH (errfil, adib)

Purpose

Use GPOPPH to open and initialize the graPHIGS API This subroutine makes all the graPHIGS API subroutines available. Call GPOPPH before invoking any other graPHIGS API subroutine.

This subroutine creates one graPHIGS API shell and initializes the graPHIGS API state list (PSL) GPOPPH sets the system state value to graPHIGS Open (PHOP), sets the workstation state value to Workstation Closed (WSCL), and sets the structure state value to Structure Closed (STCL)

The Application Defaults Interface Block (ADIB) allows the application to modify the graPHIGS API system and workstation defaults. For the contents and formats of the Application Defaults Interface Block (ADIB) and the External Defaults File (EDF), see The graPHIGS Programming Interface: Technical Reference under "Defaults and Nicknames"

In this version of the graPHIGS API, some additional subroutines must be issued in order to communicate with a nucleus and to edit structures. These subroutines consist of:

  • Connect to Nucleus (GPCNC)

  • Create Structure Store (GPCRSS)

  • Select Structure Store (GPSSS)

    • Your application may chose to issue these additional subroutines or have the graPHIGS API issue these subroutines for your application (which is called nucleus connection processing) Nucleus connection processing may be done as follows:

  • If your application is using any workstation except the 6090 workstation and you want the graPHIGS API to invoke nucleus connection processing for your application, then you do not need to do anything additional. When you execute your application, it connects to a nucleus with the identifier set to a value of one, and the graPHIGS API creates and selects a structure store with the identifier set to a value of one for your application.

  • If your application is going to use the 6090 workstation and you want the graPHIGS API to invoke nucleus connection processing, then you must use the Default Nucleus Connection Processing (DEFNUC) procopt default in either the Application Defaults Interface Block (ADIB) or the External Defaults File (EDF) to indicate this.

  • If your application is going to issue these additional subroutines, then you must use the Default Nucleus Connection (DEFNUC) procopt in the Application Defaults Interface Block (ADIB) or the External Defaults File (EDF) to suppress the graPHIGS API from invoking nucleus connection processing. (It is not necessary to suppress nucleus connection processing if your application is a distributed application process [DAP])

    • To determine if the GPOPPH subroutine call was successful, your application can use the Inquire System State Value (GPQSYV) subroutine.

    For formats and contents of the Application Defaults Interface Block (ADIB) and External Defaults File (EDF), see The graPHIGS Programming Interface: Technical Reference under "Defaults and Nicknames"

    Parameters

    errfil -- specified by user, 8-byte character string

    Name of the error file.

    adib -- specified by user, variable data

    Application Defaults Interface Block (ADIB) When no defaults are specified, an ADIB that consists of a fullword integer with a value of zero must be specified.

    Error Codes

    1
    FUNCTION REQUIRES STATE PHCL
    208
    CONNECTION NOT CURRENTLY PERMITTED FROM THIS HOST

    Related Subroutines

    GPCLPH
    Close graPHIGS
    GPQSYV
    Inquire System State Value

    RCP code

    201326849 (X'0C000101')

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