 
      CALL SEQUENCE...
       xlin  XIN XOUT INPUT OUTPUT [ -a    VAL1 -b   VAL2
                                     -name VAL3 -npg VAL4 ]
 
 
      AUTHORS - R.Laprise ET J.D.Henderson, MAY 14 1983.
      LAST REVISION: $Header: /data/armnraid1/cvs/RMNLIB/utils/rdiag/lspgm/xlin.ptn,v 4.14 2011/02/10 16:55:49 dugas Exp $
 
 
      DESCRIPTION...
       A CCC FILE ARITHMETIC PROGRAM WHICH...
 
       ... PRODUCES FILE XOUT = A*XIN + B
           (WHERE BOTH XIN AND XOUT MAY CONTAIN REAL OR COMPLEX
            DATA TYPES, BUT B MUST BE 0.0 FOR COMPLEX FILES)
 
 
      PARAMETERS...
 
       A    = REAL MULTIPLICATIVE CONSTANT. 
       B    = REAL ADDITIVE CONSTANT. 
       NAME = NEW NAME TO BE GIVEN TO THE OUTPUT RECORDS.
              DEFAULTS TO THE ORIGINAL NAME
       NPG  = (OPTIONAL) OUTPUT PACKING DENSITY
 
       NOTE: IF *BOTH* A AND B ARE LEFT UNSPECIFIED (AND NOT 0), *AND*
             IF THE PROGRAM IS INVOKED IN COMMAND-LINE PARAMETER MODE,
             THEN A AND B ARE SET TO +1.0 AND 0.0, RESPECTIVELY.
 
       READ( 5,5010 ) A,B,NAME,NPG
 5010  FORMAT(10X,2E10.0,1X,A4,I5)
 
 
      NOTE THAT MISSING VALUE TREATMENT IS SUPPORTED VIA EITHER
      THE "MISSING_VALUE" ENVIRONMENT VARIABLE OR THE "-mvalue"
      COMMAND-LINE ARGUMENT. PLEASE SEE THE R.DIAG WEB
      DOCUMENTAION FOR MORE DETAILS.
 
 
      EXAMPLE OF INPUT CARD...
 
  XLIN          -1.0     1000. NAME
 
         0123456789012345678901234567890123456789012345678901234567890
         1         2         3         4         5         6         7
 
 
      EXIT CONDITIONS...
        0 NO PROBLEMS
        2 DATA TYPE IS COMPLEX AND B CONSTANT IS NOT ZERO
        3 ERROR READING INPUT PARAMETERS
        4 PREMATURE EOF ON XIN
