Troubleshooting
Problem
This document equates some of the return codes from the IBM i Access data queue APIs to operating system error messages.
Resolving The Problem
Question
How do operating system error messages map to Optimized Data Queue API return codes?
Answer
Following is a list of operating system messages and the client return codes that they map to:
All other operating system messages are returned as a CWBDQ_HOST_ERROR. In addition, all the operating system message text can be retrieved using the service handle from the data queue calls.
How do operating system error messages map to Optimized Data Queue API return codes?
Answer
Following is a list of operating system messages and the client return codes that they map to:
| CPF9870 Object &2 type *&5 already exists in library &3. | CWBDQ_QUEUE_EXISTS |
| CPF9810 Library &1 not found. | CWBDQ_LIBRARY_NOT_FOUND |
| CPF9801 Object &2 in library &3 not found. | CWBDQ_QUEUE_NOT_FOUND |
| CPD0078 Value &3 for parameter &2 not a valid name. | CWBDQ_QUEUE_SYNTAX |
| CPD0079 Value &3 for &2 not a name or generic name. | CWBDQ_LIBRARY_SYNTAX |
| CPF8147 &8 damage on data queue &4 in &9. VLOG-&7. | CWBDQ_DAMAGED_QUEUE |
| CPF2498 Invalid length. MAXLEN for data queue &1 in &2 is &3. | CWBDQ_INVALID_MESSAGE_LENGTH |
| CPF9805 Object &2 in library &3 destroyed. | CWBDQ_QUEUE_DESTROYED |
| CPF9802, CPF9820 Not Authorized | CWBDQ_NO_AUTHORITY |
All other operating system messages are returned as a CWBDQ_HOST_ERROR. In addition, all the operating system message text can be retrieved using the service handle from the data queue calls.
[{"Product":{"code":"SWG60","label":"IBM i"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Component":"Data Access","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"Version Independent","Edition":"","Line of Business":{"code":"LOB68","label":"Power HW"}}]
Historical Number
3752322
Was this topic helpful?
Document Information
Modified date:
02 July 2025
UID
nas8N1015581