Performance Metric kcml.env.get

Summary

Get environment value

Send Condition

val$=ENV(varName$)

Overview

Records the evaluation of an environment variable. This is a potentially expensive operation, especially for application's with a large number of variables in their environment block as variables are found using a linear search. Therefore it is recommended that ENV() statements are not used within frequently executed blocks of code such as WHILE or FOR loops. The result of ENV() should be stored, prior to the frequently executed block, in a LOCAL variable and then that value used instead.

Statistics

Name	Type	Description
name	string	Name of environment variable
time	usec	Time taken in micro-seconds
stack	string	Stack backtrace

General Form

kcml.env.get,name=string,time=usec,stack=string