Siemens SINUMERIK 840D sl Programming Manual page 809

<Status>:
Parameters
1
Additional information
Base dimension/adapter dimension – tool length compensation
When the tool magazine management is active (only available with the "Tool management"
option!), the value of the following machine data defines whether the adapter length or the tool
base dimension (cutting edge-specific parameters $TC_DP21, $TC_DP22 and $TC_DP23) is
incorporated in the calculation of the tool length:
MD18104 $MN_MM_NUM_TOOL_ADAPTER (tool adapter in TO area).
Since a change to this machine data only takes effect after the control system has powered up,
it is not saved in the tool environment.
Resulting length of toolholders with orientation capability and transformations:
Note
Both toolholders with orientation capability and transformations can use system variables 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 saved 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 a different tool can be calculated assuming that it would be used under
the same conditions as the tool, for which the status was saved.
NC programming
Programming Manual, 12/2019, 6FC5398-2EP40-0BA0
Function return value. Negative values indicate error states.
Data type:
Value:
Name, under which the current data set should be saved.
<name>:
If a data set of the same name already exists, then it is overwritten. In this case,
the status is "0".
Data type:
INT
0 Function OK
-1 No memory reserved for tool environments:
MD18116 $MN_MM_NUM_TOOL_ENV = 0
This means that the "tool environments" functionality is 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
Work preparation
3.13 Tool offsets
809