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

GPQNCC - Inquire Nucleus Connection State

GPQNCC (ncid, state)

Note:

This subroutine is a graPHIGS API State List (PSL) inquiry. For an overview, see "PSL Inquiries"

Purpose

Use GPQNCC to inquire the application process's connection state to the specified nucleus. The returned state will indicate:

1=ACTIVE
The application process is connected to the specified nucleus and the communication path is active.

2=INACTIVE
The application process is connected to the nucleus but the communication path is no longer active. The application process should issue a Disconnect from Nucleus (GPDNC) subroutine , to clean up and close the connection.

3=NON_EXISTENT
The specified nucleus does not exist. Therefore, the application process is not connected to the specified nucleus at this time.

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

status -- returned by the graPHIGS API, fullword integer

Status of the application's connection state to the nucleus (1=ACTIVE,2=INACTIVE, 3=NON_EXISTENT )

Error Codes

None

Related Subroutines

GPCNC
Connect Nucleus
GPDNC
Disconnect Nucleus

RCP code

201345806 (X'0C004B0E')

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