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

    The First Order Linear Recurrence - Multiplication and Addition
    - Last Value routine provides a vectorized algorithm for the
    linear recurrence relation that includes both multiplication and
    addition operations. Only the last value computed is stored.

    Format

      MTH$VJFOLRLP_MA_V5  n,a,inca,b,incb,t

      MTH$VFFOLRLP_MA_V5  n,a,inca,b,incb,t

      MTH$VDFOLRLP_MA_V5  n,a,inca,b,incb,t

      MTH$VGFOLRLP_MA_V5  n,a,inca,b,incb,t

      MTH$VJFOLRLN_MA_V5  n,a,inca,b,incb,t

      MTH$VFFOLRLN_MA_V5  n,a,inca,b,incb,t

      MTH$VDFOLRLN_MA_V5  n,a,inca,b,incb,t

      MTH$VGFOLRLN_MA_V5  n,a,inca,b,incb,t

      To obtain one of the preceding formats, substitute the
      following for x and y in MTH$VxFOLRLy_MA_V5:

      x  =  J for longword integer, F for F-floating, D for D-
            floating, G for G-floating
      y  =  P for a positive recursion element, N for a negative
            recursion element

1 - Returns

    OpenVMS usage:longword_signed or floating_point
    type:         longword integer (signed), F_floating, D_floating
                  or G_floating
    access:       write only
    mechanism:    by value

    The function value is the result of the last iteration of the
    linear recurrence relation. The function value is returned in R0
    or R0 and R1.

2 - Arguments

 n

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

    Length of the linear recurrence. The n argument is the address of
    a signed longword integer containing the length.

 a

    OpenVMS usage:longword_signed or floating_point
    type:         longword integer (signed), F_floating, D_floating,
                  or G_floating
    access:       read only
    mechanism:    by reference, array reference

    Array of length at least:

    1+(n-1)*inca

    where:

    n   =  length of the linear recurrence specified in n
    inca=  increment argument for the array a specified in inca

    The a argument is the address of a longword integer or floating-
    point that is this array.

 inca

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

    Increment argument for the array a. The inca argument is the
    address of a signed longword integer containing the increment
    argument. For contiguous elements, specify 1 for inca.

 b

    OpenVMS usage:longword_signed or floating_point
    type:         longword integer (signed), F_floating, D_floating,
                  or G_floating
    access:       read only
    mechanism:    by reference, array reference

    Array of length at least:

    1+(n-1)*incb

    where:

    n   =  length of the linear recurrence specified in n
    incb=  increment argument for the array b specified in incb

    The b argument is the address of a longword integer or floating-
    point number that is this array.

 incb

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

    Increment argument for the array b. The incb argument is the
    address of a signed longword integer containing the increment
    argument. For contiguous elements, specify 1 for incb.

 t

    OpenVMS usage:longword_signed or floating_point
    type:         longword integer (signed), F_floating, D_floating,
                  or G_floating
    access:       modify
    mechanism:    by reference

    Variable containing the starting value for the recurrence;
    overwritten with the value computed by the last iteration of
    the linear recurrence relation. The t argument is the address of
    a longword integer or floating-point number that is this value.