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

GPDNC - Disconnect Nucleus

GPDNC (ncid)

Purpose

Use GPDNC to disconnect a graPHIGS nucleus from your application All of the resources of the nucleus become unavailable to your application.

The following actions are performed:

  1. If the structure state is Structure Open (STOP) and the currently selected structure store is a resource of the specified nucleus, the structure is closed. As a result, the structure state becomes Structure Close (STCL)

  2. If the structure state is Structure Close (STCL) and the currently selected structure store is a resource of the specified nucleus, the structure store identifier is removed from the currently selected structure store entry of the graPHIGS API state list. As a result, the structure state becomes Structure Store Open (SSOP)

  3. All resources of the specified nucleus are detached from the shell. If there remains no structure store or no workstation attached to the shell, the structure state or workstation state becomes Structure Store Close (SSCL) or Workstation Close (WSCL), respectively.

    4. Parameters

    ncid -- specified by user, fullword integer

    Nucleus identifier.

    Error Codes

    202
    SPECIFIED NUCLEUS DOES NOT EXIST

    Related Subroutines

    GPCNC
    Connect Nucleus
    GPQCNC
    Inquire List of Connected Nuclei

    RCP code

    201337602 (X'0C002B02')

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