Informix Error -761

-761 INFORMIXSERVER does not match either DBSERVERNAME or DBSERVERALIASES.

Your INFORMIXSERVER environment variable does not match the DBSERVERNAME or any of the DBSERVERALIASES settings in the ONCONFIG configuration file of the server to which you are trying to connect. Check your environment variables and the ONCONFIG configuration file. Check that INFORMIXSERVER matches one of the settings in the ONCONFIG file.

Oninit® Troubleshooting Guidance

Reasons / Common Causes

-761 fires when a client's INFORMIXSERVER environment variable doesn't match either the target server's DBSERVERNAME or any of its DBSERVERALIASES, as configured in that server's $ONCONFIG — per the official guidance, these must line up for the connection to succeed.

INFORMIXSERVER set to a name that was renamed or never matched the target server's actual DBSERVERNAME/DBSERVERALIASES, per the official guidance — the direct, common cause.
A client configured against a different environment (a different host, a different instance) than the one it's actually connecting to, with the server-name mismatch surfacing this way.
A server's DBSERVERNAME/DBSERVERALIASES changed in $ONCONFIG without updating every client's INFORMIXSERVER to match.

Solutions / Resolution

Check the client's INFORMIXSERVER environment variable, per the official guidance:
```
echo "$INFORMIXSERVER"
```
Check the target server's DBSERVERNAME and DBSERVERALIASES in $ONCONFIG, per the official guidance:
```
grep -E '^DBSERVERNAME|^DBSERVERALIASES' "$ONCONFIG"
```
Set INFORMIXSERVER to match one of those values exactly, correcting whichever side is wrong.

Examples

Checking both sides

$ echo "$INFORMIXSERVER"
myserver_old

$ grep -E '^DBSERVERNAME|^DBSERVERALIASES' "$ONCONFIG"
DBSERVERNAME myserver_new
DBSERVERALIASES myserver_alias1,myserver_alias2

myserver_old matches none of these — INFORMIXSERVER needs to be set to myserver_new, myserver_alias1, or myserver_alias2.

Diagnostic Checks

Compare $INFORMIXSERVER against the target server's DBSERVERNAME/DBSERVERALIASES directly, character for character.

Related Errors / Related Topics

No closely related error codes are cross-referenced for -761 in this set yet.

Compare the client's INFORMIXSERVER directly against the target server's DBSERVERNAME/DBSERVERALIASES in $ONCONFIG — correct whichever side is wrong.