graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQWCT - Inquire Workstation Connection and Type

GPQWCT (wsid, errind, connid, wstype)

Purpose

Use GPQWCT to inquire the connection identifier and generic workstation type of the specified workstation identifier. The generic workstation type is the type that was developed from the Open Workstation (GPOPWS) subroutine or Create Workstation (GPCRWS) subroutine or the type that resulted from Nickname Default processing.

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 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 unpredictable.

Parameters

wsid -- specified by user, fullword integer

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

25: SPECIFIED WORKSTATION DOES NOT EXIST
533: INQUIRY DATA EXCEEDS AREA. OUTPUT TRUNCATED

connid -- returned by the graPHIGS API, 8-byte character string

Connection identifier.

Note: It the connection identifier is >8 characters, then it is truncated and the errind parameter is set to 533

wstype -- returned by the graPHIGS API, 8-byte character string

Generic workstation type.

Error Codes

None

Related Subroutines

GPQRCT: Inquire Realized Connection Type

RCP code

201336841 (X'0C002809')