graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQNCE - Inquire Nucleus Environment

GPQNCE (ncid, length, datatype, errind, hardware, datalen, data)

Note:

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

Purpose

Use GPQNCE to determine the environment information for the specified nucleus.

The graPHIGS API uses the datatype parameter to determine the type of environment information the graPHIGS API returns. If you specify a type of 1=SYSTEM_LEVEL , then the graPHIGS API returns the hardware and operating system environment information. If you specify a type of 2=ENVIRONMENT_DESCRIPTOR , then the graPHIGS API returns an environment descriptor, which is an indicator for the character encoding, floating-point format, and byte order specification for the specified nucleus. Use this descriptor as input to the Convert Data (GPCVD) subroutine.

Parameters

ncid -- specified by user, fullword integer

Nucleus identifier.

length -- specified by user, fullword integer

Length, in bytes, of the data area specified by data into which the graPHIGS API returns the environment information.

datatype -- specified by user, fullword integer

Type of environment information to be returned (1=SYSTEM_LEVEL, 2=ENVIRONMENT_DESCRIPTOR )

errind -- returned by the graPHIGS API, fullword integer

Error indicator. Zero indicates that the request has completed successfully.

202: SPECIFIED NUCLEUS DOES NOT EXIST
509: DATA LENGTH VALUE < ZERO OR REQUIRED LENGTH
526: REQUESTED DATA NOT AVAILABLE FOR THIS FUNCTION
534: TYPE VALUE IS INVALID

hardware -- returned by the graPHIGS API, fullword integer

Hardware type on which the nucleus is executing (1=RISC_6000, 2=IBM_6095, 3=IBM_370 )

datalen -- returned by the graPHIGS API, fullword integer

Length of data returned in the data area specified by the data parameter.

data -- returned by the graPHIGS API, variable length data

Operating system specific data. The value of each field is expressed in the data format listed below:

Type 1

SYSTEM_LEVEL

Four fullwords of data defined as follows:

     ----------------------
   0 |       opsys        | fullword integer
     |--------------------|
   4 |      version       | fullword integer
     |--------------------|
   8 |      release       | fullword integer
     |--------------------|
  12 |nucleus identifier  | fullword integer
     ----------------------

where:

opsys is the operating system type (1=AIX_RISC_6000, 2=6095 )

version is the operating system version level.

release is the operating system release level.

nucleus identifier is the identifier of the nucleus receiving the inquiry request.

Type 2

ENVIRONMENT_DESCRIPTOR

Four bytes of data defined as follows:

     ----------------------
   0 |   env_desc         | 4-byte character string
     ----------------------

where:

env_desc is the environment descriptor for the specified nucleus.

Error Codes

None

Related Subroutines

GPCVD: Convert Data
GPEXAP: Execute Application Process
GPINAP: Initiate Application Process
GPTMAP: Terminate Application Process
GPWDO: Workstation-Dependent Output

RCP code

201345807 (X'0C004B0F')