Detailed Description
2.10 Working with tool environments
Tool Compensation (W1)
Function Manual, 08/2005 Edition, 6FC5397-0BP10-0BA0
2-143
2.10.5 Read T, D, DL from a tool environment
GETTENV function
The GETTENV function is used to read the T, D and DL numbers stored in a tool
environment.
The GETTENV function is a predefined subprogram.
It must, therefore, be programmed in a separate block.
Syntax:
Status = GETTENV(_NAME, _TDDL)
Value/parameter:
Status 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: A tool environment with the name specified in _NAME does not exist.
_NAME STRING
Name of the tool environment, from which the T, D and DL numbers can be read
_TDDL[3] INT
This integer array contains the following:
- in "_TDDL[0]", the T number of the tool,
- in "_TDDL[1]", the D number of the tool,
- in "_TDDL[2]", the DL number of the tool,
whose tool environment is stored in the data set specified by "_NAME".
It is possible to omit the first parameter in the GETTENV function call
(e.g., GETTENV(, _TDDL)) or to pass a null string as the first parameter
(e.g., GETTENV("", _TDDL)). In both of these two special cases, the T, D and DL numbers
of the active tool are returned in _TDDL.