Available information on this page:

• Introduction
• Modulefiles
• Modification by User-setup
• Modification by Modules

If you're not happy with your current working environment, you are able to modify it to your own wishes and needs.
There are two software tools for modification of your working environment:

• User-setup
• Modules

User-setup is based on the tool Modules, in fact it is a menu driven interface to Modules. This makes User-setup more user-friendly than Modules. A drawback of this tool is that not all modifications are possible. With User-setup you can only add applications to your environment. With Modules it is also possible to unload or swap applications. To realize these changes both tools uses 'modules', which contain the configuration information of the applications.
Below more information is given about modules.
In addition a description is given of how to modify your environment by User-setup and by Modules.

As described above the two tools for modification use modules. Each module (or modulefile) contains the information (path settings, environment variables) needed to run the corresponding application. So if you want to use for instance a new application which is not loaded in your environment, you can simply add (or load) the corresponding module to your environment with one of these tools. To do this it is not necessary to read or even to understand the modules.
There are different kinds of modules. Some modules can 'contain' other modules. If you want to know if a module contains more (sub-)modules, read the corresponding information-file of the module. The information-files can be found on the page, All available Unix applications.
There are a few modules, which cause their application(s) to be automatically started up when the window system is started. The names of these modules contain the word 'start'. The modules Tios/DefaultSettings and Tios/DefaultEnvironment contain this kind of sub-modules.

The modules that `define' the environment can be divided in three categories:

1. Those that contain the name `StartIconic' (like in AppStartIconic). When such a module is loaded, the corresponding application is automatically started up as icon, when the window system is started.
   
2. Those that contain the name `StartNonIconic', as in AppStartNonIconic. When such a module is loaded, the corresponding application is automatically started up, and opened, when the window system is started.
   
3. All other modules.
   When such a module is loaded, the corresponding application can be run, from a menu, or from within an (xterm) shell window, but it will not be automagically started.
   For all three categories, when you run the program `make-menu', a 'custom' menu (named `Applications') will be created, that contains entries to start (some of) the applications you have chosen.
   (NOTE: not for all programs menu entries will be created automatically)
   
   The modules are stored in a directory structure (see the page All available Unix applications).
   
   
   Modification by User-setup
   

   To modify your environment with user-setup, you first start `user-setup'.
   
   

4. /Tios/Admin/bin/user-setup
   
   The User-setup program will present you `menus' from which you can select the modules. The menus follow the `directory' structure in the module names. After you have selected one or more entries from a sub-menu, the 'done' entry will return you to the `main' menu. In the `main' menu you can use `show' to see which modules you have chosen so far, `apply' to apply your selection, or `q' to quit without making changes.
   There are two modules that you have to load, one for Unix, and one for the Window System, if they've not yet been loaded in your environment. You can verify that by selecting 'show'. These modules are necessary, because almost all applications that you might want to use depend on them. The corresponding modules are Unix/Sunos and Window/Openwin. So if the modules have not been loaded yet, then:
   
   
5. Choose Unix/SunOS
   
   
6. Choose done
   
   
7. Choose Window/Openwin
   
   
8. Choose done
   
   
9. Choose other modules for loading or unloading them
   
   When you have made your selection,
   
   
10. Choose `apply'
    
    Then the selection is available. When you are finished with 'user-setup' you will have to
    
    
11. Logout
    
    
12. Login
    
    Then you get the new working environment.
    Ater logging in, it is most likely you want to run `make-menu' to update your `Applications' menu.
    
    
13. /Tios/Admin/bin/make-menu
    
    For people, who want to know more about User-setup, more information is available in the manual pages.
    
    Modification by Modules
    

    The tool Modules is more for the experienced user. The environment can be modified by using the using the module command. The module commands are composed of:

    module [sub-command] [module...]
    Note: for the modulefile the name of the corresponding application has to be filled in, with its directory.
    
    The most-used sub-commands are:
    • add (or load)
      With this sub-command modules can be loaded. This function first checks if the module isn't already loaded. If it is then the function prints a error message.
      
      
    • rm (or unload)
      With this sub-command modules can be removed. This function is very similar to the add function. Each argument (module) is checked to verify if the module is actually loaded. If it is then it will be removed from your current environment.
      
      
    • switch (or swap)
      For this sub-command two modules have to be given. The function is switches modules. Only modules, which defines themselves as compatible with another module can be switched.
      
      
    • show (or display)
      This sub-command displays the information about the corresponding module, which is given as argument.
      
      
    • initadd and initrm
      These sub-commands are used to change the user initialization files. The sub-command initadd adds the module to the shell's initialization file in the user's home directory and the initrm removes the module from it.
      
      
    • list
      This command just displays a list of all loaded modules.
      
      
    • help
      The help sub-command without arguments gives a list of all available sub-commands with description. If the command help is followed by a module, then a description only given of the corresponding module.
      
      
    • avail [path...]
      This sub-command gives an overview of available modules. Note that the argument for this command is a path and not a module.
    When you are finished with the tool, Modules, you will have to
    
    
14. Logout
    
    
15. Login
    
    Then you get the new working environment.
    After logging in, it is most likely you want to run `make-menu' to update your `Applications' menu.
    
    
16. /Tios/Admin/bin/make-menu
    
    For people, who want to know more about modules, more information is available in the manual pages.
    
    

    ---