 
      CALL SEQUENCE...
       sortf  DATA CRITERIA RESULT INPUT OUTPUT [-kind VAL1]
 
 
      AUTHOR - B.Dugas,  31 juillet/95.
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/sortf.ptn,v 4.10 2012/08/29 15:51:34 dugas Exp $
 
 
      DESCRIPTION...
       A PROGRAM WHICH...
 
       ... SORTS THE TIMESETS IN FILE DATA ACCORDING TO THE VALUES
           FOUND IN THE FIRST RECORD OF FILE CRITERIA.
 
       NOTES: 1) THERE SHOULD BE AT MANY TIMESETS IN FILE DATA AS THERE
                 ARE POINTS IN THE RECORD READ FROM FILE CRITERIA
              2) WHEN KIND >= 0, THE PROGRAM WILL ALWAYS TRY TO ALLOCATE
                 ENOUGH MEMORY TO FIT THE FULL FILE DATA.
              3) THE TIMESETS CAN CONTAIN MULTIPLE LEVELS AND/OR MULTIPLE
                 VARIABLES. IN THIS LAST CASE, THE FILE IS SUPPOSED TO BE
                 SORTED ACCORDING TO A TIMESTEP/NAME/LEVEL RULE,
                 FROM MOST TO LEAST SIGNIFICANT
            
 
      INPUT PARAMETER...
       ABS(KIND) =  0,1, TO SORT IN INCREASING ORDER (DEFAULT)
                    2,   TO SORT IN DECREASING ORDER
           KIND  <  0,   TO TREAT TIMESERIES RECORDS INDIVIDUALLY
                 >= 0,   TO TREAT THE WHOLE FILES AS THE TIMESERIES
 
       READ(5,5000) KIND
 5000  FORMAT(10X,I5)
 
 
      EXAMPLE OF INPUT CARD...
 
  SORTF       0
 
         0123456789012345678901234567890123456789012345678901234567890
         1         2         3         4         5         6         7
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 DATA TOO LARGE TO FIT IN MEMORY (KIND >= 0)
        2 UNABLE TO READ FIRST RECORD IN CRITERIA
        3 NOT ENOUGH SETS IN DATA FILE
        4 PREMATURE EOF ON STDIN FILE
        5 PREMATURE EOF ON FILE DATA
        6 PREMATURE EOF ON FILE CRITERIA
        7 MORE THAN ONE SIZE IN TIME SERIES
        8 TIME SERIES AND CRITERIA NOT THE SAME LENGTH
