$ZTRNLNM()
Prev  Chapter 7. Functions  Next
GT.M Programmer's Guide > Functions > $ZTRNLNM()

$ZTRNLNM()

The $ZTRNLNM function returns the value of an environment variable.The $ZTRNLNM function is analogous to the DCL Lexical function F$TRNLNM on OpenVMS.

[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 OpenVMS-related expressions that specify logical name table(s), index (numbered from 0), initial mode of the look-up, and a value indicating whether the look-up is case sensitive. To ensure interoperability between UNIX and OpenVMS versions, $ZTRNLNM() on UNIX accepts these expressions and ignores them.

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.

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()