XMM-Newton Science Analysis System
taskmain (taskmain-1.90) [xmmsas_20080701_1801-8.0.0]
Meta Index / Home Page / User information
Command line options
Common options
All SAS tasks support the following command line options:
- -c
-
- --noclobber
- No clobber; Datasets are not overwritten.
- -d
-
- --dialog
- Presents the user with a Graphical Interface for
task specific parameters.
Only available in SAS distribution with shared libraries!
- -h
-
- --help
- Provide information about the command line options.
- -m
-
- --manpage
- Displays the HTML documentation for the task. Requires Netscape.
- -p
-
- --param
- Print all parameters with their default and current value and exits the task.
If any mandatory parameters, an error message is issued.
- -t
-
- --trace
- Turn on tracing information from the libraries.
- -V level
-
- -verbosity level
- Set the verbosity level of the task, as handled by package error.
- -v
-
- --version
- Print the version number of the task.
- -w [code|n]
-
- --warning [code|n]
- Suppresses warning messages (handled by package error),
and at the end of the task, it produces
information about how many times a particular warning is silenced.
Multiple occurrences of this option are allowed.
If no argument is given, this option suppresses all warnings.
The argument can be a warning code, e.g. NoAttitudeData will
suppress all warnings of type NoAttitudeData.
If the argument is a number, only the first n warnings are showed
for each type of warning; all subsequent warnings are silenced.
Example:-w 10 -w LowDisk
This will suppress all warnings of type LowDisk;
all other warnings are shown only the first 10 times each.
OAL specific options
If the task uses the ODF Access Layer (oal) the
following command line option is recognized as well:
- -o odf
-
- --odf odf
- Specify the Observation Data File that is to be
accessed by
the oal. odf can be the name of an ODF summary file as
created by the task odfingest
or merely the name of a directory
containing one. In the latter case the summary file is assumed to
have a name ending in either *SUM.ASC or *SUM.SAS. If both
are present *SUM.ASC is ignored. The parameter's value supersedes
any assignments made to the environment variable
SAS_ODF
which is inspected by the oal
for the ODF location
if -odf is omitted.
CAL specific options
If the task uses the Calibration Access Layer (cal) the
following command line options are recognized as well:
- -a dir1[:dir2:...]
-
- --ccfpath dir1[:dir2:...]
- A colon separated list of directories
that define a search path along which CCF constituents are to be sought.
Please note: If a CCF replacement file is passed via --ccffiles
with its full absolute path any specified search path is not
considered in trying to access this constituent.
- -f f1 ...
-
- --ccffiles f1 ...
- White-space, comma, or colon separated list of
CCF constituents to replace the corresponding ones in the CCF pointed at
via the --ccf command line option or the environment
variable SAS_CCF (see below); each specified file must be a valid CCF
constituent according to the CCF ICD.
- -i cifname
-
- --ccf cifname
- cifname is the name of a data set comprising
a table with the name CALINDEX. This will normally be a
Calibration Index File (CIF) created by the task cifbuild.
cifname can also be the name of a directory. In this case
the CALINDEX table is sought in a data set with the default
name ccf.cif in the specified directory.
The parameter's value supersedes
any assignments made to the environment variable
SAS_CCF
which is inspected by the cal
for the CIF location
if -ccf is omitted.
Task specific options
All tasks may have additional parameters in a parameter file, that can be set on the command line (more information can be found in package param).
- param=value
-
- --param=value
- Set the value of parameter param to value
XMM-Newton SOC/SSC -- 2008-07-01