Siemens SINUMERIK 840Di Function Manual page 1820

Detailed Description
2.10 Working with tool environments
Note
Resulting length of toolholders with orientation capability and transformations:
Both toolholders with orientation capability and transformations can use system parameters
or machine data, which act as additional tool length components, and which can be
subjected partially or completely to the rotations performed. The resulting additional tool
length components must also be stored when TOOLENV is called, because they represent
part of the environment, in which the tool is used.
Adapter transformation:
The adapter transformation is a property of the tool adapter and thus of the complete tool. It
is, therefore, not part of a tool environment, which can be applied to another tool.
By saving the complete data necessary to determine the overall tool length, it is possible to
calculate the effective length of the tool at a later point in time, even if the tool is no longer
active or if the conditions of the environment (e.g., G codes or setting data) have changed.
Similarly, the effective length of different tool can be calculated assuming that it would be
used under the same conditions as the tool, for which the status was saved.
TOOLENV function
Saving a tool environment
The TOOLENV function is a predefined subprogram.
It must, therefore, be programmed in a separate block.
Syntax:
Value/parameter:
Status
_NAME
2-140
Status = TOOLENV(_NAME)
INT
0: Function OK
-1: No memory location reserved for tool environments
(MD18116 $MN_MM_NUM_TOOL_ENV = 0),
i.e., the "Tool environments" functionality if not available.
-2: No more free memory locations for tool environments available.
-3: Null string illegal as name of a tool environment.
-4: No parameter (name) specified.
STRING
Name, under which the current data set is stored.
If a data set of the same name already exists, it is overwritten.
In this case, the status is 0.
Function Manual, 08/2005 Edition, 6FC5397-0BP10-0BA0
Tool Compensation (W1)