CONV_STSDAS

       Convert internal format of an STSDAS image to host machine architecture

       Converts the internal format of an STSDAS image (.hhh and .hhd file)
       to the host machine architecture.     Useful for copying STSDAS files
       between different machines.     If the host is not a VMS machine, then
       by default CONV_STSDAS assumes the image originated on VMS.   If the
       host is VMS, then CONV_STSDAS assumes that the image originated on
       an IEEE machine (e.g. SparcStation).

       CONV_STSDAS, sdas_name, [ /FROM_IEEE]

       sdas_name - scalar string giving name of the STSDAS image
               CONV_STSDAS assumes a default header extension of .hhh --
               otherwise the header extension should be included in sdas_name.
               The internal format of the file will be modified by CONV_STSDAS.

       /FROM_IEEE - On little endian machines (OSF, windows) this keyword
               indicates that the STSDAS file originated on an IEEE machine
               (e.g SparcStation) rather than a VMS machine

       Suppose files test.hhd and test.hhh have been copied with FTP from
       a Vax to a Sparcstation.   Convert these files to the SparcStation
       internal format.
       IDL> conv_stsdas, 'test'

       CONV_STSDAS reads each group image and parameter block and uses
       IEEE_TO_HOST or CONV_VAX_UNIX to convert the internal format.   The
       converted images and parameter blocks are written back to the orginal
       file.

       sxopen, fdecomp, sxgpar(), sxpar(), ieee_to_host, conv_vax_unix()

       (1)  When copying STSDAS files to VMS, be sure the .hhh file is
               formatted as fixed block 80 byte.
       (2)  CONV_STSDAS has no way of knowing if a file really came from
               a different machine architecture.    If it is applied to a file
               that already has the correct internal format, then CONV_STSDAS
               will "convert" this file and corrupt the internal format.
       (3)  Note that CONV_STSDAS currently does not support conversion *from*
               a little-endian machine (OSF, windows)

       Written   W. Landsman                     January, 1993
       Don't require .hhh extension            April, 1993
       Increase speed by calling SXGINFO       May, 1993
       Converted to IDL V5.0   W. Landsman   September 1997
       Replace DATATYPE() with size(/TNAME)  W. Landsman   November 2001

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]