CCSD3ZF0000100000001NJPL3IF0PDS200000001 = SFDU_LABEL RECORD_TYPE = STREAM PRODUCT_CREATION_TIME = 1991-08-10 OBJECT = TEXT NOTE = "Description of software provided with the Magellan ARCDR CD-ROM set" END_OBJECT = TEXT END ARCDR Display Software This directory contains software which can be used to access the binary altimetry and radiometry data files on ARCDR CD-ROM disks. The software comes in two forms: * a program called ARCDRLST which generates ASCII listings of selected ARCDR fields. This program is described in the ARCDRLST.TXT file. * a subroutine library called MGMLIB whose routines can be called by higher-level user-written software to read, write, and update binary data records and fields. They are documented in the MGMLIB.TXT file, which is also present as a UNIX manual file in MGMLIB.MAN. NOTE: there also exists a public domain software package called MGMDQE that displays ARCDR data files on Sun SPARCstations using the SunView interface. This code will also execute under the OpenWindows interface, but it is NOT a true X Window application. Internet users can copy it via anonymous ftp from the "delcano.mit.edu" server [18.75.0.80] in the file named "mgn/bin/mgmdqe.vvvv.sparc.tar.Z", where "vvvv" represents the latest version number. This file should be copied in BINARY mode. Users without Internet access should contact one of the people mentioned at the end of the AAREADME.TXT file on this disk. Installation Instructions APPLE MACINTOSH The file ARCDRLST.HQX contains a "Stuffit" archive that has been translated to ASCII characters using the BinHex algorithm. First copy the file to a Macintosh. Then run the Stuffit program, version 1.5, or later. First select the "Decode BinHex" action in the "Others" menu. This transforms ARCDRLST.HQX into a Stuffit Archive file named "ArcdrLst.sit". Then select "Open Archive" from the "File" menu. Stuffit lists the contents of the archive: ArcdrLst - Application ArcdrLst Word - MS-WORD documentation file arcdr.h - C-language header file arcdrlst.c - C-language source file for ArcdrLst Run ARCDRLST by double-clicking the Application file. A new window will appear, it will fill with instructions, ending with an "arcdr> prompt. Refer to the MS-WORD document, or to ARCDRLST.TXT on the ARCDR CD-ROM for further information. MS-DOS The file ARCDRLST.EXE should be copied to a subdirectory which is in your computer's PATH table. This will allow it to be invoked from any subdirectory on any hard disk or CD-ROM drive. Optionally, ARCDRLST can be executed directly from the CDROM. This program uses the ANSI console driver. If you have a CONFIG.SYS file on your boot disk, check that it contains the line DEVICE=ANSI.SYS If not, add it. If necessary, create a new CONFIG.SYS file. Then reboot your computer for the change to take effect. Finally, execute the program by typing ARCDRLST. NOTE: You may also compile the C-language source files. You'll need to define the LSB variable in ARCDRLST.C. Although MGMLIB.C has been compiled under MS-DOS, several of the subroutines use large buffers which may not fit within the conventional MS-DOS memory model. UNIX The following instructions apply to most flavors of UNIX derived from the Berkeley distributions, e.g. Ultrix, SunOS, etc. The details may be slightly different on other systems. The following example assumes that the CD-ROM is mounted on "/cdrom" and that you have write permission to the current working directory. You should compile the sources as follows: # cp /cdrom/software/arcdrlst.c /cdrom/software/arcdr.h . # cc -O -o arcdrlst arcdrlst.c -ltermcap # cc -O -c mgmlib.c Within the source code, a set of conditional compilation instructions should generate correct code on Sun, Vax, NeXT, and DecStation (MIPS). Some changes may be necessary when installing on other systems. For instance, the LSB variable should be defined when the sources are compiled on unrecognized machines that store their integers in increasing order of byte significance, and the TERMCAP variable should be un-defined if the "termcap" library is unavailable. Finally, copy the executable "arcdrlst" to a directory within your $PATH list, copy the manual file "mgmlib.man" to a manual directory, e.g. /usr/local/man, and save the object "mgmlib.o" for linking with your own programs. VMS: The following example assumes that the CD-ROM is mounted on "CD0:" and that you have write permission to the current working directory. You should compile the sources as follows: $ COPY CD0:[SOFTWARE]*.C *.* $ COPY CD0:[SOFTWARE]*.H *.* $ CC ARCDRLST $ LINK ARCDRLST,SYS$LIBRARY:VAXCRTL/LIB Finally, copy the executable ARCDRLST.EXE that you've just created (not the file if this name in the [SOFTWARE] directory, which is an MS-DOS module) to a directory within your execution path, and save the MGMLIB.OBJ for linking with your own program. --------------------------------- @(#)software.txt MgnAlt 2.3 (MIT/CSR) 5/7/92