RTL Routines, MTH$
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help RTL Routines, MTH$ *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
| 1 - MTH$xACOS |
Given the cosine of an angle, the Arc Cosine of Angle Expressed
in Radians routine returns that angle (in radians).
Format
MTH$ACOS cosine
MTH$DACOS cosine
MTH$GACOS cosine
Each of the above formats accepts one of the floating-point
types as input.
1.1 - Corresponding JSB Entry Points
MTH$ACOS_R4
MTH$DACOS_R7
MTH$GACOS_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
1.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in radians. MTH$ACOS returns an F-floating number.
MTH$DACOS returns a D-floating number. MTH$GACOS returns a G-
floating number.
1.3 - Argument
cosine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The cosine of the angle whose value (in radians) is to be
returned. The cosine argument is the address of a floating-point
number that is this cosine. The absolute value of cosine must
be less than or equal to 1. For MTH$ACOS, cosine specifies an
F-floating number. For MTH$DACOS, cosine specifies a D-floating
number. For MTH$GACOS, cosine specifies a G-floating number.
| 2 - MTH$xACOSD |
Given the cosine of an angle, the Arc Cosine of Angle Expressed
in Degrees routine returns that angle (in degrees).
Format
MTH$ACOSD cosine
MTH$DACOSD cosine
MTH$GACOSD cosine
Each of the above formats accepts one of the floating-point
types as input.
2.1 - Corresponding JSB Entry Points
MTH$ACOSD_R4
MTH$DACOSD_R7
MTH$GACOSD_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
2.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in degrees. MTH$ACOSD returns an F-floating number.
MTH$DACOSD returns a D-floating number. MTH$GACOSD returns a
G-floating number.
2.3 - Argument
cosine
OpenVMS usage:floating_point
type: F_floating, G_floating, D_floating
access: read only
mechanism: by reference
Cosine of the angle whose value (in degrees) is to be returned.
The cosine argument is the address of a floating-point number
that is this cosine. The absolute value of cosine must be less
than or equal to 1. For MTH$ACOSD, cosine specifies an F-floating
number. For MTH$DACOSD, cosine specifies a D-floating number. For
MTH$GACOSD, cosine specifies a G-floating number.
| 3 - MTH$xASIN |
Given the sine of an angle, the Arc Sine in Radians routine
returns that angle (in radians).
Format
MTH$ASIN sine
MTH$DASIN sine
MTH$GASIN sine
Each of the above formats accepts one of the floating-point
types as input.
3.1 - Corresponding JSB Entry Points
MTH$ASIN_R4
MTH$DASIN_R7
MTH$GASIN_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
3.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in radians. MTH$ASIN returns an F-floating number.
MTH$DASIN returns a D-floating number. MTH$GASIN returns a G-
floating number.
3.3 - Argument
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The sine of the angle whose value (in radians) is to be returned.
The sine argument is the address of a floating-point number that
is this sine. The absolute value of sine must be less than or
equal to 1. For MTH$ASIN, sine specifies an F-floating number.
For MTH$DASIN, sine specifies a D-floating number. For MTH$GASIN,
sine specifies a G-floating number.
| 4 - MTH$xASIND |
Given the sine of an angle, the Arc Sine in Degrees routine
returns that angle (in degrees).
Format
MTH$ASIND sine
MTH$DASIND sine
MTH$GASIND sine
Each of the above formats accepts one of the floating-point
types as input.
4.1 - Corresponding JSB Entry Points
MTH$ASIND_R4
MTH$DASIND_R7
MTH$GASIND_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
4.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in degrees. MTH$ASIND returns an F-floating number.
MTH$DASIND returns a D-floating number. MTH$GASIND returns a
G-floating number.
4.3 - Argument
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Sine of the angle whose value (in degrees) is to be returned. The
sine argument is the address of a floating-point number that is
this sine. The absolute value of sine must be less than or equal
to 1. For MTH$ASIND, sine specifies an F-floating number. For
MTH$DASIND, sine specifies a D-floating number. For MTH$GASIND,
sine specifies a G-floating number.
| 5 - MTH$xATAN |
Given the tangent of an angle, the Arc Tangent in Radians routine
returns that angle (in radians).
Format
MTH$ATAN tangent
MTH$DATAN tangent
MTH$GATAN tangent
Each of the above formats accepts one of the floating-point
types as input.
5.1 - Corresponding JSB Entry Points
MTH$ATAN_R4
MTH$DATAN_R7
MTH$GATAN_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
5.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in radians. The angle returned will have a value in the
range:
MTH$ATAN returns an F-floating number. MTH$DATAN returns a D-
floating number. MTH$GATAN returns a G-floating number.
5.3 - Argument
tangent
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The tangent of the angle whose value (in radians) is to be
returned. The tangent argument is the address of a floating-point
number that is this tangent. For MTH$ATAN, tangent specifies an
F-floating number. For MTH$DATAN, tangent specifies a D-floating
number. For MTH$GATAN, tangent specifies a G-floating number.
| 6 - MTH$xATAND |
Given the tangent of an angle, the Arc Tangent in Degrees routine
returns that angle (in degrees).
Format
MTH$ATAND tangent
MTH$DATAND tangent
MTH$GATAND tangent
Each of the above formats accepts one of the floating-point
types as input.
6.1 - Corresponding JSB Entry Points
MTH$ATAND_R4
MTH$DATAND_R7
MTH$GATAND_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
6.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in degrees. MTH$ATAND returns an F-floating number.
MTH$DATAND returns a D-floating number. MTH$GATAND returns a
G-floating number.
6.3 - Argument
tangent
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The tangent of the angle whose value (in degrees) is to be
returned. The tangent argument is the address of a floating-point
number that is this tangent. For MTH$ATAND, tangent specifies an
F-floating number. For MTH$DATAND, tangent specifies a D-floating
number. For MTH$GATAND, tangent specifies a G-floating number.
| 7 - MTH$xATAN2 |
Given sine and cosine, the Arc Tangent in Radians with Two
Arguments routine returns the angle (in radians) whose tangent
is given by the quotient of sine and cosine (sine/cosine).
Format
MTH$ATAN2 sine ,cosine
MTH$DATAN2 sine ,cosine
MTH$GATAN2 sine ,cosine
Each of the above formats accepts one of the floating-point
types as input.
7.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in radians. MTH$ATAN2 returns an F-floating number.
MTH$DATAN2 returns a D-floating number. MTH$GATAN2 returns a
G-floating number.
7.2 - Arguments
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Dividend. The sine argument is the address of a floating-point
number that is this dividend. For MTH$ATAN2, sine specifies an
F-floating number. For MTH$DATAN2, sine specifies a D-floating
number. For MTH$GATAN2, sine specifies a G-floating number.
cosine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Divisor. The cosine argument is the address of a floating-point
number that is this divisor. For MTH$ATAN2, cosine specifies an
F-floating number. For MTH$DATAN2, cosine specifies a D-floating
number. For MTH$GATAN2, cosine specifies a G-floating number.
| 8 - MTH$xATAND2 |
Given sine and cosine, the Arc Tangent in Degrees with Two
Arguments routine returns the angle (in degrees) whose tangent
is given by the quotient of sine and cosine (sine/cosine).
Format
MTH$ATAND2 sine ,cosine
MTH$DATAND2 sine ,cosine
MTH$GATAND2 sine ,cosine
Each of the above formats accepts one of the floating-point
types as input.
8.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Angle in degrees. MTH$ATAND2 returns an F-floating number.
MTH$DATAND2 returns a D-floating number. MTH$GATAND2 returns a
G-floating number.
8.2 - Arguments
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Dividend. The sine argument is the address of a floating-point
number that is this dividend. For MTH$ATAND2, sine specifies an
F-floating number. For MTH$DATAND2, sine specifies a D-floating
number. For MTH$GATAND2, sine specifies a G-floating number.
cosine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Divisor. The cosine argument is the address of a floating-point
number that is this divisor. For MTH$ATAND2, cosine specifies an
F-floating number. For MTH$DATAND2, cosine specifies a D-floating
number. For MTH$GATAND2, cosine specifies a G-floating number.
| 9 - MTH$xATANH |
Given the hyperbolic tangent of an angle, the Hyperbolic Arc
Tangent routine returns the hyperbolic arc tangent of that angle.
Format
MTH$ATANH hyperbolic-tangent
MTH$DATANH hyperbolic-tangent
MTH$GATANH hyperbolic-tangent
Each of the above formats accepts one of the floating-point
types as input.
9.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The hyperbolic arc tangent of hyperbolic-tangent. MTH$ATANH
returns an F-floating number. MTH$DATANH returns a D-floating
number. MTH$GATANH returns a G-floating number.
9.2 - Argument
hyperbolic-tangent
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Hyperbolic tangent of an angle. The hyperbolic-tangent argument
is the address of a floating-point number that is this hyperbolic
tangent. For MTH$ATANH, hyperbolic-tangent specifies an F-
floating number. For MTH$DATANH, hyperbolic-tangent specifies
a D-floating number. For MTH$GATANH, hyperbolic-tangent specifies
a G-floating number.
| 10 - MTH$CxABS |
The Complex Absolute Value routine returns the absolute value of
a complex number (r,i).
Format
MTH$CABS complex-number
MTH$CDABS complex-number
MTH$CGABS complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
10.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The absolute value of a complex number. MTH$CABS returns an F-
floating number. MTH$CDABS returns a D-floating number. MTH$CGABS
returns a G-floating number.
10.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex, D_floating complex, G_floating
complex
access: read only
mechanism: by reference
A complex number (r,i), where r and i are both floating-point
complex values. The complex-number argument is the address of
this complex number. For MTH$CABS, complex-number specifies
an F-floating complex number. For MTH$CDABS, complex-number
specifies a D-floating complex number. For MTH$CGABS, complex-
number specifies a G-floating complex number.
| 11 - MTH$CCOS |
The Cosine of a Complex Number (F-Floating Value) routine returns
the cosine of a complex number as an F-floating value.
Format
MTH$CCOS complex-number
11.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
The complex cosine of the complex input number. MTH$CCOS returns
an F-floating complex number.
11.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
A complex number (r,i) where r and i are floating-point numbers.
The complex-number argument is the address of this complex
number. For MTH$CCOS, complex-number specifies an F-floating
complex number.
| 12 - MTH$CxCOS |
The Cosine of a Complex Number routine returns the cosine of a
complex number.
Format
MTH$CDCOS complex-cosine ,complex-number
MTH$CGCOS complex-cosine ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
12.1 - Returns
None.
12.2 - Arguments
complex-cosine
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
Complex cosine of the complex-number. The complex cosine routines
that have D-floating and G-floating complex input values write
the address of the complex cosine into the complex-cosine
argument. For MTH$CDCOS, the complex-cosine argument specifies
a D-floating complex number. For MTH$CGCOS, the complex-cosine
argument specifies a G-floating complex number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
A complex number (r,i) where r and i are floating-point numbers.
The complex-number argument is the address of this complex
number. For MTH$CDCOS, complex-number specifies a D-floating
complex number. For MTH$CGCOS, complex-number specifies a G-
floating complex number.
| 13 - MTH$CEXP |
The Complex Exponential (F-Floating Value) routine returns the
complex exponential of a complex number as an F-floating value.
Format
MTH$CEXP complex-number
13.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
Complex exponential of the complex input number. MTH$CEXP returns
an F-floating complex number.
13.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
Complex number whose complex exponential is to be returned. This
complex number has the form (r,i), where r is the real part and i
is the imaginary part. The complex-number argument is the address
of this complex number. For MTH$CEXP, complex-number specifies an
F-floating number.
| 14 - MTH$CxEXP |
The Complex Exponential routine returns the complex exponential
of a complex number.
Format
MTH$CDEXP complex-exponent ,complex-number
MTH$CGEXP complex-exponent ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
14.1 - Returns
None.
14.2 - Arguments
complex-exponent
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
Complex exponential of complex-number. The complex exponential
routines that have D-floating complex and G-floating complex
input values write the complex-exponent into this argument.
For MTH$CDEXP, complex-exponent argument specifies a D-floating
complex number. For MTH$CGEXP, complex-exponent specifies a G-
floating complex number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
Complex number whose complex exponential is to be returned. This
complex number has the form (r,i), where r is the real part and i
is the imaginary part. The complex-number argument is the address
of this complex number. For MTH$CDEXP, complex-number specifies
a D-floating number. For MTH$CGEXP, complex-number specifies a
G-floating number.
| 15 - MTH$CLOG |
The Complex Natural Logarithm (F-Floating Value) routine returns
the complex natural logarithm of a complex number as an F-
floating value.
Format
MTH$CLOG complex-number
15.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
The complex natural logarithm of a complex number. MTH$CLOG
returns an F-floating complex number.
15.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
Complex number whose complex natural logarithm is to be returned.
This complex number has the form (r,i), where r is the real part
and i is the imaginary part. The complex-number argument is the
address of this complex number. For MTH$CLOG, complex-number
specifies an F-floating number.
| 16 - MTH$CxLOG |
The Complex Natural Logarithm routine returns the complex natural
logarithm of a complex number.
Format
MTH$CDLOG complex-natural-log ,complex-number
MTH$CGLOG complex-natural-log ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
16.1 - Returns
None.
16.2 - Arguments
complex-natural-log
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
Natural logarithm of the complex number specified by complex-
number. The complex natural logarithm routines that have D-
floating complex and G-floating complex input values write the
address of the complex natural logarithm into complex-natural-
log. For MTH$CDLOG, the complex-natural-log argument specifies a
D-floating complex number. For MTH$CGLOG, the complex-natural-log
argument specifies a G-floating complex number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
Complex number whose complex natural logarithm is to be returned.
This complex number has the form (r,i), where r is the real part
and i is the imaginary part. The complex-number argument is the
address of this complex number. For MTH$CDLOG, complex-number
specifies a D-floating number. For MTH$CGLOG, complex-number
specifies a G-floating number.
| 17 - MTH$CMPLX |
The Complex Number Made from F-Floating Point routine returns a
complex number from two floating-point input values.
Format
MTH$CMPLX real-part ,imaginary-part
17.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
A complex number. MTH$CMPLX returns an F-floating complex number.
17.2 - Arguments
real-part
OpenVMS usage:floating_point
type: F_floating
access: read only
mechanism: by reference
Real part of a complex number. The real-part argument is the
address of a floating-point number that contains this real part,
r, of (r,i). For MTH$CMPLX, real-part specifies an F-floating
number.
imaginary-part
OpenVMS usage:floating_point
type: F_floating
access: read only
mechanism: by reference
Imaginary part of a complex number. The imaginary-part argument
is the address of a floating-point number that contains this
imaginary part, i, of (r,i). For MTH$CMPLX, imaginary-part
specifies an F-floating number.
| 18 - MTH$xCMPLX |
The Complex Number Made from D- or G-Floating Point routines
return a complex number from two D- or G-floating input values.
Format
MTH$DCMPLX complx ,real-part ,imaginary-part
MTH$GCMPLX complx ,real-part ,imaginary-part
Each of the above formats accepts one of floating-point complex
types as input.
18.1 - Returns
None.
18.2 - Arguments
complx
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
The floating-point complex value of a complex number. The complex
exponential functions that have D-floating complex and G-floating
complex input values write the address of this floating-point
complex value into complx. For MTH$DCMPLX, complx specifies a
D-floating complex number. For MTH$GCMPLX, complx specifies a
G-floating complex number. For MTH$CMPLX, complx is not used.
real-part
OpenVMS usage:floating_point
type: D_floating, G_floating
access: read only
mechanism: by reference
Real part of a complex number. The real-part argument is the
address of a floating-point number that contains this real part,
r, of (r,i). For MTH$DCMPLX, real-part specifies a D-floating
number. For MTH$GCMPLX, real-part specifies a G-floating number.
imaginary-part
OpenVMS usage:floating_point
type: D_floating, G_floating
access: read only
mechanism: by reference
Imaginary part of a complex number. The imaginary-part argument
is the address of a floating-point number that contains this
imaginary part, i, of (r,i). For MTH$DCMPLX, imaginary-part
specifies a D-floating number. For MTH$GCMPLX, imaginary-part
specifies a G-floating number.
| 19 - MTH$CONJG |
The Conjugate of a Complex Number (F-Floating Value) routine
returns the complex conjugate (r,-i) of a complex number (r,i) as
an F-floating value.
Format
MTH$CONJG complex-number
19.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
Complex conjugate of a complex number. MTH$CONJG returns an F-
floating complex number.
19.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
A complex number (r,i), where r and i are floating-point numbers.
The complex-number argument is the address of this floating-
point complex number. For MTH$CONJG, complex-number specifies an
F-floating number.
| 20 - MTH$xCONJG |
The Conjugate of a Complex Number routine returns the complex
conjugate (r,-i) of a complex number (r,i).
Format
MTH$DCONJG complex-conjugate ,complex-number
MTH$GCONJG complex-conjugate ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
20.1 - Returns
None.
20.2 - Arguments
complex-conjugate
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
The complex conjugate (r,-i) of the complex number specified by
complex-number. MTH$DCONJG and MTH$GCONJG write the address of
this complex conjugate into complex-conjugate. For MTH$DCONJG,
the complex-conjugate argument specifies the address of a D-
floating complex number. For MTH$GCONJG, the complex-conjugate
argument specifies the address of a G-floating complex number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
A complex number (r,i), where r and i are floating-point numbers.
The complex-number argument is the address of this floating-
point complex number. For MTH$DCONJG, complex-number specifies
a D-floating number. For MTH$GCONJG, complex-number specifies a
G-floating number.
| 21 - MTH$xCOS |
The Cosine of Angle Expressed in Radians routine returns the
cosine of a given angle (in radians).
Format
MTH$COS angle-in-radians
MTH$DCOS angle-in-radians
MTH$GCOS angle-in-radians
Each of the above formats accepts one of the floating-point
types as input.
21.1 - Corresponding JSB Entry Points
MTH$COS_R4
MTH$DCOS_R7
MTH$GCOS_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
21.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Cosine of the angle. MTH$COS returns an F-floating number.
MTH$DCOS returns a D-floating number. MTH$GCOS returns a G-
floating number.
21.3 - Argument
angle-in-radians
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The angle in radians. The angle-in-radians argument is the
address of a floating-point number. For MTH$COS, angle-in-radians
is an F-floating number. For MTH$DCOS, angle-in-radians specifies
a D-floating number. For MTH$GCOS, angle-in-radians specifies a
G-floating number.
| 22 - MTH$xCOSD |
The Cosine of Angle Expressed in Degrees routine returns the
cosine of a given angle (in degrees).
Format
MTH$COSD angle-in-degrees
MTH$DCOSD angle-in-degrees
MTH$GCOSD angle-in-degrees
Each of the above formats accepts one of the floating-point
types as input.
22.1 - Corresponding JSB Entry Points
MTH$COSD_R4
MTH$DCOSD_R7
MTH$GCOSD_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
22.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Cosine of the angle. MTH$COSD returns an F-floating number.
MTH$DCOSD returns a D-floating number. MTH$GCOSD returns a G-
floating number.
22.3 - Argument
angle-in-degrees
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Angle (in degrees). The angle-in-degrees argument is the address
of a floating-point number. For MTH$COSD, angle-in-degrees
specifies an F-floating number. For MTH$DCOSD, angle-in-degrees
specifies a D-floating number. For MTH$GCOSD, angle-in-degrees
specifies a G-floating number.
| 23 - MTH$xCOSH |
The Hyperbolic Cosine routine returns the hyperbolic cosine of
the input value.
Format
MTH$COSH floating-point-input-value
MTH$DCOSH floating-point-input-value
MTH$GCOSH floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
23.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The hyperbolic cosine of the input value floating-point-input-
value. MTH$COSH returns an F-floating number. MTH$DCOSH returns a
D-floating number. MTH$GCOSH returns a G-floating number.
23.2 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of this input value. For MTH$COSH, floating-point-input-
value specifies an F-floating number. For MTH$DCOSH, floating-
point-input-value specifies a D-floating number. For MTH$GCOSH,
floating-point-input-value specifies a G-floating number.
| 24 - MTH$CSIN |
The Sine of a Complex Number (F-Floating Value) routine returns
the sine of a complex number (r,i) as an F-floating value.
Format
MTH$CSIN complex-number
24.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
Complex sine of the complex number. MTH$CSIN returns an F-
floating complex number.
24.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
A complex number (r,i), where r and i are floating-point numbers.
The complex-number argument is the address of this complex
number. For MTH$CSIN, complex-number specifies an F-floating
complex number.
| 25 - MTH$CxSIN |
The Sine of a Complex Number routine returns the sine of a
complex number (r,i).
Format
MTH$CDSIN complex-sine ,complex-number
MTH$CGSIN complex-sine ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
25.1 - Returns
None.
25.2 - Arguments
complex-sine
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
Complex sine of the complex number. The complex sine routines
with D-floating complex and G-floating complex input values
write the complex sine into this complex-sine argument. For
MTH$CDSIN, complex-sine specifies a D-floating complex number.
For MTH$CGSIN, complex-sine specifies a G-floating complex
number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
A complex number (r,i), where r and i are floating-point numbers.
The complex-number argument is the address of this complex
number. For MTH$CDSIN, complex-number specifies a D-floating
complex number. For MTH$CGSIN, complex-number specifies a G-
floating complex number.
| 26 - MTH$CSQRT |
The Complex Square Root (F-Floating Value) routine returns the
complex square root of a complex number (r,i).
Format
MTH$CSQRT complex-number
26.1 - Returns
OpenVMS usage:complex_number
type: F_floating complex
access: write only
mechanism: by value
The complex square root of the complex-number argument. MTH$CSQRT
returns an F-floating number.
26.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex
access: read only
mechanism: by reference
Complex number (r,i). The complex-number argument contains the
address of this complex number. For MTH$CSQRT, complex-number
specifies an F-floating number.
| 27 - MTH$CxSQRT |
The Complex Square Root routine returns the complex square root
of a complex number (r,i).
Format
MTH$CDSQRT complex-square-root ,complex-number
MTH$CGSQRT complex-square-root ,complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
27.1 - Returns
None.
27.2 - Arguments
complex-square-root
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: write only
mechanism: by reference
Complex square root of the complex number specified by complex-
number. The complex square root routines that have D-floating
complex and G-floating complex input values write the complex
square root into complex-square-root. For MTH$CDSQRT, complex-
square-root specifies a D-floating complex number. For
MTH$CGSQRT, complex-square-root specifies a G-floating complex
number.
complex-number
OpenVMS usage:complex_number
type: D_floating complex, G_floating complex
access: read only
mechanism: by reference
Complex number (r,i). The complex-number argument contains the
address of this complex number. For MTH$CDSQRT, complex-number
specifies a D-floating number. For MTH$CGSQRT, complex-number
specifies a G-floating number.
| 28 - MTH$CVT x x |
The Convert One Double-Precision Value routines convert one
double-precision value to the destination data type and return
the result as a function value. MTH$CVT_D_G converts a D-floating
value to G-floating and MTH$CVT_G_D converts a G-floating value
to a D-floating value.
Format
MTH$CVT_D_G floating-point-input-val
MTH$CVT_G_D floating-point-input-val
28.1 - Returns
OpenVMS usage:floating_point
type: G_floating, D_floating
access: write only
mechanism: by value
The converted value. MTH$CVT_D_G returns a G-floating value.
MTH$CVT_G_D returns a D-floating value.
28.2 - Argument
floating-point-input-val
OpenVMS usage:floating_point
type: D_floating, G_floating
access: read only
mechanism: by reference
The input value to be converted. The floating-point-input-val
argument is the address of this input value. For MTH$CVT_D_G, the
floating-point-input-val argument specifies a D-floating number.
For MTH$CVT_G_D, the floating-point-input-val argument specifies
a G-floating number.
| 29 - MTH$CVT xA xA |
The Convert an Array of Double-Precision Values routines convert
a contiguous array of double-precision values to the destination
data type and return the results as an array. MTH$CVT_DA_GA
converts D-floating values to G-floating and MTH$CVT_GA_DA
converts G-floating values to D-floating.
Format
MTH$CVT_DA_GA floating-point-input-array
,floating-point-dest-array [,array-size]
MTH$CVT_GA_DA floating-point-input-array
,floating-point-dest-array [,array-size]
29.1 - Returns
MTH$CVT_DA_GA and MTH$CVT_GA_DA return the address of the output
array to the floating-point-dest-array argument.
29.2 - Arguments
floating-point-input-array
OpenVMS usage:floating_point
type: D_floating, G_floating
access: read only
mechanism: by reference, array reference
Input array of values to be converted. The floating-point-input-
array argument is the address of an array of floating-point
numbers. For MTH$CVT_DA_GA, floating-point-input-array specifies
an array of D-floating numbers. For MTH$CVT_GA_DA, floating-
point-input-array specifies an array of G-floating numbers.
floating-point-dest-array
OpenVMS usage:floating_point
type: G_floating, D_floating
access: write only
mechanism: by reference, array reference
Output array of converted values. The floating-point-dest-array
argument is the address of an array of floating-point numbers.
For MTH$CVT_DA_GA, floating-point-dest-array specifies an array
of G-floating numbers. For MTH$CVT_GA_DA, floating-point-dest-
array specifies an array of D-floating numbers.
array-size
OpenVMS usage:longword_signed
type: longword (signed)
access: read only
mechanism: by reference
Number of array elements to be converted. The default value is 1.
The array-size argument is the address of a longword containing
this number of elements.
| 30 - MTH$xEXP |
The Exponential routine returns the exponential of the input
value.
Format
MTH$EXP floating-point-input-value
MTH$DEXP floating-point-input-value
MTH$GEXP floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
30.1 - Corresponding JSB Entry Points
MTH$EXP_R4
MTH$DEXP_R6
MTH$GEXP_R6
Each of the above JSB entry points accepts one of the floating-
point types as input.
30.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The exponential of floating-point-input-value. MTH$EXP returns an
F-floating number. MTH$DEXP returns a D-floating number. MTH$GEXP
returns a G-floating number.
30.3 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is
the address of a floating-point number. For MTH$EXP, floating-
point-input-value specifies an F-floating number. For MTH$DEXP,
floating-point-input-value specifies a D-floating number. For
MTH$GEXP, floating-point-input-value specifies a G-floating
number.
| 31 - MTH$HACOS |
Given the cosine of an angle, the Arc Cosine of Angle Expressed
in Radians (H-Floating Value) routine returns that angle (in
radians) in H-floating-point precision.
Format
MTH$HACOS h-radians ,cosine
31.1 - Corresponding JSB Entry Point
MTH$HACOS_R8
31.2 - Returns
None.
31.3 - Arguments
h-radians
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in radians) whose cosine is specified by cosine. The h-
radians argument is the address of an H-floating number that
is this angle. MTH$HACOS writes the address of the angle into
h-radians.
cosine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The cosine of the angle whose value (in radians) is to be
returned. The cosine argument is the address of a floating-point
number that is this cosine. The absolute value of cosine must
be less than or equal to 1. For MTH$HACOS, cosine specifies an
H-floating number.
| 32 - MTH$HACOSD |
Given the cosine of an angle, the Arc Cosine of Angle Expressed
in Degrees (H-Floating Value) routine returns that angle (in
degrees) as an H-floating value.
Format
MTH$HACOSD h-degrees ,cosine
32.1 - Corresponding JSB Entry Point
MTH$HACOSD_R8
32.2 - Returns
None.
32.3 - Arguments
h-degrees
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in degrees) whose cosine is specified by cosine. The h-
degrees argument is the address of an H-floating number that
is this angle. MTH$HACOSD writes the address of the angle into
h-degrees.
cosine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Cosine of the angle whose value (in degrees) is to be returned.
The cosine argument is the address of a floating-point number
that is this cosine. The absolute value of cosine must be less
than or equal to 1. For MTH$HACOSD, cosine specifies an H-
floating number.
| 33 - MTH$HASIN |
Given the sine of an angle, the Arc Sine in Radians (H-Floating
Value) routine returns that angle (in radians) as an H-floating
value.
Format
MTH$HASIN h-radians ,sine
33.1 - Corresponding JSB Entry Point
MTH$HASIN_R8
33.2 - Returns
None.
33.3 - Arguments
h-radians
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in radians) whose sine is specified by sine. The h-radians
argument is the address of an H-floating number that is this
angle. MTH$HASIN writes the address of the angle into h-radians.
sine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The sine of the angle whose value (in radians) is to be returned.
The sine argument is the address of a floating-point number that
is this sine. The absolute value of sine must be less than or
equal to 1. For MTH$HASIN, sine specifies an H-floating number.
| 34 - MTH$HASIND |
Given the sine of an angle, the Arc Sine in Degrees (H-Floating
Value) routine returns that angle (in degrees) as an H-floating
value.
Format
MTH$HASIND h-degrees ,sine
34.1 - Corresponding JSB Entry Point
MTH$HASIND_R8
34.2 - Returns
None.
34.3 - Arguments
h-degrees
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in degrees) whose sine is specified by sine. The h-degrees
argument is the address of an H-floating number that is this
angle. MTH$HASIND writes the address of the angle into h-degrees.
sine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Sine of the angle whose value (in degrees) is to be returned. The
sine argument is the address of a floating-point number that is
this sine. The absolute value of sine must be less than or equal
to 1. For MTH$HASIND, sine specifies an H-floating number.
| 35 - MTH$HATAN |
Given the tangent of an angle, the Arc Tangent in Radians (H-
Floating Value) routine returns that angle (in radians) as an
H-floating value.
Format
MTH$HATAN h-radians ,tangent
35.1 - Corresponding JSB Entry Point
MTH$HATAN_R8
35.2 - Returns
None.
35.3 - Arguments
h-radians
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in radians) whose tangent is specified by tangent. The
h-radians argument is the address of an H-floating number that
is this angle. MTH$HATAN writes the address of the angle into
h-radians.
tangent
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The tangent of the angle whose value (in radians) is to be
returned. The tangent argument is the address of a floating-point
number that is this tangent. For MTH$HATAN, tangent specifies an
H-floating number.
| 36 - MTH$HATAND |
Given the tangent of an angle, the Arc Tangent in Degrees (H-
Floating Value) routine returns that angle (in degrees) as an
H-floating value.
Format
MTH$HATAND h-degrees ,tangent
36.1 - Corresponding JSB Entry Point
MTH$HATAND_R8
36.2 - Returns
None.
36.3 - Arguments
h-degrees
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in degrees) whose tangent is specified by tangent. The
h-degrees argument is the address of an H-floating number that
is this angle. MTH$HATAND writes the address of the angle into
h-degrees.
tangent
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The tangent of the angle whose value (in degrees) is to be
returned. The tangent argument is the address of a floating-point
number that is this tangent. For MTH$HATAND, tangent specifies an
H-floating number.
| 37 - MTH$HATAN2 |
Given sine and cosine, the Arc Tangent in Radians (H-Floating
Value) with Two Arguments routine returns the angle (in radians)
as an H-floating value whose tangent is given by the quotient of
sine and cosine (sine/cosine).
Format
MTH$HATAN2 h-radians ,sine ,cosine
37.1 - Returns
None.
37.2 - Arguments
h-radians
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in radians) whose tangent is specified by (sine/cosine).
The h-radians argument is the address of an H-floating number
that is this angle. MTH$HATAN2 writes the address of the angle
into h-radians.
sine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Dividend. The sine argument is the address of a floating-point
number that is this dividend. For MTH$HATAN2, sine specifies an
H-floating number.
cosine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Divisor. The cosine argument is the address of a floating-point
number that is this divisor. For MTH$HATAN2, cosine specifies an
H-floating number.
| 38 - MTH$HATAND2 |
Given sine and cosine, the Arc Tangent in Degrees (H-Floating
Value) with Two Arguments routine returns the angle (in degrees)
whose tangent is given by the quotient of sine and cosine
(sine/cosine).
Format
MTH$HATAND2 h-degrees ,sine ,cosine
38.1 - Returns
None.
38.2 - Arguments
h-degrees
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Angle (in degrees) whose tangent is specified by (sine/cosine).
The h-degrees argument is the address of an H-floating number
that is this angle. MTH$HATAND2 writes the address of the angle
into h-degrees.
sine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Dividend. The sine argument is the address of a floating-point
number that is this dividend. For MTH$HATAND2, sine specifies an
H-floating number.
cosine
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Divisor. The cosine argument is the address of a floating-point
number that is this divisor. For MTH$HATAND2, cosine specifies an
H-floating number.
| 39 - MTH$HATANH |
Given the hyperbolic tangent of an angle, the Hyperbolic Arc
Tangent (H-Floating Value) routine returns the hyperbolic arc
tangent (as an H-floating value) of that angle.
Format
MTH$HATANH h-atanh ,hyperbolic-tangent
39.1 - Returns
None.
39.2 - Arguments
h-atanh
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Hyperbolic arc tangent of the hyperbolic tangent specified by
hyperbolic-tangent. The h-atanh argument is the address of an H-
floating number that is this hyperbolic arc tangent. MTH$HATANH
writes the address of the hyperbolic arc tangent into h-atanh.
hyperbolic-tangent
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Hyperbolic tangent of an angle. The hyperbolic-tangent argument
is the address of a floating-point number that is this hyperbolic
tangent. For MTH$HATANH, hyperbolic-tangent specifies an H-
floating number.
| 40 - MTH$HCOS |
The Cosine of Angle Expressed in Radians (H-Floating Value)
routine returns the cosine of a given angle (in radians) as an
H-floating value.
Format
MTH$HCOS h-cosine ,angle-in-radians
40.1 - Corresponding JSB Entry Point
MTH$HCOS_R5
40.2 - Returns
None.
40.3 - Arguments
h-cosine
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Cosine of the angle specified by angle-in-radians. The h-cosine
argument is the address of an H-floating number that is this
cosine. MTH$HCOS writes the address of the cosine into h-cosine.
angle-in-radians
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Angle (in radians). The angle-in-radians argument is the address
of a floating-point number. For MTH$HCOS, angle-in-radians
specifies an H-floating number.
| 41 - MTH$HCOSD |
The Cosine of Angle Expressed in Degrees (H-Floating Value)
routine returns the cosine of a given angle (in degrees) as an
H-floating value.
Format
MTH$HCOSD h-cosine ,angle-in-degrees
41.1 - Corresponding JSB Entry Point
MTH$HCOSD_R5
41.2 - Returns
None.
41.3 - Arguments
h-cosine
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Cosine of the angle specified by angle-in-degrees. The h-cosine
argument is the address of an H-floating number that is this
cosine. MTH$HCOSD writes this cosine into h-cosine.
angle-in-degrees
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Angle (in degrees). The angle-in-degrees argument is the address
of a floating-point number. For MTH$HCOSD, angle-in-degrees
specifies an H-floating number.
| 42 - MTH$HCOSH |
The Hyperbolic Cosine (H-Floating Value) routine returns the
hyperbolic cosine of the input value as an H-floating value.
Format
MTH$HCOSH h-cosh ,floating-point-input-value
42.1 - Returns
None.
42.2 - Arguments
h-cosh
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Hyperbolic cosine of the input value specified by floating-point-
input-value. The h-cosh argument is the address of an H-floating
number that is this hyperbolic cosine. MTH$HCOSH writes the
address of the hyperbolic cosine into h-cosh.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of this input value. For MTH$HCOSH, floating-point-input-
value specifies an H-floating number.
| 43 - MTH$HEXP |
The Exponential (H-Floating Value) routine returns the
exponential of the input value as an H-floating value.
Format
MTH$HEXP h-exp ,floating-point-input-value
43.1 - Corresponding JSB Entry Point
MTH$HEXP_R6
43.2 - Returns
None.
43.3 - Arguments
h-exp
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Exponential of the input value specified by floating-point-input-
value. The h-exp argument is the address of an H-floating number
that is this exponential. MTH$HEXP writes the address of the
exponential into h-exp.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number. For MTH$HEXP, floating-point-
input-value specifies an H-floating number.
| 44 - MTH$HLOG |
The Natural Logarithm (H-Floating Value) routine returns the
natural (base e) logarithm of the input argument as an H-floating
value.
Format
MTH$HLOG h-natlog ,floating-point-input-value
44.1 - Corresponding JSB Entry Point
MTH$HLOG_R8
44.2 - Returns
None.
44.3 - Arguments
h-natlog
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Natural logarithm of floating-point-input-value. The h-natlog
argument is the address of an H-floating number that is this
natural logarithm. MTH$HLOG writes the address of this natural
logarithm into h-natlog.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is
the address of a floating-point number that is this value. For
MTH$HLOG, floating-point-input-value specifies an H-floating
number.
| 45 - MTH$HLOG2 |
The Base 2 Logarithm (H-Floating Value) routine returns the base
2 logarithm of the input value specified by floating-point-input-
value as an H-floating value.
Format
MTH$HLOG2 h-log2 ,floating-point-input-value
45.1 - Returns
None.
45.2 - Arguments
h-log2
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Base 2 logarithm of floating-point-input-value. The h-log2
argument is the address of an H-floating number that is this
base 2 logarithm. MTH$HLOG2 writes the address of this logarithm
into h-log2.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number that is this input value. For
MTH$HLOG2, floating-point-input-value specifies an H-floating
number.
| 46 - MTH$HLOG10 |
The Common Logarithm (H-Floating Value) routine returns the
common (base 10) logarithm of the input argument as an H-floating
value.
Format
MTH$HLOG10 h-log10 ,floating-point-input-value
46.1 - Corresponding JSB Entry Point
MTH$HLOG10_R8
46.2 - Returns
None.
46.3 - Arguments
h-log10
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Common logarithm of the input value specified by floating-point-
input-value. The h-log10 argument is the address of an H-floating
number that is this common logarithm. MTH$HLOG10 writes the
address of the common logarithm into h-log10.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number. For MTH$HLOG10, floating-
point-input-value specifies an H-floating number.
| 47 - MTH$HSIN |
The Sine of Angle Expressed in Radians (H-Floating Value) routine
returns the sine of a given angle (in radians) as an H-floating
value.
Format
MTH$HSIN h-sine ,angle-in-radians
47.1 - Corresponding JSB Entry Point
MTH$HSIN_R5
47.2 - Returns
None.
47.3 - Arguments
h-sine
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
The sine of the angle specified by angle-in-radians. The h-sine
argument is the address of an H-floating number that is this
sine. MTH$HSIN writes the address of the sine into h-sine.
angle-in-radians
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Angle (in radians). The angle-in-radians argument is the address
of a floating-point number that is this angle. For MTH$HSIN,
angle-in-radians specifies an H-floating number.
| 48 - MTH$HSIND |
The Sine of Angle Expressed in Degrees (H-Floating Value) routine
returns the sine of a given angle (in degrees) as an H-floating
value.
Format
MTH$HSIND h-sine ,angle-in-degrees
48.1 - Corresponding JSB Entry Point
MTH$HSIND_R5
48.2 - Returns
None.
48.3 - Arguments
h-sine
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Sine of the angle specified by angle-in-degrees. MTH$HSIND writes
into h-sine the address of an H-floating number that is this
sine.
angle-in-degrees
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Angle (in degrees). The angle-in-degrees argument is the address
of an H-floating number that is this angle.
| 49 - MTH$HSINH |
The Hyperbolic Sine (H-Floating Value) routine returns the
hyperbolic sine of the input value specified by floating-point-
input-value as an H-floating value.
Format
MTH$HSINH h-sinh ,floating-point-input-value
49.1 - Returns
None.
49.2 - Arguments
h-sinh
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Hyperbolic sine of the input value specified by floating-point-
input-value. The h-sinh argument is the address of an H-floating
number that is this hyperbolic sine. MTH$HSINH writes the address
of the hyperbolic sine into h-sinh.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is
the address of a floating-point number that is this value. For
MTH$HSINH, floating-point-input-value specifies an H-floating
number.
| 50 - MTH$HSQRT |
The Square Root (H-Floating Value) routine returns the square
root of the input value floating-point-input-value as an H-
floating value.
Format
MTH$HSQRT h-sqrt ,floating-point-input-value
50.1 - Corresponding JSB Entry Point
MTH$HSQRT_R8
50.2 - Returns
None.
50.3 - Arguments
h-sqrt
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Square root of the input value specified by floating-point-input-
value. The h-sqrt argument is the address of an H-floating number
that is this square root. MTH$HSQRT writes the address of the
square root into h-sqrt.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
Input value. The floating-point-input-value argument is the
address of a floating-point number that contains this input
value. For MTH$HSQRT, floating-point-input-value specifies an
H-floating number.
| 51 - MTH$HTAN |
The Tangent of Angle Expressed in Radians (H-Floating Value)
routine returns the tangent of a given angle (in radians) as an
H-floating value.
Format
MTH$HTAN h-tan ,angle-in-radians
51.1 - Corresponding JSB Entry Point
MTH$HTAN_R5
51.2 - Returns
None.
51.3 - Arguments
h-tan
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Tangent of the angle specified by angle-in-radians. The h-tan
argument is the address of an H-floating number that is this
tangent. MTH$HTAN writes the address of the tangent into h-tan.
angle-in-radians
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input angle (in radians). The angle-in-radians argument is
the address of a floating-point number that is this angle. For
MTH$HTAN, angle-in-radians specifies an H-floating number.
| 52 - MTH$HTAND |
The Tangent of Angle Expressed in Degrees (H-Floating Value)
routine returns the tangent of a given angle (in degrees) as an
H-floating value.
Format
MTH$HTAND h-tan ,angle-in-degrees
52.1 - Corresponding JSB Entry Point
MTH$HTAND_R5
52.2 - Returns
None.
52.3 - Arguments
h-tan
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Tangent of the angle specified by angle-in-degrees. The h-tan
argument is the address of an H-floating number that is this
tangent. MTH$HTAND writes the address of the tangent into h-tan.
angle-in-degrees
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input angle (in degrees). The angle-in-degrees argument is
the address of a floating-point number that is this angle. For
MTH$HTAND, angle-in-degrees specifies an H-floating number.
| 53 - MTH$HTANH |
The Compute the Hyperbolic Tangent (H-Floating Value) routine
returns the hyperbolic tangent of the input value as an H-
floating value.
Format
MTH$HTANH h-tanh ,floating-point-input-value
53.1 - Returns
None.
53.2 - Arguments
h-tanh
OpenVMS usage:floating_point
type: H_floating
access: write only
mechanism: by reference
Hyperbolic tangent of the value specified by floating-point-
input-value. The h-tanh argument is the address of an H-floating
number that is this hyperbolic tangent. MTH$HTANH writes the
address of the hyperbolic tangent into h-tanh.
floating-point-input-value
OpenVMS usage:floating_point
type: H_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of an H-floating number that contains this input value.
| 54 - MTH$xIMAG |
The Imaginary Part of a Complex Number routine returns the
imaginary part of a complex number.
Format
MTH$AIMAG complex-number
MTH$DIMAG complex-number
MTH$GIMAG complex-number
Each of the above formats corresponds to one of the floating-
point complex types.
54.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Imaginary part of the input complex-number. MTH$AIMAG returns
an F-floating number. MTH$DIMAG returns a D-floating number.
MTH$GIMAG returns a G-floating number.
54.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex, D_floating complex, G_floating
complex
access: read only
mechanism: by reference
The input complex number. The complex-number argument is the
address of this floating-point complex number. For MTH$AIMAG,
complex-number specifies an F-floating number. For MTH$DIMAG,
complex-number specifies a D-floating number. For MTH$GIMAG,
complex-number specifies a G-floating number.
| 55 - MTH$xLOG |
The Natural Logarithm routine returns the natural (base e)
logarithm of the input argument.
Format
MTH$ALOG floating-point-input-value
MTH$DLOG floating-point-input-value
MTH$GLOG floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
55.1 - Corresponding JSB Entry Points
MTH$ALOG_R5
MTH$DLOG_R8
MTH$GLOG_R8
Each of the above JSB entry points accepts one of the floating-
point types as input.
55.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The natural logarithm of floating-point-input-value. MTH$ALOG
returns an F-floating number. MTH$DLOG returns a D-floating
number. MTH$GLOG returns a G-floating number.
55.3 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is
the address of a floating-point number that is this value. For
MTH$ALOG, floating-point-input-value specifies an F-floating
number. For MTH$DLOG, floating-point-input-value specifies a
D-floating number. For MTH$GLOG, floating-point-input-value
specifies a G-floating number.
| 56 - MTH$xLOG2 |
The Base 2 Logarithm routine returns the base 2 logarithm of the
input value specified by floating-point-input-value.
Format
MTH$ALOG2 floating-point-input-value
MTH$DLOG2 floating-point-input-value
MTH$GLOG2 floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
56.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The base 2 logarithm of floating-point-input-value. MTH$ALOG2
returns an F-floating number. MTH$DLOG2 returns a D-floating
number. MTH$GLOG2 returns a G-floating number.
56.2 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number that is this input value. For
MTH$ALOG2, floating-point-input-value specifies an F-floating
number. For MTH$DLOG2, floating-point-input-value specifies a
D-floating number. For MTH$GLOG2, floating-point-input-value
specifies a G-floating number.
| 57 - MTH$xLOG10 |
The Common Logarithm routine returns the common (base 10)
logarithm of the input argument.
Format
MTH$ALOG10 floating-point-input-value
MTH$DLOG10 floating-point-input-value
MTH$GLOG10 floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
57.1 - Corresponding JSB Entry Points
MTH$ALOG10_R5
MTH$DLOG10_R8
MTH$GLOG10_R8
Each of the above JSB entry points accepts one of the floating-
point types as input.
57.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The common logarithm of floating-point-input-value. MTH$ALOG10
returns an F-floating number. MTH$DLOG10 returns a D-floating
number. MTH$GLOG10 returns a G-floating number.
57.3 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number. For MTH$ALOG10, floating-
point-input-value specifies an F-floating number. For MTH$DLOG10,
floating-point-input-value specifies a D-floating number. For
MTH$GLOG10, floating-point-input-value specifies a G-floating
number.
| 58 - MTH$RANDOM |
The Random Number Generator, Uniformly Distributed routine is a
general random number generator.
Format
MTH$RANDOM seed
58.1 - Returns
OpenVMS usage:floating_point
type: F_floating
access: write only
mechanism: by value
MTH$RANDOM returns an F-floating random number.
58.2 - Argument
seed
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: modify
mechanism: by reference
The integer seed, a 32-bit number whose high-order 24 bits
are converted by MTH$RANDOM to an F-floating random number.
The seed argument is the address of an unsigned longword that
contains this integer seed. The seed is modified by each call to
MTH$RANDOM.
| 59 - MTH$xREAL |
The Real Part of a Complex Number routine returns the real part
of a complex number.
Format
MTH$REAL complex-number
MTH$DREAL complex-number
MTH$GREAL complex-number
Each of the above formats accepts one of the floating-point
complex types as input.
59.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Real part of the complex number. MTH$REAL returns an F-floating
number. MTH$DREAL returns a D-floating number. MTH$GREAL returns
a G-floating number.
59.2 - Argument
complex-number
OpenVMS usage:complex_number
type: F_floating complex, D_floating complex, G_floating
complex
access: read only
mechanism: by reference
The complex number whose real part is returned by MTH$xREAL. The
complex-number argument is the address of this floating-point
complex number. For MTH$REAL, complex-number is an F-floating
complex number. For MTH$DREAL, complex-number is a D-floating
complex number. For MTH$GREAL, complex-number is a G-floating
complex number.
| 60 - MTH$xSIN |
The Sine of Angle Expressed in Radians routine returns the sine
of a given angle (in radians).
Format
MTH$SIN angle-in-radians
MTH$DSIN angle-in-radians
MTH$GSIN angle-in-radians
Each of the above formats accepts one of the floating-point
types as input.
60.1 - Corresponding JSB Entry Points
MTH$SIN_R4
MTH$DSIN_R7
MTH$GSIN_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
60.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Sine of the angle specified by angle-in-radians. MTH$SIN returns
an F-floating number. MTH$DSIN returns a D-floating number.
MTH$GSIN returns a G-floating number.
60.3 - Argument
angle-in-radians
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Angle (in radians). The angle-in-radians argument is the address
of a floating-point number that is this angle. For MTH$SIN,
angle-in-radians specifies an F-floating number. For MTH$DSIN,
angle-in-radians specifies a D-floating number. For MTH$GSIN,
angle-in-radians specifies a G-floating number.
| 61 - MTH$xSINCOS |
The Sine and Cosine of Angle Expressed in Radians routine returns
the sine and cosine of a given angle (in radians).
Format
MTH$SINCOS angle-in-radians ,sine ,cosine
MTH$DSINCOS angle-in-radians ,sine ,cosine
MTH$GSINCOS angle-in-radians ,sine ,cosine
MTH$HSINCOS angle-in-radians ,sine ,cosine
Each of the above formats accepts one of the floating-point
types as input.
61.1 - Corresponding JSB Entry Points
MTH$SINCOS_R5
MTH$DSINCOS_R7
MTH$GSINCOS_R7
MTH$HSINCOS_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
61.2 - Returns
MTH$SINCOS, MTH$DSINCOS, MTH$GSINCOS, and MTH$HSINCOS return the
sine and cosine of the input angle by reference in the sine and
cosine arguments.
61.3 - Arguments
angle-in-radians
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: read only
mechanism: by reference
Angle (in radians) whose sine and cosine are to be returned. The
angle-in-radians argument is the address of a floating-point
number that is this angle. For MTH$SINCOS, angle-in-radians
is an F-floating number. For MTH$DSINCOS, angle-in-radians is
a D-floating number. For MTH$GSINCOS, angle-in-radians is a
G-floating number. For MTH$HSINCOS, angle-in-radians is an H-
floating number.
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: write only
mechanism: by reference
Sine of the angle specified by angle-in-radians. The sine
argument is the address of a floating-point number. MTH$SINCOS
writes an F-floating number into sine. MTH$DSINCOS writes a D-
floating number into sine. MTH$GSINCOS writes a G-floating number
into sine. MTH$HSINCOS writes an H-floating number into sine.
cosine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: write only
mechanism: by reference
Cosine of the angle specified by angle-in-radians. The cosine
argument is the address of a floating-point number. MTH$SINCOS
writes an F-floating number into cosine. MTH$DSINCOS writes a
D-floating number into cosine. MTH$GSINCOS writes a G-floating
number into cosine. MTH$HSINCOS writes an H-floating number into
cosine.
| 62 - MTH$xSINCOSD |
The Sine and Cosine of Angle Expressed in Degrees routine returns
the sine and cosine of a given angle (in degrees).
Format
MTH$SINCOSD angle-in-degrees ,sine ,cosine
MTH$DSINCOSD angle-in-degrees ,sine ,cosine
MTH$GSINCOSD angle-in-degrees ,sine ,cosine
MTH$HSINCOSD angle-in-degrees ,sine ,cosine
Each of the above formats accepts one of the floating-point
types as input.
62.1 - Corresponding JSB Entry Points
MTH$SINCOSD_R5
MTH$DSINCOSD_R7
MTH$GSINCOSD_R7
MTH$HSINCOSD_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
62.2 - Returns
MTH$SINCOSD, MTH$DSINCOSD, MTH$GSINCOSD, and MTH$HSINCOSD return
the sine and cosine of the input angle by reference in the sine
and cosine arguments.
62.3 - Arguments
angle-in-degrees
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: read only
mechanism: by reference
Angle (in degrees) whose sine and cosine are returned by
MTH$xSINCOSD. The angle-in-degrees argument is the address of
a floating-point number that is this angle. For MTH$SINCOSD,
angle-in-degrees is an F-floating number. For MTH$DSINCOSD,
angle-in-degrees is a D-floating number. For MTH$GSINCOSD, angle-
in-degrees is a G-floating number. For MTH$HSINCOSD, angle-in-
degrees is an H-floating number.
sine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: write only
mechanism: by reference
Sine of the angle specified by angle-in-degrees. The sine
argument is the address of a floating-point number. MTH$SINCOSD
writes an F-floating number into sine. MTH$DSINCOSD writes a
D-floating number into sine. MTH$GSINCOSD writes a G-floating
number into sine. MTH$HSINCOSD writes an H-floating number into
sine.
cosine
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating, H_floating
access: write only
mechanism: by reference
Cosine of the angle specified by angle-in-degrees. The cosine
argument is the address of a floating-point number. MTH$SINCOSD
writes an F-floating number into cosine. MTH$DSINCOSD writes a
D-floating number into cosine. MTH$GSINCOSD writes a G-floating
number into cosine. MTH$HSINCOSD writes an H-floating number into
cosine.
| 63 - MTH$xSIND |
The Sine of Angle Expressed in Degrees routine returns the sine
of a given angle (in degrees).
Format
MTH$SIND angle-in-degrees
MTH$DSIND angle-in-degrees
MTH$GSIND angle-in-degrees
Each of the above formats accepts one of the floating-point
types as input.
63.1 - Corresponding JSB Entry Points
MTH$SIND_R4
MTH$DSIND_R7
MTH$GSIND_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
63.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The sine of the angle. MTH$SIND returns an F-floating number.
MTH$DSIND returns a D-floating number. MTH$GSIND returns a G-
floating number.
63.3 - Argument
angle-in-degrees
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Angle (in degrees). The angle-in-degrees argument is the address
of a floating-point number that is this angle. For MTH$SIND,
angle-in-degrees specifies an F-floating number. For MTH$DSIND,
angle-in-degrees specifies a D-floating number. For MTH$GSIND,
angle-in-degrees specifies a G-floating number.
| 64 - MTH$xSINH |
The Hyperbolic Sine routine returns the hyperbolic sine of the
input value specified by floating-point-input-value.
Format
MTH$SINH floating-point-input-value
MTH$DSINH floating-point-input-value
MTH$GSINH floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
64.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The hyperbolic sine of floating-point-input-value. MTH$SINH
returns an F-floating number. MTH$DSINH returns a D-floating
number. MTH$GSINH returns a G-floating number.
64.2 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is
the address of a floating-point number that is this value. For
MTH$SINH, floating-point-input-value specifies an F-floating
number. For MTH$DSINH, floating-point-input-value specifies a
D-floating number. For MTH$GSINH, floating-point-input-value
specifies a G-floating number.
| 65 - MTH$xSQRT |
The Square Root routine returns the square root of the input
value floating-point-input-value.
Format
MTH$SQRT floating-point-input-value
MTH$DSQRT floating-point-input-value
MTH$GSQRT floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
65.1 - Corresponding JSB Entry Points
MTH$SQRT_R3
MTH$DSQRT_R5
MTH$GSQRT_R5
Each of the above JSB entry points accepts one of the floating-
point types as input.
65.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The square root of floating-point-input-value. MTH$SQRT returns
an F-floating number. MTH$DSQRT returns a D-floating number.
MTH$GSQRT returns a G-floating number.
65.3 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
Input value. The floating-point-input-value argument is the
address of a floating-point number that contains this input
value. For MTH$SQRT, floating-point-input-value specifies an
F-floating number. For MTH$DSQRT, floating-point-input-value
specifies a D-floating number. For MTH$GSQRT, floating-point-
input-value specifies a G-floating number.
| 66 - MTH$xTAN |
The Tangent of Angle Expressed in Radians routine returns the
tangent of a given angle (in radians).
Format
MTH$TAN angle-in-radians
MTH$DTAN angle-in-radians
MTH$GTAN angle-in-radians
Each of the above formats accepts one of the floating-point
types as input.
66.1 - Corresponding JSB Entry Points
MTH$TAN_R4
MTH$DTAN_R7
MTH$GTAN_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
66.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The tangent of the angle specified by angle-in-radians. MTH$TAN
returns an F-floating number. MTH$DTAN returns a D-floating
number. MTH$GTAN returns a G-floating number.
66.3 - Argument
angle-in-radians
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input angle (in radians). The angle-in-radians argument is
the address of a floating-point number that is this angle. For
MTH$TAN, angle-in-radians specifies an F-floating number. For
MTH$DTAN, angle-in-radians specifies a D-floating number. For
MTH$GTAN, angle-in-radians specifies a G-floating number.
| 67 - MTH$xTAND |
The Tangent of Angle Expressed in Degrees routine returns the
tangent of a given angle (in degrees).
Format
MTH$TAND angle-in-degrees
MTH$DTAND angle-in-degrees
MTH$GTAND angle-in-degrees
Each of the above formats accepts one of the floating-point
types as input.
67.1 - Corresponding JSB Entry Points
MTH$TAND_R4
MTH$DTAND_R7
MTH$GTAND_R7
Each of the above JSB entry points accepts one of the floating-
point types as input.
67.2 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
Tangent of the angle specified by angle-in-degrees. MTH$TAND
returns an F-floating number. MTH$DTAND returns a D-floating
number. MTH$GTAND returns a G-floating number.
67.3 - Argument
angle-in-degrees
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input angle (in degrees). The angle-in-degrees argument is
the address of a floating-point number which is this angle. For
MTH$TAND, angle-in-degrees specifies an F-floating number. For
MTH$DTAND, angle-in-degrees specifies a D-floating number. For
MTH$GTAND, angle-in-degrees specifies a G-floating number.
| 68 - MTH$xTANH |
The Compute the Hyperbolic Tangent routine returns the hyperbolic
tangent of the input value.
Format
MTH$TANH floating-point-input-value
MTH$DTANH floating-point-input-value
MTH$GTANH floating-point-input-value
Each of the above formats accepts one of the floating-point
types as input.
68.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: write only
mechanism: by value
The hyperbolic tangent of floating-point-input-value. MTH$TANH
returns an F-floating number. MTH$DTANH returns a D-floating
number. MTH$GTANH returns a G-floating number.
68.2 - Argument
floating-point-input-value
OpenVMS usage:floating_point
type: F_floating, D_floating, G_floating
access: read only
mechanism: by reference
The input value. The floating-point-input-value argument is the
address of a floating-point number that contains this input
value. For MTH$TANH, floating-point-input-value specifies an
F-floating number. For MTH$DTANH, floating-point-input-value
specifies a D-floating number. For MTH$GTANH, floating-point-
input-value specifies a G-floating number.
| 69 - MTH$UMAX |
The Compute Unsigned Maximum routine computes the unsigned
longword maximum of n unsigned longword arguments, where n is
greater than or equal to 1.
Format
MTH$UMAX argument [argument,...]
69.1 - Returns
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: write only
mechanism: by value
Maximum value returned by MTH$UMAX.
69.2 - Arguments
argument
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by reference
Argument whose maximum MTH$UMAX computes. Each argument argument
is an unsigned longword that contains one of these values.
argument
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by reference
Additional arguments whose maximum MTH$UMAX computes. Each
argument argument is an unsigned longword that contains one of
these values.
| 70 - MTH$UMIN |
The Compute Unsigned Minimum routine computes the unsigned
longword minimum of n unsigned longword arguments, where n is
greater than or equal to 1.
Format
MTH$UMIN argument [argument,...]
70.1 - Returns
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: write only
mechanism: by value
Minimum value returned by MTH$UMIN.
70.2 - Arguments
argument
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by reference
Argument whose minimum MTH$UMIN computes. Each argument argument
is an unsigned longword that contains one of these values.
argument
OpenVMS usage:longword_unsigned
type: longword (unsigned)
access: read only
mechanism: by reference
Additional arguments whose minimum MTH$UMIN computes. Each
argument argument is an unsigned longword that contains one of
these values.
| 71 - BLAS1$VIxAMAX |
The Obtain the Index of the First Element of a Vector Having
the Largest Absolute Value routine finds the index of the first
occurrence of a vector element having the maximum absolute value.
Format
BLAS1$VISAMAX n ,x ,incx
BLAS1$VIDAMAX n ,x ,incx
BLAS1$VIGAMAX n ,x ,incx
BLAS1$VICAMAX n ,x ,incx
BLAS1$VIZAMAX n ,x ,incx
BLAS1$VIWAMAX n ,x ,incx
Use BLAS1$VISAMAX for single-precision real operations.
Use BLAS1$VIDAMAX for double-precision real (D-floating)
operations.
Use BLAS1$VIGAMAX for double-precision real (G-floating)
operations.
Use BLAS1$VICAMAX for single-precision complex operations.
Use BLAS1$VIZAMAX for double-precision complex (D-floating)
operations.
Use BLAS1$VIWAMAX for double-precision complex (G-floating)
operations.
71.1 - Returns
OpenVMS usage:longword_signed
type: longword integer (signed)
access: write only
mechanism: by value
For the real versions of this routine, the function value is
the index of the first occurrence of a vector element having the
maximum absolute value, as follows:
|xi | = ma{ |j | for j = 1,2,...,n}
{ }
|x[i]| = max{|x[j]| for j = 1,2,...,n}
For the complex versions of this routine, the function value
is the index of the first occurrence of a vector element having
the largest sum of the absolute values of the real and imaginary
parts of the vector elements, as follows:
|Re(xi )|+|Im(xi )| = ma{ |Re(j )|+|Im(xj)| for j = 1,2,...,n }
{ }
|Re(x[i])| + |Im(x[i])| =
max{|Re(x[j])|+|Im(x[j])| for j = 1,2,...,n}
71.2 - Arguments
n
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of elements in vector x. The n argument is the address of
a signed longword integer containing the number of elements. If
you specify a negative value or 0 for n, 0 is returned.
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: read only
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. 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$VISAMAX F-floating real
BLAS1$VIDAMAX D-floating real
BLAS1$VIGAMAX G-floating real
BLAS1$VICAMAX F-floating complex
BLAS1$VIZAMAX D-floating complex
BLAS1$VIWAMAX G-floating complex
If n is less than or equal to 0, then imax is 0.
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 or equal to 0, then x is
referenced forward in array x; that is, xi is referenced as:
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.
| 72 - BLAS1$VxASUM |
The Obtain the Sum of the Absolute Values of the Elements of a
Vector routine determines the sum of the absolute values of the
elements of the n-element vector x.
Format
BLAS1$VSASUM n ,x ,incx
BLAS1$VDASUM n ,x ,incx
BLAS1$VGASUM n ,x ,incx
BLAS1$VSCASUM n ,x ,incx
BLAS1$VDZASUM n ,x ,incx
BLAS1$VGWASUM n ,x ,incx
Use BLAS1$VSASUM for single-precision real operations.
Use BLAS1$VDASUM for double-precision real (D-floating)
operations.
Use BLAS1$VGASUM for double-precision real (G-floating)
operations.
Use BLAS1$VSCASUM for single-precision complex operations.
Use BLAS1$VDZASUM for double-precision complex (D-floating)
operations.
Use BLAS1$VGWASUM for double-precision complex (G-floating)
operations.
72.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, or G_floating real
access: write only
mechanism: by value
The function value, called sum, is the sum of the absolute values
of the elements of the vector x. The data type of the function
value is a real number; for the BLAS1$VSCASUM, BLAS1$VDZASUM,
and BLAS1$VGWASUM routines, the data type of the function value
is the real data type corresponding to the complex argument data
type.
72.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 added. The n argument is
the address of a signed longword integer containing the number of
elements.
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: read only
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. 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$VSASUM F-floating real
BLAS1$VDASUM D-floating real
BLAS1$VGASUM G-floating real
BLAS1$VSCASUM F-floating complex
BLAS1$VDZASUM D-floating complex
BLAS1$VGWASUM G-floating complex
If n is less than or equal to 0, then sum is 0.0.
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 or equal to 0, then x is
referenced forward in array x; that is, xi 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.
| 73 - BLAS1$VxAXPY |
The Multiply a Vector by a Scalar and Add a Vector routine
computes ax + y, where a is a scalar number and x and y are n-
element vectors.
Format
BLAS1$VSAXPY n ,a ,x ,incx ,y ,incy
BLAS1$VDAXPY n ,a ,x ,incx ,y ,incy
BLAS1$VGAXPY n ,a ,x ,incx ,y ,incy
BLAS1$VCAXPY n ,a ,x ,incx ,y ,incy
BLAS1$VZAXPY n ,a ,x ,incx ,y ,incy
BLAS1$VWAXPY n ,a ,x ,incx ,y ,incy
Use BLAS1$VSAXPY for single-precision real operations.
Use BLAS1$VDAXPY for double-precision real (D-floating)
operations.
Use BLAS1$VGAXPY for double-precision real (G-floating)
operations.
Use BLAS1$VCAXPY for single-precision complex operations.
Use BLAS1$VZAXPY for double-precision complex (D-floating)
operations.
Use BLAS1$VWAXPY for double-precision complex (G-floating)
operations.
73.1 - Returns
None.
73.2 - Arguments
n
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of elements in vectors x and y. The n argument is the
address of a signed longword integer containing the number of
elements. If n is less than or equal to 0, then y 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, array reference
Scalar multiplier for the array x. The a argument is the address
of a floating-point or floating-point complex number that is this
multiplier. If a equals 0, then y is unchanged. If a shares a
memory location with any element of the vector y, results are
unpredictable. Specify the same data type for arguments a, x, and
y.
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: read only
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. The length of
this array is 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$VSAXPY F-floating real
BLAS1$VDAXPY D-floating real
BLAS1$VGAXPY G-floating real
BLAS1$VCAXPY F-floating complex
BLAS1$VZAXPY D-floating complex
BLAS1$VWAXPY G-floating complex
If any element of x shares a memory location with an element of
y, the 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 or equal to 0, then x is
referenced forward in array x; that is, xi 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 incx is less than 0, then x is referenced backward in array x;
that is, xi is referenced in:
x(1+(n-i)*|incx|)
where:
x = array specified in x
n = number of vector elements specified in n
i = element of the vector x
incx= increment argument for the array x specified in incx
y
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
On entry, array containing the elements to be accessed. All
elements of array y are accessed only if the increment argument
of y, called incy, is 1. The y argument is the address of a
floating-point or floating-point complex number that is this
array. The length of this array is at least:
1+(n-1)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
Specify the data type as follows:
Routine Data Type for y
BLAS1$VSAXPY F-floating real
BLAS1$VDAXPY D-floating real
BLAS1$VGAXPY G-floating real
BLAS1$VCAXPY F-floating complex
BLAS1$VZAXPY D-floating complex
BLAS1$VWAXPY G-floating complex
If n is less than or equal to 0, then y is unchanged. If any
element of x shares a memory location with an element of y, the
results are unpredictable.
On exit, y contains an array of length at least:
1+(n-1)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
After the call to BLAS1$VxAXPY, yi is set equal to:
y[i]+a*x[i]
where:
y = the vector y
i = element of the vector x or y
a = scalar multiplier for the vector x specified in a
x = the vector x
incy
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array y. The incy argument is the
address of a signed longword integer containing the increment
argument. If incy is greater than or equal to 0, then y is
referenced forward in array y; that is, (y[i]) is referenced
in:
y(1+(i-1)*incy)
where:
y = array specified in y
i = element of the vector y
incy= increment argument for the array y specified in incy
If incy is less than 0, then y is referenced backward in array y;
that is, (y[i]) is referenced in:
y(1+(n-i)*|incy|)
where:
y = array specified in y
n = number of vector elements specified in n
i = element of the vector y
incy= increment argument for the array y specified in incy
| 74 - BLAS1$VxCOPY |
The Copy a Vector routine copies n elements of the vector x to
the vector y.
Format
BLAS1$VSCOPY n ,x ,incx ,y ,incy
BLAS1$VDCOPY n ,x ,incx ,y ,incy
BLAS1$VCCOPY n ,x ,incx ,y ,incy
BLAS1$VZCOPY n ,x ,incx ,y ,incy
Use BLAS1$VSCOPY for single-precision real operations.
Use BLAS1$VDCOPY for double-precision real (D or G) operations.
Use BLAS1$VCCOPY for single-precision complex operations.
Use BLAS1$VZCOPY for double-precision complex (D or G)
operations.
74.1 - Returns
None.
74.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 copied. The n argument is
the address of a signed longword integer containing the number of
elements in vector x. If n is less than or equal to 0, then y 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: read only
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. 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$VSCOPY F-floating real
BLAS1$VDCOPY D-floating or G-floating real
BLAS1$VCCOPY F-floating complex
BLAS1$VZCOPY D-floating or G-floating complex
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 or equal to 0, then x is
referenced forward in array x; that is, xi 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 incx is less than 0, then x is referenced backward in array x;
that is, xi is referenced in:
x(1+(n-i)*|incx|)
where:
x = array specified in x
n = number of vector elements specified in n
i = element of the vector x
incx= increment argument for the array x specified in incx
y
OpenVMS usage:floating_point or complex_number
type: F_floating, D_floating, G_floating real or
F_floating, D_floating, G_floating complex
access: write only
mechanism: by reference, array reference
Array that receives the copied elements. All elements of array y
receive the copied elements only if the increment argument of y,
called incy, is 1. The y argument is the address of a floating-
point or floating-point complex number that is this array. This
argument is an array of length at least:
1+(n-1)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
Specify the data type as follows:
Routine Data Type for y
BLAS1$VSCOPY F-floating real
BLAS1$VDCOPY D-floating or G-floating real
BLAS1$VCCOPY F-floating complex
BLAS1$VZCOPY D-floating or G-floating complex
If n is less than or equal to 0, then y is unchanged. If incx
is equal to 0, then each yi is set to x1. If incy is equal to
0, then yi is set to the last referenced element of x. If any
element of x shares a memory location with an element of y, the
results are unpredictable.
incy
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array y. The incy argument is the
address of a signed longword integer containing the increment
argument. If incy is greater than or equal to 0, then y is
referenced forward in array y; that is, y[i] is referenced in:
y(1+(i-1)*incy)
where:
y = array specified in y
i = element of the vector y
If incy is less than 0, then y is referenced backward in array y;
that is, y[i] is referenced in:
y(1+(n-i)*|incy|)
where:
y = array specified in y
n = number of vector elements specified in n
i = element of the vector y
incy= increment argument for the array y specified in incy
| 75 - BLAS1$VxDOTx |
The Obtain the Inner Product of Two Vectors routine returns the
dot product of two n-element vectors, x and y.
Format
BLAS1$VSDOT n ,x ,incx ,y ,incy
BLAS1$VDDOT n ,x ,incx ,y ,incy
BLAS1$VGDOT n ,x ,incx ,y ,incy
BLAS1$VCDOTU n ,x ,incx ,y ,incy
BLAS1$VCDOTC n ,x ,incx ,y ,incy
BLAS1$VZDOTU n ,x ,incx ,y ,incy
BLAS1$VWDOTU n ,x ,incx ,y ,incy
BLAS1$VZDOTC n ,x ,incx ,y ,incy
BLAS1$VWDOTC n ,x ,incx ,y ,incy
Use BLAS1$VSDOT to obtain the inner product of two single-
precision real vectors.
Use BLAS1$VDDOT to obtain the inner product of two double-
precision (D-floating) real vectors. Use BLAS1$VGDOT to obtain
the inner product of two double-precision (G-floating) real
vectors.
Use BLAS1$VCDOTU to obtain the inner product of two single-
precision complex vectors (unconjugated).
Use BLAS1$VCDOTC to obtain the inner product of two single-
precision complex vectors (conjugated).
Use BLAS1$VZDOTU to obtain the inner product of two double-
precision (D-floating) complex vectors (unconjugated). Use
BLAS1$VWDOTU to obtain the inner product of two double-
precision (G-floating) complex vectors (unconjugated).
Use BLAS1$VZDOTC to obtain the inner product of two double-
precision (D-floating) complex vectors (conjugated). Use
BLAS1$VWDOTC to obtain the inner product of two double-
precision (G-floating) complex vectors (conjugated).
75.1 - Returns
OpenVMS usage:floating_point or complex_number
type: F_floating, D_floating, G_floating real or
F_floating, D_floating, G_floating complex
access: write only
mechanism: by value
The function value, called dotpr, is the dot product of two n-
element vectors, x and y. Specify the same data type for dotpr
and the argument x.
75.2 - Arguments
n
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of elements in vector x. The n argument is the address of
a signed longword integer containing the number of elements. If
you specify a value for n that is less than or equal to 0, then
the value of dotpr is 0.0.
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: read only
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. 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$VSDOT F-floating real
BLAS1$VDDOT D-floating real
BLAS1$VGDOT G-floating real
BLAS1$VCDOTU and F-floating complex
BLAS1$VCDOTC
BLAS1$VZDOTU and D-floating complex
BLAS1$VZDOTC
BLAS1$VWDOTU and G-floating complex
BLAS1$VWDOTC
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 incx is less than 0, then x is referenced backward in array x;
that is, x[i] is referenced in:
x(1+(n-i)*|incx|)
where:
x = array specified in x
n = number of vector elements specified in n
i = element of the vector x
incx= increment argument for the array x specified in incx
y
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, array reference
Array containing the elements to be accessed. All elements of
array y are accessed only if the increment argument of y, called
incy, is 1. The y argument is the address of a floating-point or
floating-point complex number that is this array. This argument
is an array of length at least:
1+(n-1)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
Specify the data type as follows:
Routine Data Type for y
BLAS1$VSDOT F-floating real
BLAS1$VDDOT D-floating real
BLAS1$VGDOT G-floating real
BLAS1$VCDOTU and F-floating complex
BLAS1$VCDOTC
BLAS1$VZDOTU and D-floating complex
BLAS1$VZDOTC
BLAS1$VWDOTU and G-floating complex
BLAS1$VWDOTC
incy
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array y. The incy argument is the
address of a signed longword integer containing the increment
argument. If incy is greater than or equal to 0, then y is
referenced forward in array y; that is, y[i] is referenced in:
y(1+(i-1)*incy)
where:
y = array specified in y
i = element of the vector y
incy= increment argument for the array y specified in incy
If incy is less than 0, then y is referenced backward in array y;
that is, y[i] is referenced in:
y(1+(n-i)*|incy|)
where:
y = array specified in y
n = number of vector elements specified in n
i = element of the vector y
incy= increment argument for the array y specified in incy
| 76 - BLAS1$VxNRM2 |
The Obtain the Euclidean Norm of a Vector routine obtains the
Euclidean norm of an n-element vector x, expressed as follows:
___________________________________
/ x[1]**2 + x[2]**2 + ... + x[n]**2
\/
Format
BLAS1$VSNRM2 n ,x ,incx
BLAS1$VDNRM2 n ,x ,incx
BLAS1$VGNRM2 n ,x ,incx
BLAS1$VSCNRM2 n ,x ,incx
BLAS1$VDZNRM2 n ,x ,incx
BLAS1$VGWNRM2 n ,x ,incx
Use BLAS1$VSNRM2 for single-precision real operations.
Use BLAS1$VDNRM2 for double-precision real (D-floating)
operations.
Use BLAS1$VGNRM2 for double-precision real (G-floating)
operations.
Use BLAS1$VSCNRM2 for single-precision complex operations.
Use BLAS1$VDZNRM2 for double-precision complex (D-floating)
operations.
Use BLAS1$VGWNRM2 for double-precision complex (G-floating)
operations.
76.1 - Returns
OpenVMS usage:floating_point
type: F_floating, D_floating, or G_floating real
access: write only
mechanism: by value
The function value, called e_norm, is the Euclidean norm of
the vector x. The data type of the function value is a real
number; for the BLAS1$VSCNRM2, BLAS1$VDZNRM2, and BLAS1$VGWNRM2
routines, the data type of the function value is the real data
type corresponding to the complex argument data type.
76.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 processed. The n argument is
the address of a signed longword integer containing the number of
elements.
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: read only
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. 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$VSNRM2 F-floating real
BLAS1$VDNRM2 D-floating real
BLAS1$VGNRM2 G-floating real
BLAS1$VSCNRM2 F-floating complex
BLAS1$VDZNRM2 D-floating complex
BLAS1$VGWNRM2 G-floating complex
If n is less than or equal to 0, then e_norm is 0.0.
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 or equal to 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.
| 77 - BLAS1$VxROT |
The Apply a Givens Plane Rotation routine applies a Givens plane
rotation to a pair of n-element vectors x and y.
Format
BLAS1$VSROT n ,x ,incx ,y ,incy ,c ,s
BLAS1$VDROT n ,x ,incx ,y ,incy ,c ,s
BLAS1$VGROT n ,x ,incx ,y ,incy ,c ,s
BLAS1$VCSROT n ,x ,incx ,y ,incy ,c ,s
BLAS1$VZDROT n ,x ,incx ,y ,incy ,c ,s
BLAS1$VWGROT n ,x ,incx ,y ,incy ,c ,s
Use BLAS1$VSROT for single-precision real operations.
Use BLAS1$VDROT for double-precision real (D-floating)
operations.
Use BLAS1$VGROT for double-precision real (G-floating)
operations.
Use BLAS1$VCSROT for single-precision complex operations.
Use BLAS1$VZDROT for double-precision complex (D-floating)
operations.
Use BLAS1$VWGROT for double-precision complex (G-floating)
operations.
BLAS1$VCSROT, BLAS1$VZDROT, and BLAS1$VWGROT are real rotations
applied to a complex vector.
77.1 - Returns
None.
77.2 - Arguments
n
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Number of elements in vectors x and y to be rotated. The n
argument is the address of a signed longword integer containing
the number of elements to be rotated. If n is less than or equal
to 0, then x and y are 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$VSROT F-floating real
BLAS1$VDROT D-floating real
BLAS1$VGROT G-floating real
BLAS1$VCSROT F-floating complex
BLAS1$VZDROT D-floating complex
BLAS1$VWGROT G-floating complex
If n is less than or equal to 0, then x and y are unchanged. If
c equals 1.0 and s equals 0, then x and y are unchanged. If any
element of x shares a memory location with an element of y, then
the results are unpredictable.
On exit, x contains the rotated vector x, as follows:
xi< - c*x i+s*y i x[i]< - c*x[i]+s*y[i]
where:
x = array x specified in x
y = array y specified in y
i = i = 1,2,...,n
c = rotation element generated by the BLAS1$VxROTG routines
s = rotation element generated by the BLAS1$VxROTG routines
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 or equal to 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 incx is less than 0, then x is referenced backward in array x;
that is, x[i] is referenced in:
x(1+(n-i)*|incx|)
where:
x = array specified in x
n = number of vector elements specified in n
i = element of the vector x
incx= increment argument for the array x specified in incx
y
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 y are accessed only if the increment argument of y, called
incy, is 1. The y 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 y
BLAS1$VSROT F-floating real
BLAS1$VDROT D-floating real
BLAS1$VGROT G-floating real
BLAS1$VCSROT F-floating complex
BLAS1$VZDROT D-floating complex
BLAS1$VWGROT G-floating complex
If n is less than or equal to 0, then x and y are unchanged. If
c equals 1.0 and s equals 0, then x and y are unchanged. If any
element of x shares a memory location with an element of y, then
the results are unpredictable.
On exit, y contains the rotated vector y, as follows:
yi< - -s*x i +c*y i y[i]< - -s*x[i]+c*y[i]
where:
x = array x specified in x
y = array y specified in y
i = i = 1,2,...,n
c = real rotation element (can be generated by the BLAS1$VxROTG
routines)
s = complex rotation element (can be generated by the
BLAS1$VxROTG routines)
incy
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array y. The incy argument is the
address of a signed longword integer containing the increment
argument. If incy is greater than or equal to 0, then y is
referenced forward in array y; that is, y[i] is referenced in:
y(1+(i-1)*incy)
where:
y = array specified in y
i = element of the vector y
incy= increment argument for the array y specified in incy
If incy is less than 0, then y is referenced backward in array y;
that is, y[i] is referenced in:
y(1+(n-i)*|incy|)
where:
y = array specified in y
n = number of vector elements specified in n
i = element of the vector y
incy= increment argument for the array y specified in incy
c
OpenVMS usage:floating_point
type: F_floating, D_floating, or G_floating real
access: read only
mechanism: by reference
First rotation element, which can be interpreted as the cosine
of the angle of rotation. The c argument is the address of a
floating-point or floating-point complex number that is this
vector element. The c argument is the first rotation element
generated by the BLAS1$VxROTG routines.
Specify the data type (which is always real) as follows:
Routine Data Type for c
BLAS1$VSROT and F-floating real
BLAS1$VCSROT
BLAS1$VDROT and D-floating real
BLAS1$VZDROT
BLAS1$VGROT and G-floating real
BLAS1$VWGROT
s
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
Second rotation element, which can be interpreted as the sine
of the angle of rotation. The s argument is the address of a
floating-point or floating-point complex number that is this
vector element. The s argument is the second rotation element
generated by the BLAS1$VxROTG routines.
Specify the data type (which can be either real or complex) as
follows:
Routine Data Type for s
BLAS1$VSROT and F-floating real or F-floating complex
BLAS1$VCSROT
BLAS1$VDROT and D-floating real or D-floating complex
BLAS1$VZDROT
BLAS1$VGROT and G-floating real or G-floating complex
BLAS1$VWGROT
| 78 - BLAS1$VxROTG |
The Generate the Elements for a Givens Plane Rotation routine
constructs a Givens plane rotation that eliminates the second
element of a two-element vector.
Format
BLAS1$VSROTG a ,b ,c ,s
BLAS1$VDROTG a ,b ,c ,s
BLAS1$VGROTG a ,b ,c ,s
BLAS1$VCROTG a ,b ,c ,s
BLAS1$VZROTG a ,b ,c ,s
BLAS1$VWROTG a ,b ,c ,s
Use BLAS1$VSROTG for single-precision real operations.
Use BLAS1$VDROTG for double-precision real (D-floating)
operations.
Use BLAS1$VGROTG for double-precision real (G-floating)
operations.
Use BLAS1$VCROTG for single-precision complex operations.
Use BLAS1$VZROTG for double-precision complex (D-floating)
operations.
Use BLAS1$VWROTG for double-precision complex (G-floating)
operations.
78.1 - Returns
None.
78.2 - Arguments
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: modify
mechanism: by reference
On entry, first element of the input vector. On exit, rotated
element r. The a argument is the address of a floating-point or
floating-point complex number that is this vector element.
Specify the data type as follows:
Routine Data Type for a
BLAS1$VSROTG F-floating real
BLAS1$VDROTG D-floating real
BLAS1$VGROTG G-floating real
BLAS1$VCROTG F-floating complex
BLAS1$VZROTG D-floating complex
BLAS1$VWROTG G-floating complex
b
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
On entry, second element of the input vector. On exit from
BLAS1$VSROTG, BLAS1$VDROTG, and BLAS1$VGROTG, reconstruction
element z. The b argument is the address of a floating-point or
floating-point complex number that is this vector element.
Specify the data type as follows:
Routine Data Type for b
BLAS1$VSROTG F-floating real
BLAS1$VDROTG D-floating real
BLAS1$VGROTG G-floating real
BLAS1$VCROTG F-floating complex
BLAS1$VZROTG D-floating complex
BLAS1$VWROTG G-floating complex
c
OpenVMS usage:floating_point
type: F_floating, D_floating, or G_floating real
access: write only
mechanism: by reference
First rotation element, which can be interpreted as the cosine
of the angle of rotation. The c argument is the address of a
floating-point or floating-point complex number that is this
vector element.
Specify the data type (which is always real) as follows:
Routine Data Type for c
BLAS1$VSROTG and F-floating real
BLAS1$VCROTG
BLAS1$VDROTG and D-floating real
BLAS1$VZROTG
BLAS1$VGROTG and G-floating real
BLAS1$VWROTG
s
OpenVMS usage:floating_point or complex_number
type: F_floating, D_floating, G_floating real or
F_floating, D_floating, G_floating complex
access: write only
mechanism: by reference
Second rotation element, which can be interpreted as the sine
of the angle of rotation. The s argument is the address of a
floating-point or floating-point complex number that is this
vector element.
Specify the data type as follows:
Routine Data Type for s
BLAS1$VSROTG F-floating real
BLAS1$VDROTG D-floating real
BLAS1$VGROTG G-floating real
BLAS1$VCROTG F-floating complex
BLAS1$VZROTG D-floating complex
BLAS1$VWROTG G-floating complex
| 79 - BLAS1$VxSCAL |
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.
79.1 - Returns
None.
79.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.
| 80 - BLAS1$VxSWAP |
The Swap the Elements of Two Vectors routine swaps n elements of
the vector x with the vector y.
Format
BLAS1$VSSWAP n ,x ,incx ,y ,incy
BLAS1$VDSWAP n ,x ,incx ,y ,incy
BLAS1$VCSWAP n ,x ,incx ,y ,incy
BLAS1$VZSWAP n ,x ,incx ,y ,incy
Use BLAS1$VSSWAP for single-precision real operations.
Use BLAS1$VDSWAP for double-precision real (D or G) operations.
Use BLAS1$VCSWAP for single-precision complex operations.
Use BLAS1$VZSWAP for double-precision complex (D or G)
operations.
80.1 - Returns
None.
80.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 swapped. The n argument is
the address of a signed longword integer containing the number of
elements to be swapped.
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$VSSWAP F-floating real
BLAS1$VDSWAP D-floating or G-floating real
BLAS1$VCSWAP F-floating complex
BLAS1$VZSWAP D-floating or G-floating complex
If n is less than or equal to 0, then x and y are unchanged. If
any element of x shares a memory location with an element of y,
the results are unpredictable.
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$VxSWAP, n elements of the array specified
by x are interchanged with n elements of the array specified by
y.
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 or equal to 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 incx is less than 0, then x is referenced backward in array x;
that is, x[i] is referenced in:
x(1+(n-i)*|incx|)
where:
x = array specified in x
n = number of vector elements specified in n
i = element of the vector x
incx= increment argument for the array x specified in incx
y
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 y are accessed only if the increment argument of y, called
incy, is 1. The y 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)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
Specify the data type as follows:
Routine Data Type for y
BLAS1$VSSWAP F-floating real
BLAS1$VDSWAP D-floating or G-floating real
BLAS1$VCSWAP F-floating complex
BLAS1$VZSWAP D-floating or G-floating complex
If n is less than or equal to 0, then x and y are unchanged. If
any element of x shares a memory location with an element of y,
the results are unpredictable.
On exit, y is an array of length at least:
1+(n-1)*|incy|
where:
n = number of vector elements specified in n
incy= increment argument for the array y specified in incy
After the call to BLAS1$VxSWAP, n elements of the array specified
by x are interchanged with n elements of the array specified by
y.
incy
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array y. The incy argument is the
address of a signed longword integer containing the increment
argument. If incy is greater than or equal to 0, then y is
referenced forward in array y; that is, y[i] is referenced in:
y(1+(i-1)*incy)
where:
y = array specified in y
i = element of the vector y
incy= increment argument for the array y specified in incy
If incy is less than 0, then y is referenced backward in array y;
that is, y[i] is referenced in:
y(1+(n-i)*|incy|)
where:
y = array specified in y
n = number of vector elements specified in n
i = element of the vector y
incy= increment argument for the array y specified in incy
| 81 - MTH$VxFOLRy MA V15 |
The First Order Linear Recurrence - Multiplication and Addition
routine provides a vectorized algorithm for the linear recurrence
relation that includes both multiplication and addition
operations.
Format
MTH$VJFOLRP_MA_V15 n,a,inca,b,incb,c,incc
MTH$VFFOLRP_MA_V15 n,a,inca,b,incb,c,incc
MTH$VDFOLRP_MA_V15 n,a,inca,b,incb,c,incc
MTH$VGFOLRP_MA_V15 n,a,inca,b,incb,c,incc
MTH$VJFOLRN_MA_V15 n,a,inca,b,incb,c,incc
MTH$VFFOLRN_MA_V15 n,a,inca,b,incb,c,incc
MTH$VDFOLRN_MA_V15 n,a,inca,b,incb,c,incc
MTH$VGFOLRN_MA_V15 n,a,inca,b,incb,c,incc
To obtain one of the preceding formats, substitute the
following for x and y in MTH$VxFOLRy_MA_V15:
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
81.1 - Returns
None.
81.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.
c
OpenVMS usage:longword_signed or floating_point
type: longword integer (signed), F_floating, D_floating,
or G_floating
access: modify
mechanism: by reference, array reference
Array of length at least:
1+n*incc
where:
n = length of the linear recurrence specified in n
incc= increment argument for the array c specified in incc
The c argument is the address of a longword integer or floating-
point number that is this array.
incc
OpenVMS usage:longword_signed
type: longword integer (signed)
access: read only
mechanism: by reference
Increment argument for the array c. The incc argument is the
address of a signed longword integer containing the increment
argument. For contiguous elements, specify 1 for incc. Do not
specify 0 for incc.
| 82 - MTH$VxFOLRy z V8 |
The First Order Linear Recurrence - Multiplication or Addition
routine provides a vectorized algorithm for the linear recurrence
relation that includes either a multiplication or an addition
operation, but not both.
Format
MTH$VJFOLRP_M_V8 n,a,inca,b,incb
MTH$VFFOLRP_M_V8 n,a,inca,b,incb
MTH$VDFOLRP_M_V8 n,a,inca,b,incb
MTH$VGFOLRP_M_V8 n,a,inca,b,incb
MTH$VJFOLRN_M_V8 n,a,inca,b,incb
MTH$VFFOLRN_M_V8 n,a,inca,b,incb
MTH$VDFOLRN_M_V8 n,a,inca,b,incb
MTH$VGFOLRN_M_V8 n,a,inca,b,incb
MTH$VJFOLRP_A_V8 n,a,inca,b,incb
MTH$VFFOLRP_A_V8 n,a,inca,b,incb
MTH$VDFOLRP_A_V8 n,a,inca,b,incb
MTH$VGFOLRP_A_V8 n,a,inca,b,incb
MTH$VJFOLRN_A_V8 n,a,inca,b,incb
MTH$VFFOLRN_A_V8 n,a,inca,b,incb
MTH$VDFOLRN_A_V8 n,a,inca,b,incb
MTH$VGFOLRN_A_V8 n,a,inca,b,incb
To obtain one of the preceding formats, substitute the
following for x, y, and z in MTH$VxFOLRy_z_V8:
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
82.1 - Returns
None.
82.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: modify
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.
| 83 - 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
83.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.
83.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.
| 84 - 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
84.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.
84.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.
|
|
