$ZTRNLNM()

$ZTRNLNM()
Prev	Chapter 7. Functions	Next

The $ZTRNLNM() function returns the value of an environment variable.The $ZTRNLNM() function is analogous to the getenv() function on Unix.

	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.

Prev	Up	Next
$ZTRIgger()	Home	$ZWidth()