graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQNCS - Inquire Available Nucleus Storage Size

GPQNCS (ncid, errind, size)

Note:

This subroutine is a Nucleus State List (NSL) inquiry. For an overview, see "NSL Inquiries"

Purpose

Use GPQNCS to determine the amount of free storage available to the nucleus for resource allocation and modification. The returned value may only be approximate since the memory allocation mechanisms may be different in each environment. Requests from other applications connected to this nucleus will compete for this storage.

A value of zero indicates there is unlimited storage available.

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

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
571: INQUIRED INFORMATION IS NOT AVAILABLE

size -- returned by the graPHIGS API, fullword integer

The number of bytes of free storage currently available to the nucleus.

Error Codes

None

Related Subroutines

GPSSTH: Set Structure Store Threshold

RCP code

201345805 (X'0C004B0D')