Clear Field Table (QsnClrFldTbl) API

The Clear Field Table (QsnClrFldTbl) API erases the contents of the format table without affecting the display station screen. This allows for example, all input field definitions to be erased from the screen without altering the physical appearance of the screen.

This command corresponds directly to the 5250 Clear Format Table command. See the 5250 data stream documentation for details.

Authorities and Locks

None

Omissible Parameter Group

Command buffer handle

INPUT; BINARY(4)

If this parameter is omitted or specified as 0, this is a direct operation and the format table is cleared immediately. Otherwise, this is an indirect operation and the command is stored in the command buffer without an I/O operation taking place.

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

Return code

OUTPUT; BINARY(4)

A return code indicating the result of the operation. The value returned will be 0 if the operation was successful, or -1 otherwise.

Error Messages