graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQSID - Inquire List of Socket Identifiers

GPQSID ( start, number, errind, totnum, socketids)

Purpose

Use GPQSID to inquire the currently existing socket identifiers in use by the graPHIGS API and available to the graPHIGS shell. This inquiry is intended for applications that use the graPHIGS SYNCPROC default. See The graPHIGS Programming Interface: Technical Reference for further information on the SYNCPROC default and the ramifications of its use.

If the inquired information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the error indicator is 543 (the start value exceeds the extent of the available data), then only the total number (totnum) parameter is set. If the inquired information is unavailable, then the error indicator (errind) contains an error number indicating the reason, and the values returned in the output parameters are unpredicatable.

Parameters

start -- specified by user, fullword integer

Starting member of the list of socket identifiers ( >=1 )

number -- specified by user, fullword integer

Number of entries requested ( >=0 )

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:

538: START VALUE < ONE
539: REQUESTED NUMBER < ZERO
543: STARTS EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED

totnum -- returned by the graPHIGS API, fullword integer

Total number of socket identifiers in list

socketids -- returned by the graPHIGS API, array of fullword integers

List of socket identifers

MESSAGES.

None

Related Subroutines

GPRDEV: Redrive X Events

RCP code

201345808 ( X'0C004B11')