Skip to content

Document new DAA api added in 0.46.0 #1506

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

Sreekala-Gopakumar
Copy link
Contributor

#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 [email protected]

@Sreekala-Gopakumar
Copy link
Contributor Author

Jenkins doc stage

@Sreekala-Gopakumar
Copy link
Contributor Author

@VermaSh @pshipton - I have updated the docs. Please check and let me know if any other changes are required.

https://eclipse-openj9.github.io/openj9-docs-staging/1506/introduction/
https://eclipse-openj9.github.io/openj9-docs-staging/1506/api-overview/

@VermaSh
Copy link

VermaSh commented Apr 23, 2025

LGTM. Thank you for updating the docs @Sreekala-Gopakumar!

@pshipton
Copy link
Member

@VermaSh I'm confused. You added a couple of comments for changes, which didn't yet result in any updates, but now say "LGTM". Are there still changes expected?

@Sreekala-Gopakumar
Copy link
Contributor Author

@VermaSh I'm confused. You added a couple of comments for changes, which didn't yet result in any updates, but now say "LGTM". Are there still changes expected?

Please refer to #1506 (comment). The change that Shubham (@VermaSh) had asked for was already mentioned in the existing content. Therefore, the suggested changes are no longer required. @VermaSh - I hope my understanding is correct.

@Sreekala-Gopakumar
Copy link
Contributor Author

@pshipton - If any other changes are required, please let me know. Thanks!

@VermaSh
Copy link

VermaSh commented Apr 23, 2025

Apologies for the misunderstanding, but the requested modifications are no longer necessary. The documentation already emphasizes packed decimal validation, so there's no need to make any changes to the PR.

@pshipton
Copy link
Member

I expected to see the 0.46 What's new updated to mention the new API.

@pshipton
Copy link
Member

@VermaSh maybe you can resolve the conversations which are no longer relevant?

@Sreekala-Gopakumar
Copy link
Contributor Author

Sreekala-Gopakumar commented Apr 23, 2025

I expected to see the 0.46 What's new updated to mention the new API.

I will do that. I hope the issue that you had mentioned in the following instance will not be applicable in this case. #1489 (comment)

Specifically "...we should backdate to 0.49, but because of the TOC changes it would be difficult to refresh 0.49 now."

@VermaSh
Copy link

VermaSh commented Apr 23, 2025

@pshipton Unfortunately, I don't have the option to mark the conversation as relevant but I have commented "resolved" on the conversations.

@Sreekala-Gopakumar
Copy link
Contributor Author

Jenkins doc stage

@Sreekala-Gopakumar
Copy link
Contributor Author

@pshipton - Please check and confirm that the changes are ok. Thanks!

@pshipton
Copy link
Member

@VermaSh does the What's new update look good?

@pshipton
Copy link
Member

@VermaSh in OpenJ9 pls add a javadoc class description to ExternalDecimal.

See
https://eclipse-openj9.github.io/openj9-docs-staging/1506/api/jdk11/openj9.dataaccess/com/ibm/dataaccess/package-summary.html

@@ -35,6 +35,7 @@ The following new features and notable changes since version 0.45.0 are included
- [New `-XX:[+|-]ShareOrphans` option added](#new-xx-shareorphans-option-added)
- [New `-XX:[+|-]JITServerAOTCacheIgnoreLocalSCC` option added](#new-xx-jitserveraotcacheignorelocalscc-option-added)
- [New `-XdynamicHeapAdjustment` option added](#new-xdynamicheapadjustment-option-added)
- [A new Data Access Accelerator library class and API `com/ibm/dataaccess/ExternalDecimal.checkExternalDecimal` added](#a-new-data-access-accelerator-library-class-and-api-comibmdataaccessexternaldecimalcheckexternaldecimal-added)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think just A new Data Access Accelerator (DAA) library API would be better

@@ -98,6 +99,12 @@ By default, if a checkpoint is taken in a container with no memory limits and th

You can now create a single image file and restore it on various nodes with different memory limits. The new option [`-XdynamicHeapAdjustment`](xdynamicheapadjustment.md) automatically adjusts the maximum Java heap size ([`-Xmx`](xms.md)) and minimum Java heap size ([`-Xms`](xms.md)) values such that they are within the physical memory limitations on the system. ![End of content that applies only to Java 11 and later](cr/java_close.png)

### A new Data Access Accelerator library class and API `com/ibm/dataaccess/ExternalDecimal.checkExternalDecimal` added

A new Data Access Accelerator (DAA) library class and API `com/ibm/dataaccess/ExternalDecimal.checkExternalDecimal` is added to verify the validity of the sign and digits of a given external decimal input before operating on the data.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think just A new Data Access Accelerator (DAA) library API would be better

eclipse-openj9#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. Added the content in the What's new topic of version 0.46.0 release. Incorporated the feedback.

Closes eclipse-openj9#1504
Signed-off-by: Sreekala Gopakumar [email protected]
@Sreekala-Gopakumar
Copy link
Contributor Author

Jenkins doc stage

@Sreekala-Gopakumar
Copy link
Contributor Author

Currently a major outage has impacted a large number of eclipse core services, including the ECA validation service because of which the eclipsefdn/eca check is failing.

https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/issues/5921

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Document new DAA api added in 0.46.0
3 participants