Skip to main content
Community Hub

Connection errors

TL;DR

Troubleshoot IBM Db2 for z/OS connection errors, including Db2 Connect license activation failures (ERRORCODE=-4230).

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

Use this guide to resolve errors that appear when Atlan connects to your Db2 for z/OS subsystem.

Db2 Connect license invalid or not activated​

Error

The IBM Data Server for JDBC and SQLJ license was invalid or was not activated for the DB2 for z/OS subsystem. ERRORCODE=-4230, SQLSTATE=42968

Cause​

Atlan connects with the IBM Db2 12.1 JDBC driver, which requires a Db2 Connect 12.1 license activated for your subsystem. The subsystem has no activated Db2 Connect license, or it was activated with an earlier kit, such as 11.5. This error appears only after the network connection succeeds, so it often surfaces right after you resolve firewall or DDF port issues.

Solution​

  1. Download the Db2 Connect 12.1 license activation kit from IBM Passport Advantage.
  2. Run the activation program from the kit against your subsystem. For Db2 Connect Unlimited Edition for System z, use the db2connectactivate utility.
  3. Rerun Test Authentication in Atlan.

See also​

Set up IBM Db2 for z/OS: Review the Db2 Connect license and SSL prerequisites

Need help​

If you need assistance after trying these steps, contact Atlan support.