graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQOPW - Inquire Set of Open Workstations

GPQOPW (start, number, errind, totnum, lwsid)

Note:

This subroutine is a graPHIGS API State List (PSL) inquiry. For an overview, see "PSL Inquiries"

Purpose

Use GPQOPW to inquire the list of the currently open workstations on a nucleus with an identifier of 1.

The graPHIGS API returns data indicating the total number of open workstation identifiers and a list of these identifiers that exist on a nucleus with an identifier of 1.

If the inquired information is available, the error indicator is returned as zero, and the values are returned 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 parameter is set. If the inquired information is unavailable, the error indicator contains an error number indicating the reason, and the values returned in the output parameters are unpredictable.

Parameters

start -- specified by user, fullword integer

Starting member of the list of open workstations (>=1)

number -- specified by user, fullword integer

Number of open workstation identifiers 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:

202: SPECIFIED NUCLEUS DOES NOT EXIST
538: START VALUE < ONE
539: REQUESTED NUMBER < ZERO
543: START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED

totnum -- returned by the graPHIGS API, fullword integer

Total number of open workstations.

lwsid -- returned by the graPHIGS API, array of fullword integers.

List of open workstation identifiers. The output array must be large enough to contain the requested data.

Error Codes

None

Related Subroutines

GPCLWS: Close Workstation
GPDTR: Detach Resource
GPQATR: Inquire List of Attached Resources

RCP code

201336326 (X'0C002606')