| 20 |
|
<a name=QS> |
| 21 |
|
<h1>Configuration Environment</h2></a> |
| 22 |
|
Each development area has associated with it an environment which is related to |
| 23 |
< |
the tools specified in the configuration, and the environmental variables |
| 24 |
< |
specified in your Project Runtime Document. If you wish to set project wide |
| 25 |
< |
values create a document called <em>Runtime</em> in your project configuration |
| 26 |
< |
directory. This document is a <a href=#RD>Runtime Document</a> |
| 27 |
< |
|
| 23 |
> |
the tools specified in the configuration, and the environment variables |
| 24 |
> |
specified in your Project Runtime Document. If you wish to set project-wide |
| 25 |
> |
values, create a document called <em>Runtime</em> in your project configuration |
| 26 |
> |
directory. This document is a <a href=#RD>Runtime Document</a> |
| 27 |
|
<p> |
| 28 |
< |
The environment can seen |
| 30 |
< |
using the |
| 28 |
> |
The environment can be seen using the command |
| 29 |
|
<p> |
| 30 |
< |
<em> |
| 30 |
> |
<pre> |
| 31 |
|
scram runtime [-csh|-sh] |
| 32 |
< |
</em> |
| 32 |
> |
</pre> |
| 33 |
|
<p> |
| 34 |
< |
command. Running the command as is will print the commands to the standard |
| 34 |
> |
Running this command will print the commands to the standard |
| 35 |
|
output in either the csh or sh flavours. Note that it will not actually |
| 36 |
|
run the commands - just print them. See scram runtime help for some examples |
| 37 |
|
of using this command. |
| 48 |
|
configuration described above. The runtime mechanism supports |
| 49 |
|
this through the use of the <Runtime> tag. |
| 50 |
|
<p> |
| 51 |
< |
Note that this means the Configuration Environment descriped above needs to |
| 51 |
> |
Note that this means the Configuration Environment described above needs to |
| 52 |
|
be set in addition. |
| 53 |
+ |
<p> |
| 54 |
|
<li><h2>Setting an application environment</h2> |
| 55 |
|
<pre> |
| 56 |
|
scram runtime [-csh|-sh] runtimefile |
| 57 |
|
</pre> |
| 58 |
|
The file runtimefile is searched for in the following order : |
| 59 |
+ |
<p> |
| 60 |
|
<ol> |
| 61 |
|
<li>filename relative to current directory |
| 62 |
|
<li>filename relative to local_area/src |
| 64 |
|
<li>location of a BuildFile relative to local_area/src |
| 65 |
|
<li>location of a BuildFile relative to release_area/src |
| 66 |
|
</ol> |
| 67 |
+ |
<p> |
| 68 |
|
<li><h2>Information on Runtime Variables</h2> |
| 69 |
|
<p> |
| 70 |
< |
<em> |
| 70 |
> |
To print out any help available to describe the variables in the file, run the command |
| 71 |
> |
<br> |
| 72 |
> |
<pre> |
| 73 |
|
scram runtime info runtimefile [variable] |
| 74 |
< |
</em> |
| 74 |
> |
</pre> |
| 75 |
|
<p> |
| 76 |
< |
Will print out any help available to describe the variables in the file |
| 74 |
< |
The optional variable will restrict the output to the specified variable. |
| 76 |
> |
The option <em>variable</em> will restrict the output to the specified variable only. |
| 77 |
|
</ul> |
| 78 |
|
|
| 79 |
|
<a name=RD> |
| 80 |
|
<h1>Constructing Runtime Environment Documents</h1> |
| 81 |
< |
An environmental variable in the runtime is indicated by |
| 81 |
> |
An environment variable in the runtime file is indicated by |
| 82 |
|
<p> |
| 83 |
|
<font color=green> |
| 84 |
|
<Runtime name=<em>VARIABLE</em> value=<em>value1</em> [type=path]><br> |
| 85 |
|
Descriptive text of the variable - provides help to the users!<br> |
| 86 |
|
</Runtime> |
| 87 |
|
</font><p> |
| 88 |
< |
Groups are not yet supported by the runtime mechanism. |
| 88 |
> |
|
| 89 |
|
<! Style Sheet Footer ---------------Do not change anything after this line--> |
| 90 |
|
<hr> |
| 91 |
|
<table border=1 width=100%> |
