zlascl(3S)

NAME
     ZLASCL - multiplie the M by N complex matrix A by the real scalar
     CTO/CFROM

SYNOPSIS
     SUBROUTINE ZLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )

         CHARACTER      TYPE

         INTEGER        INFO, KL, KU, LDA, M, N

         DOUBLE         PRECISION CFROM, CTO

         COMPLEX*16     A( LDA, * )

IMPLEMENTATION
     These routines are part of the SCSL Scientific Library and can be loaded
     using either the -lscs or the -lscs_mp option.  The -lscs_mp option
     directs the linker to use the multi-processor version of the library.

     When linking to SCSL with -lscs or -lscs_mp, the default integer size is
     4 bytes (32 bits). Another version of SCSL is available in which integers
     are 8 bytes (64 bits).  This version allows the user access to larger
     memory sizes and helps when porting legacy Cray codes.  It can be loaded
     by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
     only one of the two versions; 4-byte integer and 8-byte integer library
     calls cannot be mixed.

PURPOSE
     ZLASCL multiplies the M by N complex matrix A by the real scalar
     CTO/CFROM. This is done without over/underflow as long as the final
     result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
     may be full, upper triangular, lower triangular, upper Hessenberg, or
     banded.


ARGUMENTS
     TYPE    (input) CHARACTER*1
             TYPE indices the storage type of the input matrix.  = 'G':  A is
             a full matrix.
             = 'L':  A is a lower triangular matrix.
             = 'U':  A is an upper triangular matrix.
             = 'H':  A is an upper Hessenberg matrix.
             = 'B':  A is a symmetric band matrix with lower bandwidth KL and
             upper bandwidth KU and with the only the lower half stored.  =
             'Q':  A is a symmetric band matrix with lower bandwidth KL and
             upper bandwidth KU and with the only the upper half stored.  =
             'Z':  A is a band matrix with lower bandwidth KL and upper
             bandwidth KU.
     KL      (input) INTEGER
             The lower bandwidth of A.  Referenced only if TYPE = 'B',

     KU      (input) INTEGER
             The upper bandwidth of A.  Referenced only if TYPE = 'B',

     CFROM   (input) DOUBLE PRECISION
             CTO     (input) DOUBLE PRECISION The matrix A is multiplied by
             CTO/CFROM. A(I,J) is computed without over/underflow if the final
             result CTO*A(I,J)/CFROM can be represented without
             over/underflow.  CFROM must be nonzero.

     M       (input) INTEGER
             The number of rows of the matrix A.  M >= 0.

     N       (input) INTEGER
             The number of columns of the matrix A.  N >= 0.

     A       (input/output) COMPLEX*16 array, dimension (LDA,M)
             The matrix to be multiplied by CTO/CFROM.  See TYPE for the
             storage type.

     LDA     (input) INTEGER
             The leading dimension of the array A.  LDA >= max(1,M).

     INFO    (output) INTEGER
             0  - successful exit <0 - if INFO = -i, the i-th argument had an
             illegal value.

SEE ALSO
     INTRO_LAPACK(3S), INTRO_SCSL(3S)

     This man page is available only online.