GETLOG()

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Function to get value from a defined logical name


Syntax

GETLOG(<expC1>, [<expC2>])


See Also

GETENV(), PUTENV(), PUTLOG()


Description

Used to manipulate process wide logical names, the GETLOG() function translates the specified logical name <expC1>, and returns the equivalence string. The optional <expC2> is the name of the logical table where the specified logical name is stored. If no logical table name is specified the GETLOG() function returns values from the logicals stored in the LNM$PROCESS_TABLE. These can be displayed in OpenVMS by entering the OpenVMS command SHOW LOGICAL/PROCESS.

On other operating systems this function operates in the same way as GETENV() and translates environment variables. The GETLOG() function always returns a character string without changing the case.


Example

// Display the system printer name
system_printer = getlog("sys$print","lnm$process_table")
@03,30 say "system Printer:"
@03,30 say system_printer


Products

Recital Server, Recital