graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQNS - Inquire Nucleus Specification

GPQNS (ncid, ilen, errind, conn, olen, spec)

Note:

This subroutine is a Nucleus Description Table (NDT) inquiry. For an overview, see "NDT Inquiries"

Purpose

Use GPQNS to inquire the nucleus connection method and specification that was used to connect the application process to the specified nucleus.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameter. If the error indicator is 536 (the actual connection specification is greater than the length of the area provided), then only the actual length (olen) of the connection specification is returned. If the inquired information is unavailable, then the error indicator (errind) contains the error number indicating the reason, and the values returned in the output parameter are unpredictable.

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

ilen -- specified by user, fullword integer

Length of the area provided to contain the nucleus connection specification.

errind -- returned by the graPHIGS API, fullword integer

Error indicator. If the error indicator is zero, the request has been completed. Otherwise, one of the following errors exists:

202: SPECIFIED NUCLEUS DOES NOT EXIST
536: INQUIRY DATA EXCEEDS AREA. LENGTH OF REQUIRED AREA RETURNED

conn -- returned by the graPHIGS API, fullword integer

Nucleus connection method.

olen -- returned by the graPHIGS API, fullword integer

Actual length of the nucleus connection specification.

spec -- returned by the graPHIGS API, variable data

Nucleus connection specification. For a description of the format of the nucleus specification, see the Connect Nucleus (GPCNC) subroutine.

Error Codes

None

Related Subroutines

GPCNC: Connect Nucleus

RCP code

201345808 (X'0C004B10')