Skip to content

Commit 2be9ea4

Browse files
committed
Add section about charset handling to the documentation
1 parent 1b044c2 commit 2be9ea4

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,22 @@ ALTER SESSION SET NLS_LANGUAGE='AMERICAN';
5151
ALTER SESSION SET NLS_TERRITORY='AMERICA';
5252
```
5353

54+
## Charset
55+
56+
Java will use the default charset of your system for any string output.
57+
You can change this by passing the `-Dfile.encoding` property to the JVM when running a java-application.
58+
To avoid changing the utPLSQL-cli shell- or batchscript, you can define `-Dfile.encoding` in the environment variable `JAVA_TOOL_OPTIONS`.
59+
This environment variable will be picked up and interpreted by the JVM:
60+
61+
```
62+
export JAVA_TOOL_OPTIONS='-Dfile.encoding=utf8'
63+
utplsql run user/pw@connecstring
64+
65+
> Picked up JAVA_TOOL_OPTIONS: -Dfile.encoding=utf8
66+
```
67+
68+
Make sure that the defined charset matches with the codepage your console is using.
69+
5470
## Usage
5571
Currently, utPLSQL-cli supports the following sub-commands:
5672
- run

0 commit comments

Comments
 (0)