Документ взят из кэша поисковой машины. Адрес оригинального документа : http://xmm.vilspa.esa.es/sas/8.0.0/doc/ftools.ps.gz Дата изменения: Wed Jul 2 03:59:58 2008 Дата индексирования: Tue Oct 2 02:58:46 2012 Кодировка: Поисковые слова: south pole

XMM-Newton Science Analysis System Page: 1
FTOOLS
July 1, 2008
Abstract
This package conatins parameter les and layout les for some common FTOOLS,
so that they can be run from the SAS Graphical User Interface (GUI).
1 Running FTOOLS
The SAS GUI provides limited support for running FTOOLS, in additional to native SAS tasks, although
they are naturally not as well integrated.
This package contains SAS parameter les and layout les for some common FTOOLS. These customise
the parameter dialogs to make best use of the SAS GUI.
When the FTOOL is started from the GUI, it is passed a command line containing a complete set of
parameters as dened in the custom parameter le. The parameter type in the custom SAS parameter le
can, for example, be an SAS `le' or `set', when the FTOOL parameter le species a `string' parameter.
The FTOOL interprets the parameters using its own parameter les.
There are some limitations on the use of FTOOLS (see below).
2 Conguration
The directory $SAS DIR/cong/ftools should be placed at the start of your SAS PATH:
setenv SAS_PATH $SAS_DIR/config/ftools:$SAS_DIR
This causes the supported FTOOLS to appear on an `ftools' sub-menu of the `Task' menu.
The SAS GUI should not be placed in the background (with `&') when it is started. It is then possible to
respond to prompts from tools, by typing in the terminal window from which the SAS GUI was started.
3 Limitations
Please note the following limitations:
xmmsas 20080701 1801-8.0.0

XMM-Newton Science Analysis System Page: 2
 FTOOLS do not allow string parameters to be assigned an empty string on the command
line. For example, the following is not allowed.
fxxx foo='' bar=42
is parsed as:
fxxx foo='bar=42'
Consequently empty string parameters should be avoided in the parameter dialogs. The
customised parameter les in this package use a single space " " or a question mark "?" to
avoid this problem. You should be aware that if this character is deleted, the FTOOL can
incorrectly parse the resulting command line.
 The user can only respond to prompts from a task by typing in the terminal window from
which the SAS GUI was started (provided that the GUI was not placed in the background).
However, prompting should not normally occur, because the GUI provides all task param-
eters when it launches an FTOOL. A tool may sometimes prompt for input as a result of
incorrectly parsing an empty string argument. Note also that the SAS GUI line-buers out-
put from a task; consequently prompts are not displayed until after the response has been
typed!
 The GUI enforces the types of parameters. For exmaple, it is not possible to enter a string
for a numeric parameter. Similarly, `INDEF' cannot be used to denote an undened value.
Numerical parameters requiring `INDEF' should be treated as string paramters by the GUI.
 The GUI does not use the PFILES environment variable to locate FTOOLS parameter
les. Some FTOOLS set parameters in the PFILES directory. When run from the GUI, an
FTOOL uses its own parameter le to determine the type of each parameter, but ignores the
default values in its parameter les, because the GUI species all paraeters on the command
line.
References
xmmsas 20080701 1801-8.0.0