Checking the Status of Character Maps (lkt_charmap_list)

The following command returns a list of the names of all existing character maps or checks for the existence of a particular character map or maps.
dvkerr_t lkt_charmap_list(lpar_t host, lpar_t names, lpar_t *ret_stats );

Input

names (optional)

is a single character map name (LPAR_STR_CHARMAP) or a list of character map names of existing character maps. It is an error (DVK_ERR_DBNOTFOUND) if any of these character maps do not exist.

A value of LPAR_NULL might be supplied for names. This causes all of the names of the currently created character maps to be returned.

Output

ret_stats (optional)

is a list of lists, one list for each character map. Each list contains the character map name as an LPAR_STR_CHARMAP.

•

LPAR_LONGINT_TRAN_ID is the transaction id of the transaction that owns or claims the object at that instance.

•

LPAR_INT_TRAN_OBJ_STATE is the state of an object when a transaction owns or claims it; if there is no such transaction, it returns LKT_TRAN_OBJ_EXISTS.

Error codes and items returned by lkt_charmap_list

DBNOTFOUND	first item that isn't an existing character map
EXPECTDBDESC	item that should have been a character map name
EXPECTLIST	item that should have been a list
FEATURESET	list with unsupported item or combination of items
NODBDESC	the list or item that was missing a character map name
NOSYSINIT	(none)