# (setvar sysvar value)
[GstarCAD 2012](../../../Index.md) → [Developer Reference](../../%28Developer%20Reference%29.md) → [AutoLISP Reference](../%28AutoLISP%20Reference%29.md) → [LISP Functions](%28LISP%20Functions%29.md)
<!-- help-structure:notice -->
> **Source status:** This source topic has 2 recorded inherited issue(s). [Source issue details](../../../Source%20Issues.md).
<!-- /help-structure:notice -->
<a id="265"></a>
## (setvar sysvar value)
---
Set the system variable to that value.
---
This function changes the value of GstarCAD® system variables. The *sysvar* argument is the exact name of the system variable, in string format.
The *value* is the new value for the system variable. The format of *value* varies, depending on the system variable; it could be an [integer](../../../Source%20Issues.md#issue-f1086ab5d1e01a19), a [real number,](../../../Source%20Issues.md#issue-debe8405257bf365) a list of x,y or x,y,z-coordinates, or a string-as shown by the examples below.
### Examples
| Code | Returns |
| --- | --- |
| (**setvar** "cmdecho" 1\) | 1 |
| (**setvar** "gridunit" '(1 1)) | (1.0 1.0) |
| (**setvar** "insbase" '(1 2 3)) | (1.0 2.0 3.0) |
| (**setvar** "dwgname" "drawing1") | "drawing1" |
### NOTES
- The **setvar** function is identical in nature to the **Setvar** command, with a single exception: the **Angbase** system variable accepts degrees with the **Setvar** command but only accepts radians with the **setvar** function.
- Some system variables are read-only, which means their value cannot be changed with **setvar**. For example, the **CDate** system variable contains the current date and time. You cannot change that with the **setvar** function. Instead, you must use the Windows **Date \& Time Properties** dialog box. You can, however, retrieve the value of any system variable with [getvar](%28getvar%20sysvar%29.md).
**Tell me about...**
[(setcfg parameter value)](%28setcfg%20parameter%20value%29.md)
[(setenv variable value)](%28setenv%20variable%20value%29.md)
[LISP Compatibility](../LISP%20Compatibility.md)
[Programming Overview of LISP (LISt Processing) Language](../Programming%20Overview%20of%20LISP%20%28LISt%20Processing%29%20Language.md)
<a id="holding"></a>
## Other versions with matching text
[GstarCAD 2011](../../../../2011/Developer%20Reference/AutoLISP%20Reference/LISP%20Functions/%28setvar%20sysvar%20value%29.md)