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.