# kernelv_set_options()

## Prototype

KERNELV_RETURN | kernelv_set_options (unsigned long int optionsMask);

## Description

This function activates internal kernelv functions, e.g. the output of messages during license check.

Depending on the function to be activated, this function may have to be called by the kernelv_startup() function.

Each function is assigned a bit in the call parameter of this function. The function is activated by setting the appropriate bit.

If several functions are to be activated, the resulting bit array is generated from the OR operation of the individual bit masks.

If bits are set in the bit array transferred to the function and they are not assigned to any function, the unknown bits are ignored and the value ERR_UNKNOWN_OPTION is returned. In this case, the known bits are evaluated and the assigned functions are activated.

## Parameter

Name | Type | Meaning
optionsMask | unsigned long | Bit array with options.

Possible values for the bit array are:

Symbol | Value | Meaning
KERNELV_OPTION_ LICENSE_CHECK_VERBOSE | 0x1 | During the license check at start-up, progress messages are output relating to the license check. Acts as error search to handle licensing problems.

## Return values

Symbol | Value | Meaning
RET_FINISHED | 0 | The function was executed without error.
ERR_CNC_NOT_INIT | -3 | The simulation CNC kernel was not yet initialised.