graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQSTS - Inquire Structure Status

GPQSTS (strid, errind, flag, count)

Note:

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

Purpose

Use GPQSTS to inquire whether the specified structure exists in the currently selected structure store, and, if it exists, how many elements are contained in the structure.

If there is no structure store currently selected, that is, if the current structure state is Structure Store Close (SSCL) or Structure Store Open (SSOP), an error is issued.

Parameters

strid -- specified by user, fullword integer

Structure 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:

12: FUNCTION REQUIRES STATE SSSL

flag -- returned by the graPHIGS API, fullword integer

Structure status indicator (1=NON_EXISTENT, 2=EXISTENT )

count -- returned by the graPHIGS API, fullword integer

Number of elements in the structure.

Error Codes

None

Related Subroutines

GPQSTE: Inquire Structure Existence

RCP code

201337105 ( X'0C002911')