graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPBKAC - Set Break Action

GPBKAC (wsid, trigger)

Purpose

Use GPBKAC to set the break action to a given trigger type and trigger qualifier at the specified workstation.

This subroutine lets the application specify which operator action is to be interpreted as "break" for input device operations on the given workstation. For example, the default break action on the 5080 workstation is the alternate-cancel key combination.

The break action is the operator action that terminates an outstanding Request input subroutine at a workstation. This break action is used to terminate Request operations for all device classes.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

trigger -- specified by user, 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 type physical device numbers. The trigger qualifier for a button device is the physical button number. If a trigger type is for a keyboard and the qualifier is between 0 and 255, the workstation's primary character set is used to interpret the qualifier.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
38: WORKSTATION HAS ONLY OUTPUT CAPABILITIES
567: A TRIGGER TYPE VALUE IS INVALID
568: A TRIGGER QUALIFIER VALUE IS INVALID
572: WORKSTATION DOES NOT SUPPORT PROGRAMMABLE BREAK ACTION

Related Subroutines

GPIT: Set Input Device Trigger
GPQABK: Inquire Actual Break Capabilities
GPQBK: Inquire Break Capabilities
GPQBKS: Inquire Break Action State
GPQDBK: Inquire Default Break Action

RCP code

201327878 (X'0C000506')