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.