catremote has several different modes of usage, each providing a different function. The modes are:
list - list the catalogues currently available,
details - show details of a named catalogue,
query - submit a query to a remote catalogue and retrieve the results,
name - resolve an object name into coordinates,
help - list the modes available.
There is an introduction to using catremote in SUN/190 and it is comprehensively documented in SSN/76.
catremote list server-type
catremote details db-name
catremote query db-name alpha delta radius additional-condition
catremote name db-name object-name
The individual arguments are described in the `Arguments' section. If the mode is omitted then 'help' mode is assumed.
In addition to the command-line arguments, catremote takes some input from Unix shell environment variables and these variables can be used to control its behaviour.
CATREM_CONFIG (read) This environment variable specifies the configuration file to be used. It should be set to either the URL (for a remote file) or the local file name, including a directory specification (for a local file). Configuration files mediate the interaction between catremote and the remote catalogue; see SSN/76 for further details. (Mandatory.)
CATREM_MAXOBJ (read) The maximum number of objects which the returned table is allowed to contain.
CATREM_ECHOURL (read) This environment controls whether the URL representing the query submitted to the remote catalogue is also displayed to the user. The default is 'no'; to see the URL set CATREM_ECHOURL to 'yes'. Seeing the URL is potentially useful when debugging configuration files and remote catalogue servers but is not usually required for normal operation.
CURSA Catalogue and Table Manipulation Applications