 
      CALL SEQUENCE...
       joiner  INA INB OUT OUTPUT
 
 
      DESCRIPTION...
       joiner - JOINS TWO FILES. RESULT HAS ASCENDING STEP NUMBERS.
 
 
      AUTHOR  - J.D.Henderson, FEB 13/80.
      LAST REVISION: $Header: /home/cvs/RMNLIB/utils/rdiag/lspgm/joiner.ptn,v 4.9 2014/09/25 20:20:50 dugas Exp $
 
 
      PURPOSE - JOINS TOGETHER TWO TIME ORDERED GCM DIAGNOSTICS FILES INA
                AND INB PUTTING THE RESULTING DATASET ON FILE OUT.
 
      NOTES   - 1) TIMESTEP NUMBERS SHOULD BE INCREASING FROM INA TO INB.
                2) COPYING BEGINS IN INB ONLY WHEN HIGHER STEP NUMBERS ARE
                   READ AND ONLY THE FIRST OF MULTIPLE SAVES IN INB IS SAVED.
                3) THIS PROGRAM CAN RUN ON EITHER GRID OR SPECTRAL FILES.
 
      INPUT FILES...
       INA = FIRST  INPUT FILE
       INB = SECOND INPUT FILE
 
      OUTPUT FILE...
       OUT = FILE OF INA,INB JOINED
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 PREMATURE EOF ON INB
        2 PREMATURE EOF ON INA
