


     SetEnv(V1.3) 


     NAME
          SetEnv - Set or delete an environment variable in the 
        ENV: handler.

     SYNOPSIS
          SetEnv Varname [String]

     DESCRIPTION
            This command sets or delete the value of environment 
        variables using the new ENV: handler introduced by 
        Commodore.  It takes the name of a variable and the value 
        to set it to.

            An environment variable is a variable that is 
        accessable by all tasks.  Note that ENV: is currently 
        just a directory in RAM:, it is not a true handler. Maybe 
        in the furture global environmental varibles may be 
        stored in RAM reserved for the system and then 
        manipulated by their own device handler, as the local 
        environments are.

     KEYWORDS
        Varname
            The name of the environment variable to set. This is 
        the name of the text files stored in the ENV: directory. 
        Using the SETENV command copies the text string to this 
        file.
            2.x/3.x has several global variables which are 
        automatically set for you, or you can set for yourself.  
        These include:
      
        Kickstart/Workbench: These variables are created during
        system startup and contain the version numbers of the
        Kickstart and Workbench you are using.

        Editor: Recognized by some Workbench programs such as 
        MORE. If you set this variable to the path name of your
        favorite text editor, MORE allows you to bring up the
        program to edit the current file by pressing Shift-E.

        [string]
            The text string attached to the environmental 
        variable. If there are any spaces in the text then you 
        must enclose the entire string in quotes. If there is no 
        string specified then an empty string will be copied to 
        the variable. 2.x/3.x only: To remove the string then use 
        the UNSETENV command.       
        
     EXAMPLE

        1. Copy the name Bar to the environment variable named
           foo:

          SetEnv Foo Bar

        2. To remove a text string associated with the environment
           variable Foo:

          SetEnv Foo
 
