graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQEP - Inquire Element Pointer

GPQEP (errind, value)

Note:

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

Purpose

Use GPQEP to inquire the value of the current element pointer in the currently selected structure store.

A structure must be open to invoke this subroutine.

If the required information is available, the error indicator is returned as zero, and the value is returned in the output parameters. If a structure is not open, then the error indicator contains an error number indicating the reason, and the value returned in the output parameter is unpredictable.

Parameters

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:

4: FUNCTION REQUIRES STATE STOP

value -- returned by the graPHIGS API, fullword integer

Current element pointer value.

Error Codes

None

Related Subroutines

None

RCP code

201337091 (X'0C002903')