11.3 currencyset (Change Currency Information Setting)

Name

[Windows Manager]
Installation_folder\RCXCTMG\Charging\bin\currencyset - Change Currency Information Setting

[Linux Manager]
/opt/FJSVctchg/bin/currencyset.sh - Change Currency Information Setting

Synopsis

[Windows Manager]

currencyset {currency_code | -f currency_information_output_file | -reset}

[Linux Manager]

currencyset.sh {currency_code | -f currency_information_output_file | -reset}

Function description

This command configures the currency codes and the currency units.

You can specify the -f option and a file name - the command will output information about the configured currency units to the specified file.

You can specify the -reset option to reset the currency units to the default state.

Note

Stop the manager software before executing this command.
Do not change the currency information once you start the charging operation.

Options

{ currency_code | -f currency_information_output_file | -reset}}

currency_code

Specify an ISO 4217 currency code (three alphabetic characters) for the currency code.

The following table shows examples of currency codes and currency unit information - other ISO 4217 currency codes can also be specified.

Currency code	Currency	Currency sign	Number of decimal places
USD	United States Dollar	$	2
JPY	Japanese Yen	¥	0
EUR	Euro	EUR	2
SGD	Singapore dollar	S$	2

Point

Number of decimal places

The maximum number of decimal places that can be used when displaying estimated charges or calculating the usage charge is the number of decimal places of the set currency unit. The unit of the unit price to be specified in the accounting information file depends on the number of decimal places of the set currency unit.
Refer to "15.2.2 Accounting Information File Format" in the "Operation Guide CE" for information on the accounting information file.

-f currency_information_output_file

Information about the configured currencies is output to a file using the character encoding UTF-8.

The content of the output file is as shown below:

currency.code = currency_code
currency.symbol = currency_symbol
currency.fraction.digits = number_of_decimal_places

An error occurs if the specified file already exists. Specify a file name that does not exist.

-reset: Resets the currency unit to the initial value (USD).

Requirements

Permissions: Infrastructure administrator with OS administrator privilege

Location: Admin server

Example

[Windows Manager]

> currencyset EUR
> currencyset -f currencyinfo.txt
> currencyset -reset

[Linux Manager]

# currencyset.sh EUR
# currencyset.sh -f currencyinfo.txt
# currencyset.sh -reset

Exit Status

This command returns the following values:

0: The command executed successfully.

1: An error has occurred.