$DIV (division)

$DIV performs division, treating character strings as numeric values, and returns the arithmetic result.

For example, the Asset Console standard memory and disk sizes are managed in megabyte units. To register information managed in gigabyte units in the asset management database, you need to change the units to megabytes. To do so, you can use the $DIV embedded function to convert from gigabytes to megabytes.

Organization of this page

Syntax
Values
Status
Remarks
Example

Syntax

return-value=$DIV(character-string,numeric-character)

To Page Top

Values

return-value

Specifies the name of the variable into which the arithmetic result is set. Valid results range from 0.0001 to 999,999,999,999,999 (15 digits).
character-string

Specifies a dividend, either as a constant or a variable. A constant must be enclosed in single quotation marks (''). Specified values can range from 0.0001 to 999,999,999,999,999 (15 digits).
numeric-character

Specifies a divisor, either as a constant or a variable. A numeric value specified as a constant that includes a decimal point must be enclosed in single quotation marks (''). Specified values can range from 0.0001 to 999,999,999,999,999 (15 digits).

To Page Top

Status

The following table lists and describes the possible statuses:

Status	Description
`NORMAL`	Normal end
`NODATA`	Indicates one of the following: An invalid value was specified in a character string or numeric. The arithmetic result is a value outside the range of representable values.
`ERROR`	—
Script execution interrupted	An invalid argument was specified, or an error other than the above occurred.

Legend:: —: Not applicable

To Page Top

Remarks

If a value that cannot be specified in character-string or numeric-character is encountered, or if the arithmetic result is a value outside the representable range, 0 is returned to return-value.

To Page Top

Example

The following example calculates 10 ÷ 5 and outputs the results:

[SET_VALUE]
  VAL1 = 10
  VAL2 = $DIV(VAL1, 5)
 
  MSG = 'DIV: ' +VAL1+ ' / 5 = ' +VAL2
  $ECHO(MSG)

Execution result:: DIV: 10 / 5 = 2

To Page Top