A scalar string containing the name of the logical to be translated.
Searches the OpenVMS name tables for a specified logical nameand returns the equivalence string(s) in a variable.
A scalar string containing the name of the logical to be translated.
A variable into which the equivalence string is placed. If logname has more than one equivalence string, the first one is used unless the Full_Translation keyword is also used.
The OpenVMS status code associated with the translation as a longword value:
An integer specifying the access mode to be used in the translation. Valid access mode values are as follows:
If you don't use Acmode, the translation proceeds without regard to access mode. However, the search proceeds from the outermost (User) to the innermost (Kernel) mode. Thus, if two logical names with the same name but different access modes exist in the same table, the name with the outermost access mode is used.
Full_Translation
If present and nonzero, turns the value parameter into a string array containing all of the equivalence strings. If Full_Translation is not present, value only receives the first equivalence string as a scalar value, when translating a multi-valued logical name.For example, under recent versions of OpenVMS, the
SYS$SYSROOT logical can have multiple values. To see these values from within PV-WAVE:
ret = TRNLOG('SYS$SYSROOT', trans, /Full, /Issue_Error)
PRINT, trans
If present and nonzero, causes TRNLOG to issue an error message if the translation fails.Result_Acmode
If present, specifies a named variable into which the access mode value of the translated logical will be placed. (The access mode values are summarized in the Acmode keyword description.)Result_Table
If present, specifies a named variable into which the name of the logical table containing the translated logical will be placed, as a scalar string.Table
A scalar string giving the name of the logical table in which the search for logname will occur. If Table is not specified, the standard OpenVMS logical tables are searched until a match is found, starting with LNM$PROCESS_TABLE and ending with LNM$SYSTEM_TABLE.
