Net.Data Reference

Math Functions

These functions let you do mathematical calculations.

Performance tip for UNIX, Windows NT, and OS/2: You can optimize the performance of mathematical functions with the DTW_OPTIMIZE_MATH configuration value by setting it to YES in the Net.Data initialization file or the macro file.

When set to YES, Net.Data uses C mathematical formatting and the functions run faster; however the output format is different than without this variable. Trailing zeros after a decimal point are not displayed.
When DTW_OPTIMIZE_MATH is set to NO, Net.Data uses REXX mathematical formatting. Functions run slower, but provide output formats that are consistent with the output generated by previous versions of Net.Data. The default value is NO.

See the configuration variables section of the Net.Data Administration and Programming Guide to learn how to configure this variable.

NLS considerations for math functions: Net.Data displays decimal points in numerical values based on regional settings specified at the Web server under which Net.Data is running. For example, if the decimal point is specified as a comma (,) at the Web server, Net.Data uses the comma to format decimal data. Net.Data uses the following settings to determine which character is used to specify a decimal point:

For OS/390, Windows NT, OS/2, and UNIX operating systems:

The LOCALE setting at the Web server

For the OS/400 operating system:

V4R2 or subsequent releases: specified by the user profile under which the process is running.
V4R1 or previous releases: retrieved from the QDECFMT system value.

The following functions are available for mathematical calculations:

DTW_ADD
DTW_DIVIDE
DTW_DIVREM
DTW_FORMAT
DTW_INTDIV
DTW_MULTIPLY
DTW_POWER
DTW_SUBTRACT

DTW_ADD

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Adds the values of two parameters.

Format

@DTW_ADD(number1, number2, precision, result)

@DTW_ADD(number1, number2, result)

@DTW_rADD(number1, number2, precision)

@DTW_rADD(number1, number2)

Values

Table 40. DTW_ADD Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the sum of number1 and number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the sum of `number1` and `number2`.

Examples

Example 1:

@DTW_ADD(NUM1, NUM2, "2", result)

Input: NUM1 = "105", NUM2 = "3"
Returns: result = "1.1E+2"

Example 2:

@DTW_rADD("12", NUM2, "5")

Input: NUM2 = "7.00"
Returns: "19.00"

DTW_DIVIDE

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Divides the value of the first parameter by the value of the second parameter.

Format

@DTW_DIVIDE(number1, number2, precision, result)

@DTW_DIVIDE(number1, number2, result)

@DTW_rDIVIDE(number1, number2, precision)

@DTW_rDIVIDE(number1, number2)

Values

Table 41. DTW_DIVIDE Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the result of number1 divided by number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the result of `number1` divided by `number2`.

Examples

Example 1:

@DTW_DIVIDE("8.0", NUM2, result)

Input: NUM2 = "2"
Returns: result = "4"

Example 2:

@DTW_rDIVIDE("1", NUM2, "5")

Input: "1", NUM2 = "3"
Returns: "0.33333"

Example 3:

@DTW_rDIVIDE(NUM1, "2", "5")

Input: NUM1 = "5"
Returns: "2.5"

DTW_DIVREM

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Divides the first parameter by the second parameter and returns the remainder. The sign of the remainder, if nonzero, is the same as that of the first parameter.

Format

@DTW_DIVREM(number1, number2, precision, result)

@DTW_DIVREM(number1, number2, result)

@DTW_rDIVREM(number1, number2, precision)

@DTW_rDIVREM(number1, number2)

Values

Table 42. DTW_DIVREM Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the remainder of number1 divided by number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the remainder of `number1` divided by `number2`.

Examples

Example 1:

@DTW_DIVREM(NUM1, NUM2, result)

Input: NUM1 = "2.1", NUM2 = "3"
Returns: result = "2.1"

Example 2:

@DTW_rDIVREM("10", NUM2)

Input: NUM2 = "0.3"
Returns: "0.1"

Example 3:

@DTW_rDIVREM("3.6", "1.3")

Returns: "1.0"

Example 4:

@DTW_rDIVREM("-10", "3")

Returns: "-1"

DTW_FORMAT

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Customizes the formatting for a number. If only the number parameter is specified, the result is formatted just as if @DTW_rADD(number,"0") was performed. If any other options are specified then the number is formatted according to the following rules:

The before and after parameters describe how many characters are used for the integer and decimal parts of the result parameter, respectively. If you omit either or both of these parameters, the number of characters used for that part is as many as is needed.
If the before parameter is not large enough to contain the integer part of the number (plus the sign for a negative number), an error results. If the before parameter is larger than needed for that part, the number parameter value is padded on the left with blanks. If the after parameter is not the same size as the decimal part of the number parameter, the number is rounded (or extended with zeros) to fit. Specifying 0 causes the number to be rounded to an integer.
In addition, the expp and expt parameters control the exponent part of the result. The expp parameter sets the number of places for the exponent part; the default is to use as many as is needed (which may be zero). The expt parameter sets the trigger point for use of exponential notation. The default is the default value of the precision parameter.
If expp is 0, no exponent is supplied and the number is expressed in simple form with added zeros as necessary. If expp is not large enough to contain the exponent, an error results.
If the number of places needed for the integer or decimal part exceeds expt or twice expt, respectively, use the exponential notation. If expt is 0, exponential notation is always used unless the exponent is 0. (If expp is 0, this overrides a 0 value of expt.) If the exponent is 0 when a nonzero expp is specified, then expp+2 blanks are supplied for the exponent part of the result. If the exponent is 0 and expp is not specified, the simple form is used.

Format

@DTW_FORMAT(number, before, after, expp, expt, precision, result)

@DTW_FORMAT(number, before, after, expp, expt, result)

@DTW_FORMAT(number, before, after, expp, result)

@DTW_FORMAT(number, before, after, result)

@DTW_FORMAT(number, before, result)

@DTW_FORMAT(number, result)

@DTW_rFORMAT(number, before, after, expp, expt, precision)

@DTW_rFORMAT(number, before, after, expp, expt)

@DTW_rFORMAT(number, before, after, expp)

@DTW_rFORMAT(number, before, after)

@DTW_rFORMAT(number, before)

@DTW_rFORMAT(number)

Values

Table 43. DTW_FORMAT Parameters

Data Type Parameter Use Description
float number IN A variable or literal string representing a number.
integer before IN A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to have additional parameters.
integer after IN A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to specify additional parameters.
integer expp IN A variable or literal string representing a positive whole number. You must specify a null string ("") to specify additional parameters.
integer expt IN A variable or literal string representing a positive whole number. You must enter a null string ("") to specify additional parameters.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the number with the specified rounding and formatting.

Data Type	Parameter	Use	Description
float	`number`	IN	A variable or literal string representing a number.
integer	`before`	IN	A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to have additional parameters.
integer	`after`	IN	A variable or literal string representing a positive whole number. This is an optional parameter. You must enter a null string ("") to specify additional parameters.
integer	`expp`	IN	A variable or literal string representing a positive whole number. You must specify a null string ("") to specify additional parameters.
integer	`expt`	IN	A variable or literal string representing a positive whole number. You must enter a null string ("") to specify additional parameters.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the number with the specified rounding and formatting.

Examples

Example 1:

@DTW_FORMAT(NUM, BEFORE, result)

Input: NUM = "3", BEFORE = "4"
Returns: result= " 3"

Example 2:

@DTW_FORMAT("1.73", "4", "0", result)

Returns: result = " 2"

Example 3:

@DTW_FORMAT("1.73", "4", "3", result)

Returns: result = " 1.730"

Example 4:

@DTW_FORMAT(" - 12.73", "", "4", result)

Returns: result = "-12.7300"

Example 5:

@DTW_FORMAT("12345.73", "", "", "2", "2", result)

Returns: result = "1.234573E+04"

Example 6:

@DTW_FORMAT("1.234573", "", "3", "", "0", result)

Returns: result = "1.235"

Example 7:

@DTW_rFORMAT(" - 12.73")

Returns: " - 12.73"

Example 8:

@DTW_rFORMAT("0.000")

Returns: "0"

Example 9:

@DTW_rFORMAT("12345.73", "", "", "3", "6")

Returns: "12345.73"

Example 10:

@DTW_rFORMAT("1234567e5", "", "3", "0")

Returns: "123456700000.000"

Example 11:

@DTW_rFORMAT("12345.73", "", "3", "", "0")

Returns: "1.235E+4"

DTW_INTDIV

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Divides the first parameter by the second parameter and returns the integer part of the result.

Format

@DTW_INTDIV(number1, number2, precision, result)

@DTW_INTDIV(number1, number2, result)

@DTW_rINTDIV(number1, number2, precision)

@DTW_rINTDIV(number1, number2)

Values

Table 44. DTW_INTDIV Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains integer part of number1 divided by number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains integer part of `number1` divided by `number2`.

Examples

Example 1:

@DTW_INTDIV(NUM1, NUM2, result)

Input: NUM1 = "10", NUM2 = "3"
Returns: result = "3"

Example 2:

@DTW_rINTDIV("2", NUM2)

Input: NUM2 = "3"
Returns: "0"

DTW_MULTIPLY

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Multiplies two parameters and returns the result.

Format

@DTW_MULTIPLY(number1, number2, precision, result)

@DTW_MULTIPLY(number1, number2, result)

@DTW_rMULTIPLY(number1, number2, precision)

@DTW_rMULTIPLY(number1, number2)

Values

Table 45. DTW_MULTIPLY Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the product of number1 and number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the product of `number1` and `number2`.

Examples

Example 1:

@DTW_MULTIPLY(NUM1, NUM2, result)

Input: NUM1 = "4", NUM2 = "5"
Returns: result = "20"

Example 2:

@DTW_rMULTIPLY("0.9", NUM2)

Input: NUM2 = "0.8"
Returns: "0.72"

DTW_POWER

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Raises the first parameter to the power of the second parameter and returns the result.

Format

@DTW_POWER(number1, number2, precision, result)

@DTW_POWER(number1, number2, result)

@DTW_rPOWER(number1, number2, precision)

@DTW_rPOWER(number1, number2)

Values

Table 46. DTW_POWER Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the result of number1 raised to the power of number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the result of `number1` raised to the power of `number2`.

Examples

Example 1:

@DTW_POWER(NUM1, NUM2, result)

Input: NUM1 = "2", NUM2 = "-3"
Returns: result = "0.125"

Example 2:

@DTW_rPOWER("1.7", NUM2, precision)

Input: NUM2 = "8", precision = "5"
Returns: "69.758"

DTW_SUBTRACT

AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X X X X X X

Purpose

Subtracts the value of the second parameter from the value of the first parameter and returns the result.

Format

@DTW_SUBTRACT(number1, number2, precision, result)

@DTW_SUBTRACT(number1, number2, result)

@DTW_rSUBTRACT(number1, number2, precision)

@DTW_rSUBTRACT(number1, number2)

Values

Table 47. DTW_SUBTRACT Parameters

Data Type Parameter Use Description
float number1 IN A variable or literal string representing a number.
float number2 IN A variable or literal string representing a number.
integer precision IN A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float result OUT A variable that contains the difference of number1 and number2.

Data Type	Parameter	Use	Description
float	`number1`	IN	A variable or literal string representing a number.
float	`number2`	IN	A variable or literal string representing a number.
integer	`precision`	IN	A variable or literal string representing a positive whole number that specifies the precision of the result. The default is 9.
float	`result`	OUT	A variable that contains the difference of `number1` and `number2`.

Examples

Example 1:

@DTW_SUBTRACT(NUM1, NUM2, comp)
%IF(comp > "0")
<P>$(NUM1) is larger than  $(NUM2).
%ENDIF

Input: NUM2 = "2.07"
Returns: "-0.77"

This example shows a way to compare numeric values, which are strings in Net.Data.

Example 2:

@DTW_SUBTRACT(NUM1, NUM2, result)

Input: NUM1 = "1.3, NUM2 = "1.07"
Returns: result = "0.23"

Example 3:

@DTW_rSUBTRACT("1.3", NUM2)

Input: NUM2 = "2.07"
Returns: "-0.77"

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]