Difference between revisions of "PUTENV()"

From Recital Documentation Wiki
Jump to: navigation, search
 
(2 intermediate revisions by one user not shown)
Line 1: Line 1:
==Class==
 
Environment
 
 
 
 
==Purpose==
 
==Purpose==
Function to update the value of an environment symbol
+
Function to update the value of an environment variable
  
  
Line 16: Line 12:
  
 
==Description==
 
==Description==
The PUTENV() function updates the value of <expC1> with the character expression <expC2>.  The value of the symbol can be retrieved using the GETENV() function.  If variable <expC1> does not exist, it is created.  If the operation is successful, then PUTENV() returns .T., otherwise .F..
+
The PUTENV() function updates the value of <expC1> with the character expression <expC2>.  The value of the variable can be retrieved using the GETENV() function.  If variable <expC1> does not exist, it is created.  If the operation is successful, then PUTENV() returns .T., otherwise .F..
  
  
Line 22: Line 18:
 
<code lang="recital">
 
<code lang="recital">
 
set printer to \\spooler
 
set printer to \\spooler
putenv("db_print","/usr/recital/UD/print_labels")
+
putenv("DB_PRINT","/usr/recital/UD/print_labels")
 
list status to print
 
list status to print
? getenv("db_print")
+
? getenv("DB_PRINT")
 
/usr/recital/UD/print_labels
 
/usr/recital/UD/print_labels
 
</code>
 
</code>
Line 30: Line 26:
  
 
==Products==
 
==Products==
Recital Database Server, Recital Mirage Server, Recital Terminal Developer
+
Recital, Recital Server
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:Environment]]
 
[[Category:Environment]]
 
[[Category:Environment Functions]]
 
[[Category:Environment Functions]]

Latest revision as of 16:14, 10 February 2012

Purpose

Function to update the value of an environment variable


Syntax

PUTENV(<expC1>,<expC2>)


See Also

ADDBS(), GETENV(), Printing


Description

The PUTENV() function updates the value of <expC1> with the character expression <expC2>. The value of the variable can be retrieved using the GETENV() function. If variable <expC1> does not exist, it is created. If the operation is successful, then PUTENV() returns .T., otherwise .F..


Example

set printer to \\spooler
putenv("DB_PRINT","/usr/recital/UD/print_labels")
list status to print
? getenv("DB_PRINT")
/usr/recital/UD/print_labels


Products

Recital, Recital Server