Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit c8b10b3

Browse files
committedApr 10, 2025·
Document new DAA api added in 0.46.0
#1504 OpenJ9 0.46.0 introduced a new Data Access Accelerator library class and API: com/ibm/dataaccess/ExternalDecimal.checkExternalDecimal. This is documented in 0.51.0 release. Closes #1504 Signed-off-by: Sreekala Gopakumar sreekala.gopakumar@ibm.com
1 parent f6e7a17 commit c8b10b3

File tree

2 files changed

+5
-3
lines changed

2 files changed

+5
-3
lines changed
 

‎docs/api-overview.md

+1
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ If your Java application manipulates native data, the Data Access Accelerator AP
3232
- performing arithmetic, comparison, and validation of packed decimal data
3333
- converting between decimal data types as well as to and from `BigDecimal` and `BigInteger` types
3434
- marshalling Java binary types to and from byte arrays
35+
- validating the sign and digits of a given external decimal input before operating on the data.
3536

3637
## GPU acceleration
3738

‎docs/introduction.md

+4-3
Original file line numberDiff line numberDiff line change
@@ -57,12 +57,14 @@ The following functions are provided:
5757
- Arithmetic, comparison, shifting, and validation operations for packed decimal data.
5858
- Conversion operations between different binary coded decimal and Java binary types.
5959
- Marshalling operations: marshalling and unmarshalling Java binary types, such as `short`, `int`, `long`, `float`, and `double`, to and from byte arrays.
60+
- External decimals support with all four sign configurations: sign embedded trailing, sign embedded leading, sign separate trailing, and sign separate leading. It also accommodates sign embedded trailing with spaces.
6061

6162
You can gain a number of benefits by using the APIs provided:
6263

6364
- Improved application performance by avoiding object creation and intermediate processing, which can also put pressure on the Java heap.
6465
- Hardware acceleration by automatically exploiting available hardware features on specific platforms.
6566
- Platform independence for applications that are developed to take advantage of Data Access Acceleration.
67+
- Validate the sign and digits of a given external decimal input before operating on the data.
6668

6769
For more information, see the [API documentation](api-overview.md).
6870

@@ -113,8 +115,7 @@ OpenJDK uses the in-built Java cryptographic implementation by default. However,
113115
114116
### Exploiting GPUs
115117
116-
OpenJ9 provides both the [CUDA4J API](api-cuda.md) <!-- Link to API --> and the [GPU API](api-gpu.md), <!-- Link to API -->
117-
which enables you to develop applications that can take advantage of graphics processing unit (GPU) processing for suitable functions, such as sorting arrays. You can also enable the JIT compiler to offload certain processing tasks to a GPU by specifying the [`-Xjit:enableGPU`](xjit.md#enablegpu) option on the command line. When enabled, the JIT compiler determines when to offload tasks based on performance heuristics.
118+
OpenJ9 provides both the [CUDA4J API](api-cuda.md)<!-- Link to API --> and the [GPU API](api-gpu.md), <!-- Link to API -->which enables you to develop applications that can take advantage of graphics processing unit (GPU) processing for suitable functions, such as sorting arrays. You can also enable the JIT compiler to offload certain processing tasks to a GPU by specifying the [`-Xjit:enableGPU`](xjit.md#enablegpu) option on the command line. When enabled, the JIT compiler determines when to offload tasks based on performance heuristics.
118119
119120
GPU processing is supported only on Linux little-endian systems, such as x86-64 and IBM Power LE, and Windows x86-64 systems. For more information about enabling GPU processing, see [Exploiting graphics processing units](https://www.ibm.com/support/knowledgecenter/SSYKE2_8.0.0/com.ibm.java.vm.80.doc/docs/gpu_overview.html).
120121
@@ -140,7 +141,7 @@ If you do not require translations from the English language, the translation fi
140141
## ![Start of content that applies to Java 16 and later](cr/java16plus.png) Using jpackage
141142
**(Linux, macOS, and Windows only)**
142143
143-
You can use the `jpackage` utility to package a Java application into a platform-specific package that includes all of the necessary dependencies. Full details of the tool are available at [JEP 392: Packaging Tool](https://openjdk.org/jeps/392). Instructions for using it and the various options available, are documented in the Oracle Tool Specifications: [The jpackage Command](https://docs.oracle.com/en/java/javase/14/docs/specs/man/jpackage.html).
144+
You can use the `jpackage` utility to package a Java application into a platform-specific package that includes all of the necessary dependencies. Full details of the tool are available at [JEP 392: Packaging Tool](https://openjdk.org/jeps/392). Instructions for using it and the various options available are documented in the Oracle Tool Specifications: [The jpackage Command](https://docs.oracle.com/en/java/javase/14/docs/specs/man/jpackage.html).
144145
145146
## Troubleshooting
146147

0 commit comments

Comments
 (0)
Please sign in to comment.