Oninit
Talk to an expert →

Informix Error -25559: DBPATH server server-name is not listed as a dbserver name in sqlhosts.

Cause and resolution

DBPATH server server-name is not listed as a dbserver name in sqlhosts.

The database server that your DBPATH environment variable setting specifies is not listed in the $INFORMIXDIR/etc/sqlhosts file. Check that every database server that is mentioned in DBPATH corresponds to an entry in the sqlhosts file.

Oninit® Troubleshooting Guidance

Reasons / Common Causes

-25559 fires when a server named in the DBPATH environment variable isn't listed in sqlhosts — per the official guidance.

  1. A DBPATH-referenced server missing from $INFORMIXDIR/etc/sqlhosts, per the official guidance — the direct, only cause.
Solutions / Resolution
  1. Check that every server named in DBPATH has a corresponding sqlhosts entry, per the official guidance.
Examples
N/A

No specific triggering statement is documented beyond a missing sqlhosts entry for a DBPATH server.

Diagnostic Checks
  1. Check every server listed in DBPATH against sqlhosts, and add any missing entries.
Related Errors / Related Topics
  • -25555 — "Server server-name is not listed as a dbserver name in sqlhosts." The general form of this missing-entry error, not specific to DBPATH.
  • -25558 — "The NFS/RFS host host-name is not listed as a dbserver name in sqlhosts." A related missing-entry error, specific to an NFS/RFS host.

A DBPATH-referenced server wasn't listed in sqlhosts — add the missing entry.