Document:     IRSERVER

Purpose:      Describes the IRAS data server interface.

Category:     IRAS, SYSTEM

File:	      irserver.c

Author:       A.R.W. de Jonge

Description:  The irserver routines are an interface between files on a IRAS
	      data server and the GIPSY environment.

	      The IRAS data are stored on the server as files with a FITS
	      structure. The IRSERVER_OPEN or IRSERVER_SCAN routines
	      can be used to collect one or more of these data files into a
	      scratch directory, making it (read-only) accessable for the
	      FITS routines (see FTS_IO.DC2).
	      The routine IRSERVER_CLOSE subsequently destroys this
	      directory, reclaiming the space.

	      An example of use would be:

		mtid = IRSERVER_OPEN ( ... )		| select data
		REPEAT
			FTSD_GETH ( mtid, ... ) 	| read header
			...
			FTSI_GETR ( mtid, ... ) 	| read data
			...
			skip = FTS_SKIPFIL ( mtid, 1 )	| next file
		UNTIL ( skip .eq. -13 ) 		| (if present)
		IRSERVER_CLOSE ( mtid ) 		| clean up scratch space

	      Additional utility routines present in the interface are:

	      IRSERVER_SEARCH	Searches the IRAS index file

	      Each routine is described in more detail in the
	      appropriate document.

	Related Docs: mtiodev.dc2, fts_io.dc2

Updates:      Jul 13, 1993: AdJ Added irserver_scan
	      Nov 28, 1991: AdJ Check on existence of retrieved files
	      Aug 23, 1991: AdJ Document created.
	      May  4, 2007: JPT Renamed index to indexf.
	      Aug 11, 2009: JPT Renamed getline to GetLine