Close List (QGYCLST) API

Required Parameter Group:

1	Request handle	Input	Char(4)
2	Error code	I/O	Char(*)

Default Public Authority: *USE

Threadsafe: No

The Close List (QGYCLST) API closes a previously opened list. Any internal storage associated with that list is freed. The handle specified on the call to this API is no longer valid after the call completes.

Authorities and Locks

None.

Required Parameter Group

Request handle

INPUT; CHAR(4)

The handle to the list that is to be closed. The handle is generated by APIs such as:

Open List of Job Log Messages (QGYOLJBL)
Open List of Messages (QGYOLMSG)
Open List of Objects (QGYOLOBJ)
Open List of Printers (QGYRPRTL)
Open List of Spooled Files (QGYOLSPL)

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF24B4 E	Severe error while addressing parameter list.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.
GUI0001 E	Invalid handle specified.

API introduced: V3R6

[ Back to top | Process Open List APIs | APIs by category ]