KClient parameters

Introduction

KCML 7.14 introduced a new argument to KClient that allowed passing of extra arguments through to KCML for a session. It requires version 7.14 or later of Connection Manager and KClient to pass the arguments through. Neither have knowledge of which arguments are supported by KCML so extra functionality can be added to KCML without changing the other components. They are all intended for debugging and diagnosing problems and are not expected to be used by normal end users.

Usage

The argument --param on the KClient command-line specifies the argument and can be used multiple times. Some arguments are a single parameter name to name a feature while others take a value which can be specified by following the argument name with an equals '=' and the value.

Parameter	Value	Example	Description
debug		‑‑param debug	Forces the debug version of KCML to execute instead. Replaces currently executing kcml with debug/kcml. UNIX only.
sleep	seconds	‑‑param sleep=30	Forces a sleep of specified number of seconds before kcml KCML starts. Allows time to attach a debugger to debug startup code.
kcc		‑‑param kcc	Forces LOGNAME to return kcc. Must have been enabled in /etc/kcml/kcml.conf.
record	filename	‑‑param record=mytest	Record session for replaying in headless testing. To enable and specifiy directory where recordings are save the environment variable KCML_RECORD_DIR must be set. Form the example a file $KCML_RECORD_DIR/mytest.kft will be created. This file will be a KCML src program.
record-verbose	level	‑‑param record-verbose=1	Controlthe amount of comments added to the record session to help diagnosis. Level 0 means no comment and higher values will lead to more detail. Not specifying a value is equivalent to specifying 1.
stop		‑‑param stop	Force application to stop executing on the first line of the program.
heap-pagecheck	mode	‑‑param heap-pagecheck=1	Enable the page checked heap which will cause an exception to be raised should an out of boundary memory reference occur.
kcs		‑‑param kcs	Force behaviour as if the KCS version of KClient is being used.