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

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

    Format

      MTH$VJFOLRLP_M_V2  n,a,inca,t

      MTH$VFFOLRLP_M_V2  n,a,inca,t

      MTH$VDFOLRLP_M_V2  n,a,inca,t

      MTH$VGFOLRLP_M_V2  n,a,inca,t

      MTH$VJFOLRLN_M_V2  n,a,inca,t

      MTH$VFFOLRLN_M_V2  n,a,inca,t

      MTH$VDFOLRLN_M_V2  n,a,inca,t

      MTH$VGFOLRLN_M_V2  n,a,inca,t

      MTH$VJFOLRLP_A_V2  n,a,inca,t

      MTH$VFFOLRLP_A_V2  n,a,inca,t

      MTH$VDFOLRLP_A_V2  n,a,inca,t

      MTH$VGFOLRLP_A_V2  n,a,inca,t

      MTH$VJFOLRLN_A_V2  n,a,inca,t

      MTH$VFFOLRLN_A_V2  n,a,inca,t

      MTH$VDFOLRLN_A_V2  n,a,inca,t

      MTH$VGFOLRLN_A_V2  n,a,inca,t

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

      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
      z  =  M for multiplication, A for addition

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:

    n*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.

 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.