Difference between revisions of "PUTENV()"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=PUTENV()=
 
 
 
==Class==
 
Environment
 
 
 
 
==Purpose==
 
==Purpose==
Function to update the value of an environment symbol
+
Function to update the value of an environment variable
  
  
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
[[GETENV()]]
+
[[ADDBS()]], [[GETENV()]], [[:Category:Printing|Printing]]
  
  
 
==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 is very useful for passing parameters to Recital programs spawned in the background, when used in conjunction with the GETENV() function.
+
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==
 
==Example==
 
<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 33: 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 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