graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQDBK - Inquire Default Break Action

GPQDBK (wstype, errind, trigger)

Note:

This subroutine is a Workstation Description Table (WDT) inquiry. For an overview, see "WDT Inquiries"

Purpose

Use GPQDBK to inquire the default break action for the specified workstation type.

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 graPHIGS API sets the error indicator (errind) to one of the error numbers to indicate the reason for the non-availability, and the values returned in the output parameters are unpredictable.

Parameters

wstype -- specified by user, 8-byte character string

Workstation type.

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:

23: SPECIFIED WORKSTATION TYPE DOES NOT EXIST
38: WORKSTATION HAS ONLY OUTPUT CAPABILITIES
548: SPECIFIED WORKSTATION TYPE CANNOT BE LOADED

trigger -- returned by the graPHIGS API, 2 fullword integers

Trigger to be used on the specified workstation for the break action. The trigger consists of a trigger type followed by a trigger qualifier. Positive integers as trigger types are button device numbers. The trigger qualifier for a button device is the choice alternative.

Error Codes

None

Related Subroutines

GPBKAC: Set Break Action
GPQBK: Inquire Break Capabilities
GPQBKS: Inquire Break Action State
GPQRCT: Inquire Realized Connection Type

RCP code

201339665 (X'0C003311')