VMS Help RTL Routines, MTH$, BLAS1$VxSCAL  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Scale the Elements of a Vector routine computes a * x where a
    is a scalar number and x is an n-element vector.

    Format

      BLAS1$VSSCAL  n ,a ,x ,incx

      BLAS1$VDSCAL  n ,a ,x ,incx

      BLAS1$VGSCAL  n ,a ,x ,incx

      BLAS1$VCSCAL  n ,a ,x ,incx

      BLAS1$VCSSCAL  n ,a ,x ,incx

      BLAS1$VZSCAL  n ,a ,x ,incx

      BLAS1$VWSCAL  n ,a ,x ,incx

      BLAS1$VZDSCAL  n ,a ,x ,incx

      BLAS1$VWGSCAL  n ,a ,x ,incx

      Use BLAS1$VSSCAL to scale a real single-precision vector by a
      real single-precision scalar.

      Use BLAS1$VDSCAL to scale a real double-precision (D-floating)
      vector by a real double-precision (D-floating) scalar.
      Use BLAS1$VGSCAL to scale a real double-precision (G-floating)
      vector by a real double-precision (G-floating) scalar.

      Use BLAS1$VCSCAL to scale a complex single-precision vector by
      a complex single-precision scalar.
      Use BLAS1$VCSSCAL to scale a complex single-precision vector by
      a real single-precision scalar.

      Use BLAS1$VZSCAL to scale a complex double-precision (D-
      floating) vector by a complex double-precision (D-floating)
      scalar.
      Use BLAS1$VWSCAL to scale a complex double-precision (G-
      floating) vector by a complex double-precision (G-floating)
      scalar.
      Use BLAS1$VZDSCAL to scale a complex double-precision (D-
      floating) vector by a real double-precision (D-floating)
      scalar.
      Use BLAS1$VWGSCAL to scale a complex double-precision (G-
      floating) vector by a real double-precision (G-floating)
      scalar.

1 - Returns

    None.

2 - Arguments

 n

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Number of elements in vector x to be scaled. The n argument is
    the address of a signed longword integer containing the number of
    elements to be scaled. If you specify a value for n that is less
    than or equal to 0, then x is unchanged.

 a

    OpenVMS usage:floating_point or complex_number
    type:         F_floating, D_floating, G_floating real or
                  F_floating, D_floating, G_floating complex
    access:       read only
    mechanism:    by reference

    Scalar multiplier for the elements of vector x. The a argument is
    the address of a floating-point or floating-point complex number
    that is this multiplier.

    Specify the data type as follows:

    Routine            Data Type for a

    BLAS1$VSSCAL and   F-floating real
    BLAS1$VCSSCAL
    BLAS1$VDSCAL and   D-floating real
    BLAS1$VZDSCAL
    BLAS1$VGSCAL and   G-floating real
    BLAS1$VWGSCAL
    BLAS1$VCSCAL       F-floating complex
    BLAS1$VZSCAL       D-floating complex
    BLAS1$VWSCAL       G-floating complex

    If you specify 1.0 for a, then x is unchanged.

 x

    OpenVMS usage:floating_point or complex_number
    type:         F_floating, D_floating, G_floating real or
                  F_floating, D_floating, G_floating complex
    access:       modify
    mechanism:    by reference, array reference

    Array containing the elements to be accessed. All elements of
    array x are accessed only if the increment argument of x, called
    incx, is 1. The x argument is the address of a floating-point or
    floating-point complex number that is this array. On entry, this
    argument is an array of length at least:

    1+(n-1)*|incx|

    where:

    n   =  number of vector elements specified in n
    incx=  increment argument for the array x specified in incx

    Specify the data type as follows:

    Routine            Data Type for x

    BLAS1$VSSCAL       F-floating real
    BLAS1$VDSCAL       D-floating real
    BLAS1$VGSCAL       G-floating real
    BLAS1$VCSCAL and   F-floating complex
    BLAS1$VCSSCAL
    BLAS1$VZSCAL and   D-floating complex
    BLAS1$VZDSCAL
    BLAS1$VWSCAL and   G-floating complex
    BLAS1$VWGSCAL

    On exit, x is an array of length at least:

    1+(n-1)*|incx|

    where:

    n   =  number of vector elements specified in n
    incx=  increment argument for the array x specified in incx

    After the call to BLAS1$VxSCAL, x[i] is replaced by a * x[i] If
    a shares a memory location with any element of the vector x,
    results are unpredictable.

 incx

    OpenVMS usage:longword_signed
    type:         longword integer (signed)
    access:       read only
    mechanism:    by reference

    Increment argument for the array x. The incx argument is the
    address of a signed longword integer containing the increment
    argument. If incx is greater than 0, then x is referenced forward
    in array x; that is, x[i] is referenced in:

    x(1+(i-1)*incx)

    where:

    x   =  array specified in x
    i   =  element of the vector x
    incx=  increment argument for the array x specified in incx

    If you specify a negative value for incx, it is interpreted as
    the absolute value of incx. If incx equals 0, the results are
    unpredictable.