INIPut Function Behavior (Magic xpa 4.x)
The INIPut function behavior may differ depending on the context of which the end user accesses the component. If the end user accesses a task from a component and uses the INIPut function, the following can occur:
-
If the force write parameter of the INIPut function is True, the Magic.ini file is updated, and the change affects all active contexts.
-
If the force write parameter is False and an environment setting is associated with a task from the component, then the change affects all the programs in the current context only. If the end user re-enters the component task, the environment variable must again receive the environment value from the settings associated with the component.
-
If the force write parameter is False and the environment variable was not specified in the component, then the environment variable is updated only for the current task.
If the force write parameter evaluates to False, the function will act as neutral and there will be no access to the server/client. The context at the server/client will be updated on the next access.
If the force write parameter evaluates to True, the function will access the server (to immediately update the INI) right after the execution of the function.