Integration & production support
Trace a Failed OFS Request Through TAFJ and JBoss Logs
Follow one safe correlation value from the caller to T24 and back. Prove the last successful stage before interpreting the final error or retrying an uncertain request.
Browse more Integration articles →
Start with the correct OFS request structure
A common OFS transaction request is organised into comma-separated sections for the application and operation, processing options, user or sign-on context, the record or transaction identifier, and the data fields. The exact option and user syntax varies by source and configuration.
A synthetic shape is:
APPLICATION,VERSION/I/PROCESS,USER/REDACTED/COMPANY,RECORD.ID,FIELD:1=VALUEThe fourth comma-separated section is the record or transaction identifier. Do not replace it with a supposed universal SOURCE segment. OFS source, company, channel, and user context are resolved from the configured source and sign-on or middleware context, depending on the implementation.
The OFS Message Parser can decompose a synthetic or redacted request before you begin the log trace.
1. Establish a safe correlation value
Use a synthetic test reference, a redacted internal transaction identifier, or a narrow timestamp window. Do not search for or publish passwords, full customer payloads, account numbers, or sign-on strings. Record the timezone and clock source for every component.
2. Prove whether the request reached the entry point
Check the relevant HTTP listener, queue, gateway, integration service, or application access evidence. A client timeout alone does not prove that the request failed to arrive. Capture the receiving timestamp, source endpoint, correlation value, and transport result.
3. Trace source, user, and authentication handling
Confirm which configured OFS source and user context were evaluated. Separate transport authentication from T24 user authority, company context, source permissions, and version access. A security response may be produced before application validation begins.
4. Validate message structure
Check the application/version and operation, processing options, user context, record ID, and field/value sections. Malformed commas, missing record IDs, invalid multivalue syntax, or misplaced sign-on content should be diagnosed as structure problems before business rules are investigated.
5. Find the first application or posting failure
Once parsing and authority checks succeed, correlate the request with the application, validation, and posting evidence. Capture the first failure in time order, not only the final wrapper or retry message. Check whether a record or accounting entry was created before treating the outcome as safe to retry.
6. Trace the response path
If T24 processing is visible but the caller received no usable response, inspect the return path through the integration component, queue or HTTP gateway, and client. Compare the raw response type and timestamp before middleware transformation. A timeout can mean the response was lost after the transaction completed.
Log sources are configuration-dependent
TAFJ, JBoss or WildFly, integration services, web gateways, and messaging components can write to different directories and file names. Treat familiar names such as server logs as examples only. Confirm the active logging configuration, server instance, profile, rotation policy, and deployment path in the target environment.
See TAFJ log file locations for evidence-collection principles without assuming one universal directory layout.
Evidence to capture before escalation
- Safe correlation value and timestamp range with timezone
- Last proven successful stage and first failed or uncertain stage
- Short redacted request and response fragments
- Configured source, user context, application, version, and operation
- First error plus surrounding application and transport events
- Evidence of any created record, posting, retry, or duplicate risk
- Recent certificate, routing, source, deployment, or configuration changes
Use the incident escalation checklist to package the evidence clearly.
Related reading
What Is OFS in T24? Open Financial Services Explained
OFS is how the outside world talks to T24. A plain-English introduction to the message structure, request types, OFS.SOURCE configuration, security, and what breaks when integrations go wrong.
TAFJ operationsTAFJ Log Files: Where to Look When Something Goes Wrong
TAFJ distributes its logs across six different locations maintained by different parts of the stack. Where each one lives, what it covers, and the order to check them in — before an incident makes the question urgent.
Integration architectureFile Interfaces That Still Run Banks: The Unsung Heroes of T24 Integration
Why flat files, CSV exports, and batch file transfers remain the backbone of T24 integration — and why they are not going anywhere.
