XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


taskmain (taskmain-2.2) [xmmsas_20230412_1735-21.0.0]


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 -- 2023-04-16