Retrieve Display Mode (QsnRtvMod) API

Omissible Parameter Group:

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

Returned Value:

Display mode

Output

Char(1)

  Default Public Authority: *USE

  Service Program: QSNAPI

  Threadsafe: No

The Retrieve Display Mode (QsnRtvMod) API returns the current display mode.

Authorities and Locks

None

Omissible Parameter Group

Display mode

OUTPUT; CHAR(1)

The current display mode. The possible values are:

3	Device is in 24x80 mode
4	Device is in 27x132 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

Display mode: OUTPUT; CHAR(1)
This API returns the value for the display mode parameter, or 0 if an error occurs during processing.

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

Top | Dynamic Screen Manager APIs | APIs by category