catremote is invoked by simply typing:
Arguments may be supplied on the command line or prompted for. Obviously, if
catremote is being
invoked from a script the arguments will usually be supplied on the command line.
The first command-line argument is the mode of operation. The permitted values are listed in Table 2.
The mode can only be specified on the command line. If it is omitted then ‘
help’ mode is
The subsequent arguments required depend on the mode chosen and are summarised in Table 3.
Command line arguments are identified by position. They may optionally be omitted, starting at the
right. Omitted arguments will usually be prompted for. Exceptions are the server-type in
any additional-condition in
query mode and the mode itself (see below). For each mode the input
required and output produced is described below.
| ||db-name radius additional-condition|
| ||db-name object-name|
listmode has a single optional argument, the server-type. The values permitted are listed in Table 4 (and SSN/75 gives more details of the individual types).
catremotelists all the databases in the current configuration file which match the given server-type. If the argument is omitted then ‘
all’ is assumed (that is, all the databases in the configuration file are listed).
For each database, the first item is its name, the second its server type and the rest of the line gives a short description.
detailsmode has a single input argument, db-name; the name of the database for which the details are to be shown (see Section 2). This database must be included in the current configuration file.
| ||name of the database|
| ||server type of the database (see Table 4)|
| ||a short description of the database|
| ||URL of the database server|
| ||columns on which range searches are supported|
| ||URL of help page for the database|
See SSN/75 for a description of each item.
querymode has the arguments described below. Any arguments which are omitted will be prompted for, with the exception of additional-condition. Thus, if an additional-condition is specified then all the arguments must be included on the command line.
:’) as the separator.
:’) as the separator. Southern Declinations are negative.
and objects will only be selected if their value for column column-name lies between minimum-value and maximum-value. The second is:
here the range is assumed to be a magnitude and no column name is specified (remember that magnitudes increase the ‘wrong way round’ so that minimum-magnitude corresponds to the brightest object). The third is:
which is again assumed to be a magnitude and only objects brighter than maximum-magnitude are selected. For completeness, the relationship between the forms of additional-condition and the ‘query tokens’ for the database specified in the configuration file (as described in SSN/75) is that additional-condition replaces the tokens as follows:
catremotedisplays a line showing the name of the file created, for example:
If the catalogue contained no objects which satisfied the query
catremote will report:
namemode has the following two arguments. If they are omitted then they will be prompted for.
simbad_ns@eso, the SIMBAD name resolver provided by ESO using the SIMBAD2 integrated database maintained by the Centre de Données astronomiques de Strasbourg (CDS).
simbad_ns@esoand probably will not be significant for other name resolvers.
The Right Ascension is in sexagesimal hours, the Declination in sexagesimal degrees and both
are for equinox J2000. If the name could not be resolved then