Document revision date: 19 July 1999
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

OpenVMS VAX RTL Mathematics (MTH$) Manual


Previous Contents Index


MTH$VxFOLRLy_MA_V5

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

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.


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.

Description

MTH$VxFOLRLy_MA_V5 is a group of routines that provide a vectorized algorithm for computing the following linear recurrence relation. (The T on the right side of the equation is the result of the previous iteration of the loop.)

T = +/-T * A(I) + B(I)

Note

Save the contents of vector registers V0 through V5 before you call this routine.

Call this routine to utilize vector hardware when computing the recurrence. As an example, the call from Digital Fortran is as follows:


CALL MTH$VxFOLRy_MA_V5(N,A(K1),INCA,B(K2),INCB,T) 

The preceding Fortran call replaces the following loop:


K1 = ... 
K2 = ... 
DO I = 1, N 
T = {+/-}T * A(K1+(I-1)*INCA) + B(K1+(I-1)*INCB) 
ENDDO 

The arrays used in a FOLR expression must be of the same data type in order to be vectorized and user callable. The MTH$ FOLR routines assume that all of the arrays are of the same data type.

This group of routines, MTH$VxFOLRLy_MA_V5 (and also MTH$VxFOLRLy_z_V2) returns only the result of the last iteration of the linear recurrence relation. This is different from the behavior of MTH$VxFOLRy_MA_V15 (and also MTH$VxFOLRy_z_V8), which save the result of each iteration of the linear recurrence relation in an array.

If you specify 0 for the input increment arguments (inca and incb), the input will be treated as a scalar and broadcast to a vector input with all vector elements equal to the scalar value.


Examples

#1

C    
C    The following Fortran loop computes 
C    a linear recurrence. 
C      
C    G_FLOAT 
     INTEGER N,INCA,INCB,I 
     REAL*8 A(30), B(6), T 
     N = 6 
     INCA = 5 
     INCB = 1 
     T = 78.9847562 
     DO I = 1, N 
     T = -T * A(I*INCA) + B(I*INCB) 
     ENDDO 
 
C      
C    The following call from Fortran to a FOLR 
C    routine replaces the preceding loop. 
C      
C    G_FLOAT 
     INTEGER N,INCA,INCB 
     DIMENSION A(30), B(6), T 
     N = 6 
     INCA = 5 
     INCB = 1 
     T = 78.9847562 
     T = MTH$VGFOLRLN_MA_V5(N, A(INCA), INCA, B(INCB), INCB, T) 
 
      

#2

C    
C    The following Fortran loop computes 
C    a linear recurrence. 
C      
C    G_FLOAT 
     INTEGER N,INCA,INCB,I 
     REAL*8 A(30), B(6), T 
     N = 6 
     INCA = 5 
     INCB = 1 
     T = 78.9847562 
     DO I = 1, N 
     T = T * A(I*INCA) + B(I*INCB) 
     ENDDO 
 
C      
C    The following call from Fortran to a FOLR 
C    routine replaces the preceding loop. 
C      
C    G_FLOAT 
     INTEGER N,INCA,INCB 
     DIMENSION A(30), B(6), T 
     N = 6 
     INCA = 5 
     INCB = 1 
     T = 78.9847562 
     T = MTH$VGFOLRLP_MA_V5(N, A(INCA), INCA, B(INCB), INCB, T) 
 
      


MTH$VxFOLRLy_z_V2

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

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.


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.


Description

MTH$VxFOLRLy_z_V2 is a group of routines that provide a vectorized algorithm for computing one of the following linear recurrence relations. (The T on the right side of the following equations is the result of the previous iteration of the loop.)

T = +/-T * A(I)

or

T = +/-T + A(I)

For the first relation, specify M for z in the routine name to denote multiplication; for the second relation, specify A for z in the routine name to denote addition.

Note

Save the contents of vector registers V0, V1, and V2 before you call this routine.

Call this routine to utilize vector hardware when computing the recurrence. As an example, the call from Digital Fortran is as follows:


CALL MTH$VxFOLRLy_z_V2(N,A(K1),INCA,T) 

The preceding Fortran call replaces the following loop:


K1 = .... 
DO I = 1, N 
T = {+/-}T {+/*} A(K1+(I-1)*INCA) 
ENDDO 

The arrays used in a FOLR expression must be of the same data type in order to be vectorized and user callable. The MTH$ FOLR routines assume that all of the arrays are of the same data type.

This group of routines, MTH$VxFOLRLy_z_V2 (and also MTH$VxFOLRLy_MA_V5) return only the result of the last iteration of the linear recurrence relation. This is different from the behavior of MTH$VxFOLRy_MA_V15 (and also MTH$VxFOLRy_z_V8), which save the result of each iteration of the linear recurrence relation in an array.

If you specify 0 for the input increment argument (inca), the input will be treated as a scalar and broadcast to a vector input with all vector elements equal to the scalar value.


Examples

#1

C    
C    The following Fortran loop computes 
C    a linear recurrence. 
C      
C    D_FLOAT 
     INTEGER I,N 
     REAL*8 A(200), T 
     T = 78.9847562 
     N = 20 
     DO I = 4, N 
     T = -T * A(I*10) 
     ENDDO 
 
C      
C    The following call from Fortran to a FOLR 
C    routine replaces the preceding loop. 
C      
C    D_FLOAT 
     INTEGER N 
     REAL*8 A(200), T 
     T = 78.9847562 
     N = 20 
     T = MTH$VDFOLRLN_M_V2(N-3, A(40), 10, T) 
 
      

#2

C    
C    The following Fortran loop computes 
C    a linear recurrence. 
C      
C    D_FLOAT 
     INTEGER I,N 
     REAL*8 A(200), T 
     T = 78.9847562 
     N = 20 
     DO I = 4, N 
     T = T + A(I*10) 
     ENDDO 
 
C      
C    The following call from Fortran to a FOLR 
C    routine replaces the preceding loop. 
C      
C    D_FLOAT 
     INTEGER N 
     REAL*8 A(200), T 
     T = 78.9847562 
     N = 20 
     T = MTH$VDFOLRLP_A_V2(N-3, A(40), 10, T) 
 
      


Appendix A
Additional MTH$ Routines

The following supported MTH$ routines are not included with the routines in the Scalar MTH$ Reference Section because they are rarely used. The majority of these routines serve to satisfy external references when intrinsic functions in Fortran and other languages are passed as parameters. Otherwise, the functions are performed by inline code.

Table A-1 lists all of the entry point and argument information for the MTH$ routines not documented in the Scalar MTH$ Reference Section of this manual.

Table A-1 Additional MTH$ Routines
Routine Name   Entry Point Information
MTH$ABS   F-floating Absolute Value Routine
  Format: MTH$ABS f-floating
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DABS   D-floating Absolute Value Routine
  Format: MTH$DABS d-floating
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GABS   G-floating Absolute Value Routine
  Format: MTH$GABS g-floating
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HABS   H-floating Absolute Value Routine
  Format: MTH$HABS h-abs-val, h-floating
  Returns: None
  h-abs-val: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IIABS   Word Absolute Value Routine
  Format: MTH$IIABS word
  Returns: word_signed, word (signed), write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$JIABS   Longword Absolute Value Routine
  Format: MTH$JIABS longword
  Returns: longword_signed, longword (signed), write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$IIAND   Bitwise AND of Two Word Parameters Routine
  Format: MTH$IIAND word1, word2
  Returns: word_unsigned, word (unsigned), write only, by value
  word1: word_unsigned, word (unsigned), read only, by reference
  word2: word_unsigned, word (unsigned), read only, by reference
     
MTH$JIAND   Bitwise AND of Two Longword Parameters Routine
  Format: MTH$JIAND longword1, longword2
  Returns: longword_unsigned, longword (unsigned), write only, by value
  longword1: longword_unsigned, longword (unsigned), read only, by reference
  longword2: longword_unsigned, longword (unsigned), read only, by reference
     
MTH$DBLE   Convert F-floating to D-floating (Exact) Routine
  Format: MTH$DBLE f-floating
  Returns: floating_point, D_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$GDBLE   Convert F-floating to G-floating (Exact) Routine
  Format: MTH$GDBLE f-floating
  Returns: floating_point, G_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DIM   Positive Difference of Two F-floating Parameters Routine
  Format: MTH$DIM f-floating1, f-floating2
  Returns: floating_point, F_floating, write only, by value
  f-floating1: floating_point, F_floating, read only, by reference
  f-floating2: floating_point, F_floating, read only, by reference
     
MTH$DDIM   Positive Difference of Two D-floating Parameters Routine
  Format: MTH$DDIM d-floating1, d-floating2
  Returns: floating_point, D_floating, write only, by value
  d-floating1: floating_point, D_floating, read only, by reference
  d-floating2: floating_point, D_floating, read only, by reference
     
MTH$GDIM   Positive Difference of Two G-floating Parameters Routine
  Format: MTH$GDIM g-floating1, g-floating2
  Returns: floating_point, G_floating, write only, by value
  g-floating1: floating_point, G_floating, read only, by reference
  g-floating2: floating_point, G_floating, read only, by reference
     
MTH$HDIM   Positive Difference of Two H-floating Parameters Routine
  Format: MTH$HDIM h-floating, h-floating1, h-floating2
  Returns: None
  h-floating: floating_point, H_floating, write only, by reference
  h-floating1: floating_point, H_floating, read only, by reference
  h-floating2: floating_point, H_floating, read only, by reference
     
MTH$IIDIM   Positive Difference of Two Word Parameters Routine
  Format: MTH$IIDIM word1, word2
  Returns: word_signed, word (signed), write only, by value
  word1: word_signed, word (signed), read only, by reference
  word2: word_signed, word (signed), read only, by reference
     
MTH$JIDIM   Positive Difference of Two Longword Parameters Routine
  Format: MTH$JIDIM longword1, longword2
  Returns: longword_signed, longword (signed), write only, by value
  longword1: longword_signed, longword (signed), read only, by reference
  longword2: longword_signed, longword (signed), read only, by reference
     
MTH$IIEOR   Bitwise Exclusive OR of Two Word Parameters Routine
  Format: MTH$IIEOR word1, word2
  Returns: word_unsigned, word (unsigned), write only, by value
  word1: word_unsigned, word (unsigned), read only, by reference
  word2: word_unsigned, word (unsigned), read only, by reference
     
MTH$JIEOR   Bitwise Exclusive OR of Two Longword Parameters Routine
  Format: MTH$JIEOR longword1, longword2
  Returns: longword_unsigned, longword (unsigned), write only, by value
  longword1: longword_unsigned, longword (unsigned), read only, by reference
  longword2: longword_unsigned, longword (unsigned), read only, by reference
     
MTH$IIFIX   Convert F-floating to Word (Truncated) Routine
  Format: MTH$IIFIX f-floating
  Returns: word_signed, word (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$JIFIX   Convert F-floating to Longword (Truncated) Routine
  Format: MTH$JIFIX f-floating
  Returns: longword_signed, longword (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$FLOATI   Convert Word to F-floating (Exact) Routine
  Format: MTH$FLOATI word
  Returns: floating_point, F_floating, write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$DFLOTI   Convert Word to D-floating (Exact) Routine
  Format: MTH$DFLOTI word
  Returns: floating_point, D_floating, write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$GFLOTI   Convert Word to G-floating (Exact) Routine
  Format: MTH$GFLOTI word
  Returns: floating_point, G_floating, write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$FLOATJ   Convert Longword to F-floating (Rounded) Routine
  Format: MTH$FLOATJ longword
  Returns: floating_point, F_floating, write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$DFLOTJ   Convert Longword to D-floating (Exact) Routine
  Format: MTH$DFLOTJ longword
  Returns: floating_point, D_floating, write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$GFLOTJ   Convert Longword to G-floating (Exact) Routine
  Format: MTH$GFLOTJ longword
  Returns: floating_point, G_floating, write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$FLOOR   Convert F-floating to Greatest F-floating Integer Routine
  Format: MTH$FLOOR f-floating
  JSB: MTH$FLOOR_R1 f-floating
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DFLOOR   Convert D-floating to Greatest D-floating Integer Routine
  Format: MTH$DFLOOR d-floating
  JSB: MTH$DFLOOR_R3 d-floating
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GFLOOR   Convert G-floating to Greatest G-floating Integer Routine
  Format: MTH$GFLOOR g-floating
  JSB: MTH$GFLOOR_R3 g-floating
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HFLOOR   Convert H-floating to Greatest H-floating Integer Routine
  Format: MTH$HFLOOR max-h-float, h-floating
  JSB: MTH$HFLOOR_R7 h-floating
  Returns: None
  max-h-float: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$AINT   Convert F-floating to Truncated F-floating Routine
  Format: MTH$AINT f-floating
  JSB: MTH$AINT_R2 f-floating
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DINT   Convert D-floating to Truncated D-floating Routine
  Format: MTH$DINT d-floating
  JSB: MTH$DINT_R4 d-floating
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$IIDINT   Convert D-floating to Word (Truncated) Routine
  Format: MTH$IIDINT d-floating
  Returns: word_signed, word (signed), write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$JIDINT   Convert D-floating to Longword (Truncated) Routine
  Format: MTH$JIDINT d-floating
  Returns: longword_signed, longword (signed), write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GINT   Convert G-floating to Truncated G-floating Routine
  Format: MTH$GINT g-floating
  JSB: MTH$GINT_R4 g-floating
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$IIGINT   Convert G-floating to Word (Truncated) Routine
  Format: MTH$IIGINT g-floating
  Returns: word_signed, word (signed), write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$JIGINT   Convert G-floating to Longword (Truncated) Routine
  Format: MTH$JIGINT g-floating
  Returns: longword_signed, longword (signed), write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HINT   Convert H-floating to Truncated H-floating Routine
  Format: MTH$HINT trunc-h-flt, h-floating
  JSB: MTH$HINT_R8 h-floating
  Returns: None
  trunc-h-flt: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IIHINT   Convert H-floating to Word (Truncated) Routine
  Format: MTH$IIHINT h-floating
  Returns: word_signed, word (signed), write only, by value
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$JIHINT   Convert H-floating to Longword (Truncated) Routine
  Format: MTH$JIHINT h-floating
  Returns: longword_signed, longword (signed), write only, by value
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IINT   Convert F-floating to Word (Truncated) Routine
  Format: MTH$IINT f-floating
  Returns: word_signed, word (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$JINT   Convert F-floating to Longword (Truncated) Routine
  Format: MTH$JINT f-floating
  Returns: longword_signed, longword (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$IIOR   Bitwise Inclusive OR of Two Word Parameters Routine
  Format: MTH$IIOR word1, word2
  Returns: word_unsigned, word (unsigned), write only, by value
  word1: word_unsigned, word (unsigned), read only, by reference
  word2: word_unsigned, word (unsigned), read only, by reference
     
MTH$JIOR   Bitwise Inclusive OR of Two Longword Parameters Routine
  Format: MTH$JIOR longword1, longword2
  Returns: longword_unsigned, longword (unsigned), write only, by value
  longword1: longword_unsigned, longword (unsigned), read only, by reference
  longword2: longword_unsigned, longword (unsigned), read only, by reference
     
MTH$AIMAX0   F-floating Maximum of N Word Parameters Routine
  Format: MTH$AIMAX0 word, ...
  Returns: floating_point, F_floating, write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$AJMAX0   F-floating Maximum of N Longword Parameters Routine
  Format: MTH$AJMAX0 longword, ...
  Returns: floating_point, F_floating, write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$IMAX0   Word Maximum of N Word Parameters Routine
  Format: MTH$IMAX0 word, ...
  Returns: word_signed, word (signed), write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$JMAX0   Longword Maximum of N Longword Parameters Routine
  Format: MTH$JMAX0 longword, ...
  Returns: longword_signed, longword (signed), write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$AMAX1   F-floating Maximum of N F-floating Parameters Routine
  Format: MTH$AMAX1 f-floating, ...
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DMAX1   D-floating Maximum of N D-floating Parameters Routine
  Format: MTH$DMAX1 d-floating, ...
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GMAX1   G-floating Maximum of N G-floating Parameters Routine
  Format: MTH$GMAX1 g-floating, ...
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HMAX1   H-floating Maximum of N H-floating Parameters Routine
  Format: MTH$HMAX1 h-float-max, h-floating, ...
  Returns: None
  h-float-max: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IMAX1   Word Maximum of N F-floating Parameters Routine
  Format: MTH$IMAX1 f-floating, ...
  Returns: word_signed, word (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$JMAX1   Longword Maximum of N F-floating Parameters Routine
  Format: MTH$JMAX1 f-floating, ...
  Returns: longword_signed, longword (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$AIMIN0   F-floating Minimum of N Word Parameters Routine
  Format: MTH$AIMIN0 word, ...
  Returns: floating_point, F_floating, write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$AJMIN0   F-floating Minimum of N Longword Parameters Routine
  Format: MTH$AJMIN0 longword, ...
  Returns: floating_point, F_floating, write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$IMIN0   Word Minimum of N Word Parameters Routine
  Format: MTH$IMIN0 word, ...
  Returns: word_signed, word (signed), write only, by value
  word: word_signed, word (signed), read only, by reference
     
MTH$JMIN0   Longword Minimum of N Longword Parameters Routine
  Format: MTH$JMIN0 longword, ...
  Returns: longword_signed, longword (signed), write only, by value
  longword: longword_signed, longword (signed), read only, by reference
     
MTH$AMIN1   F-floating Minimum of N F-floating Parameters Routine
  Format: MTH$AMIN1 f-floating, ...
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DMIN1   D-floating Minimum of N D-floating Parameters Routine
  Format: MTH$DMIN1 d-floating, ...
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GMIN1   G-floating Minimum of N G-floating Parameters Routine
  Format: MTH$GMIN1 g-floating, ...
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HMIN1   H-floating Minimum of N H-floating Parameters Routine
  Format: MTH$HMIN1 h-float-max, h-floating, ...
  Returns: None
  h-float-max: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IMIN1   Word Minimum of N F-floating Parameters Routine
  Format: MTH$IMIN1 f-floating, ...
  Returns: word_signed, word (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$JMIN1   Longword Minimum of N F-floating Parameters Routine
  Format: MTH$JMIN1 f-floating, ...
  Returns: longword_signed, longword (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$AMOD   Remainder from Division of Two F-floating Parameters Routine
  Format: MTH$AMOD dividend, divisor
  Returns: floating_point, F_floating, write only, by value
  dividend: floating_point, F_floating, read only, by reference
  divisor: floating_point, F_floating, read only, by reference
     
MTH$DMOD   Remainder from Division of Two D-floating Parameters Routine
  Format: MTH$DMOD dividend, divisor
  Returns: floating_point, D_floating, write only, by value
  dividend: floating_point, D_floating, read only, by reference
  divisor: floating_point, D_floating, read only, by reference
     
MTH$GMOD   Remainder from Division of Two G-floating Parameters Routine
  Format: MTH$GMOD dividend, divisor
  Returns: floating_point, G_floating, write only, by value
  dividend: floating_point, G_floating, read only, by reference
  divisor: floating_point, G_floating, read only, by reference
     
MTH$HMOD   Remainder from Division of Two H-floating Parameters Routine
  Format: MTH$HMOD h-mod, dividend, divisor
  Returns: None
  h-mod: floating_point, H_floating, write only, by reference
  dividend: floating_point, H_floating, read only, by reference
  divisor: floating_point, H_floating, read only, by reference
     
MTH$IMOD   Remainder from Division of Two Word Parameters Routine
  Format: MTH$IMOD dividend, divisor
  Returns: word_signed, word (signed), write only, by value
  dividend: word_signed, word (signed), read only, by reference
  divisor: word_signed, word (signed), read only, by reference
     
MTH$JMOD   Remainder of Two Longword Parameters Routine
  Format: MTH$JMOD dividend, divisor
  Returns: longword_signed, longword (signed), write only, by value
  dividend: longword_signed, longword (signed), read only, by reference
  divisor: longword_signed, longword (signed), read only, by reference
     
MTH$ANINT   Convert F-floating to Nearest F-floating Integer Routine
  Format: MTH$ANINT f-floating
  Returns: floating_point, F_floating, write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$DNINT   Convert D-floating to Nearest D-floating Integer Routine
  Format: MTH$DNINT d-floating
  Returns: floating_point, D_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$IIDNNT   Convert D-floating to Nearest Word Integer Routine
  Format: MTH$IIDNNT d-floating
  Returns: word_signed, word (signed), write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$JIDNNT   Convert D-floating to Nearest Longword Integer Routine
  Format: MTH$JIDNNT d-floating
  Returns: longword_signed, longword (signed), write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$GNINT   Convert G-floating to Nearest G-floating Integer Routine
  Format: MTH$GNINT g-floating
  Returns: floating_point, G_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$IIGNNT   Convert G-floating to Nearest Word Integer Routine
  Format: MTH$IIGNNT g-floating
  Returns: word_signed, word (signed), write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$JIGNNT   Convert G-floating to Nearest Longword Integer Routine
  Format: MTH$JIGNNT g-floating
  Returns: longword_signed, longword (signed), write only, by value
  g-floating: floating_point, G_floating, read only, by reference
     
MTH$HNINT   Convert H-floating to Nearest H-floating Integer Routine
  Format: MTH$HNINT nearst-h-flt, h-floating
  Returns: None
  nearst-h-flt: floating_point, H_floating, write only, by reference
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$IIHNNT   Convert H-floating to Nearest Word Integer Routine
  Format: MTH$IIHNNT h-floating
  Returns: word_signed, word (signed), write only, by value
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$JIHNNT   Convert H-floating to Nearest Longword Integer Routine
  Format: MTH$JIHNNT h-floating
  Returns: longword_signed, longword (signed), write only, by value
  h-floating: floating_point, H_floating, read only, by reference
     
MTH$ININT   Convert F-floating to Nearest Word Integer Routine
  Format: MTH$ININT f-floating
  Returns: word_signed, word (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$JNINT   Convert F-floating to Nearest Longword Integer Routine
  Format: MTH$JNINT f-floating
  Returns: longword_signed, longword (signed), write only, by value
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$INOT   Bitwise Complement of Word Parameter Routine
  Format: MTH$INOT word
  Returns: word_unsigned, word (unsigned), write only, by value
  word: word_unsigned, word (unsigned), read only, by reference
     
MTH$JNOT   Bitwise Complement of Longword Parameter Routine
  Format: MTH$JNOT longword
  Returns: longword_unsigned, longword (unsigned), write only, by value
  longword: longword_unsigned, longword (unsigned), read only, by reference
     
MTH$DPROD   D-floating Product of Two F-floating Parameters Routine
  Format: MTH$DPROD f-floating1, f-floating2
  Returns: floating_point, D_floating, write only, by value
  f-floating1: floating_point, F_floating, read only, by reference
  f-floating2: floating_point, F_floating, read only, by reference
     
MTH$GPROD   G-floating Product of Two F-floating Parameters Routine
  Format: MTH$GPROD f-floating1, f-floating2
  Returns: floating_point, G_floating, write only, by value
  f-floating1: floating_point, F_floating, read only, by reference
  f-floating2: floating_point, F_floating, read only, by reference
     
MTH$SGN   F-floating Sign Function
  Format: MTH$SGN f-floating
  Returns: longword_signed, longword (signed), write only, by reference
  f-floating: floating_point, F_floating, read only, by reference
     
MTH$SGN   D-floating Sign Function
  Format: MTH$SGN d-floating
  Returns: longword_signed, longword (signed), write only, by reference
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$IISHFT   Bitwise Shift of Word Routine
  Format: MTH$IISHFT word, shift-cnt
  Returns: word_unsigned, word (unsigned), write only, by value
  word: word_unsigned, word (unsigned), read only, by reference
  shift-cnt: word_signed, word (signed), read only, by reference
     
MTH$JISHFT   Bitwise Shift of Longword Routine
  Format: MTH$JISHFT longword, shift-cnt
  Returns: longword_unsigned, longword (unsigned), write only, by value
  longword: longword_unsigned, longword (unsigned), read only, by reference
  shift-cnt: longword_signed, longword (signed), read only, by reference
     
MTH$SIGN   F-floating Transfer of Sign of Y to Sign of X Routine
  Format: MTH$SIGN f-float-x, f-float-y
  Returns: floating_point, F_floating, write only, by value
  f-float-x: floating_point, F_floating, read only, by reference
  f-float-y: floating_point, F_floating, read only, by reference
     
MTH$DSIGN   D-floating Transfer of Sign of Y to Sign of X Routine
  Format: MTH$DSIGN d-float-x, d-float-y
  Returns: floating_point, D_floating, write only, by value
  d-float-x: floating_point, D_floating, read only, by reference
  d-float-y: floating_point, D_floating, read only, by reference
     
MTH$GSIGN   G-floating Transfer of Sign of Y to Sign of X Routine
  Format: MTH$GSIGN g-float-x, g-float-y
  Returns: floating_point, G_floating, write only, by value
  g-float-x: floating_point, G_floating, read only, by reference
  g-float-y: floating_point, G_floating, read only, by reference
     
MTH$HSIGN   H-floating Transfer of Sign of Y to Sign of X Routine
  Format: MTH$HSIGN h-result, h-float-x, h-float-y
  Returns: None
  h-result: floating_point, H_floating, write only, by reference
  h-float-x: floating_point, H_floating, read only, by reference
  h-float-y: floating_point, H_floating, read only, by reference
     
MTH$IISIGN   Word Transfer of Sign of Y to Sign of X Routine
  Format: MTH$IISIGN word-x, word-y
  Returns: word_signed, word (signed), write only, by value
  word-x: word_signed, word (signed), read only, by reference
  word-y: word_signed, word (signed), read only, by reference
     
MTH$JISIGN   Longword Transfer of Sign of Y to Sign of X Routine
  Format: MTH$JISIGN longwrd-x, longwrd-y
  Returns: longword_signed, longword (signed), write only, by reference
  longwrd-x: longword_signed, longword (signed), read only, by reference
  longwrd-y: longword_signed, longword (signed), read only, by reference
     
MTH$SNGL   Convert D-floating to F-floating (Rounded) Routine
  Format: MTH$SNGL d-floating
  Returns: floating_point, F_floating, write only, by value
  d-floating: floating_point, D_floating, read only, by reference
     
MTH$SNGLG   Convert G-floating to F-floating (Rounded) Routine
  Format: MTH$SNGLG g-floating
  Returns: floating_point, F_floating, write only, by value
  g-floating: floating_point, G_floating, read only, by reference


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6117PRO_020.HTML