Query Color Support (QsnQryColorSup) API

Omissible Parameter Group:

1	Color indication	Output	Char(1)
2	Low-level environment handle	Input	Binary(4)
3	Error code	I/O	Char(*)

Returned Value:

Color indication

Output

Binary(4)

  Default Public Authority: *USE

  Service Program: QSNAPI

  Threadsafe: No

The Query Color Support (QsnQryColorSup) API determines whether the current display device supports color or not.

Authorities and Locks

None.

Omissible Parameter Group

Color indication

OUTPUT; CHAR(1)

Whether the device supports color or not. This information will be set based on the results of the 5250 Query command, if the display supports it; otherwise, certain defaults are assumed. See Device Support for details. The possible values are:

0	Device does not support color
1	Device supports color

Low-level environment handle

INPUT; BINARY(4)

The low-level environment that the operation applies to. If this parameter is omitted or given with a value of zero, the default low-level environment is used.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, diagnostic and escape messages are issued to the application.

Returned Value

Color indication: OUTPUT; BINARY(4)
This API returns the value for the color indication parameter if successful, or -1 otherwise.

Error Messages

Message ID	Error Message Text
CPF24B4 E	Severe error while addressing parameter list.
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPFA334 E	Low level environment handle incorrect.

API introduced: V2R3

[ Back to top | Dynamic Screen Manager APIs | APIs by category ]