$ZTRNLNM()
$ZTRNLNM()
The $ZTRNLNM() function returns the value of an environment variable.The $ZTRNLNM() function is analogous to the getenv() function on Unix.
| [Note] | Note |
| $ZTRNLNM() does not perform iterative translation. |
The format for the $ZTRNLNM function is:
$ZTRNLNM(expr1[,expr2[,expr3[,expr4[,expr5[,expr6]]]]])expr1 specifies the environment variable whose value needs to be returned.
expr2 to expr5 are optional and currently accepted, but ignored, by $ZTRNLNM().
The optional expr6 specifies any one of the following keywords:
| ITEM KEYWORD | DATA RETURNED |
|---|---|
| FULL | Returns the translation. |
| LENGTH | Length of the return value in bytes. |
| VALUE | Returns the translation. |
On Unix, if the specified environment variable does not exist, $ZTRNLMN() returns an empty string for all operations including LENGTH.
Examples of $ZTRNLNM()
Example:
GTM>write $ztrnlnm("gtm_dist","","","","","VALUE")
/usr/lib/fis-gtm/V6.3-004_x86_64/utf8
GTM>write $ztrnlnm("gtm_dist")
/usr/lib/fis-gtm/V6.3-004_x86_64/utf8
GTM>These example use $ZTRNLNM() to display the translation value for gtm_dist.