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=VALUE

The 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