 
      CALL SEQUENCE...
       ytox  X Y Z INPUT OUTPUT [ -name 1 / 2 ]
 
 
      AUTHORS - B.Dugas, Sept 2004.
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/ytox.ptn,v 4.3 2008/05/03 21:09:02 dugas Exp $
 
 
      DESCRIPTION...
       A FILE ARITHMETIC PROGRAM WHICH...
 
       ... PRODUCES FILE Z = Y**X
 
 
      NOTES:  1) X AND Y MAY CONTAIN REAL OR COMPLEX DATA.
              2) FOR REAL DATA, THAT OF Y CANNOT BE NEGATIVE.
              3) 0**0 = 1, RATHER THAN BE INDETERMINATE.
              4) 0**X = 0, WHEN X.NE.0.
              5) WHEN THE THE NAMES OF CORRESPONDING VARIABLES
                 IN X AND Y ARE DIFFERENT, THE PROGRAM WILL REPLACE
                 THEN WITH 'YTOX', INDICATING THAT THIS OPERATION WAS
                 PERFORMED. THIS DEFAULT BEHAVIOR CAN BE AVOIDED BY
                 SPECIFYING THE "-name" COMMAND-LINE ARGUMENT WITH
                 A VALUE OF THE ORDINAL OF THE INPUT FILE WHOSE
                 NAMES SHOULD BE KEPT.
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        1 NOT AS MANY ARRAYS IN FILE Y AS IN FILE X
        2 MORE THAN ONE SIZE FOR ARRAYS IN X AND/OR Y
        3 NEGATIVE REAL DATA IN FILE Y
        4 UNABLE TO READ FILE X
        5 UNABLE TO READ FILE Y
