Query Display Mode Support (QsnQryModSup) API


  Required Parameter:

1 Display mode Input Char(1)

  Omissible Parameter Group:

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

  Returned Value:

Mode indication Output Binary(4)

  Default Public Authority: *USE

  Service Program: QSNAPI

  Threadsafe: No

The Query Display Mode Support (QsnQryModSup) API determines if the current display device supports the given mode. Certain devices, like the 3486 and 3487, support 27x132 mode but can be switched by keystroke to turn off the wide capability. This will be reflected in the result returned by the QsnQryModSup API. Use this API to determine if a subsequent mode change request through the Clear Screen (QsnClrScr) API is valid. You can use the result of the Query 5250 (QsnQry5250) API to determine if the display is capable of supporting wide mode or not.


Authorities and Locks

None.


Required Parameter

Display mode
INPUT; CHAR(1)

The display mode for which to query support. The possible values are:

3 24x80 mode
4 27x132 mode

Omissible Parameter Group

Mode indication
OUTPUT; CHAR(1)

Whether the device allows the specified mode or not. The possible values are:

0 Device does not support the mode
1 Device supports the mode

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

Mode indication
OUTPUT; BINARY(4)

This API returns the value for the mode 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.
CPFA322 E Incorrect display mode &1 specified.
CPFA334 E Low level environment handle incorrect.


API introduced: V2R3

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