Oninit
Talk to an expert →

Informix Error -25571

-25571 Cannot create a user thread.

The database server cannot create or spawn a user thread for a client that is trying to establish a connection.

Probable causes of the error and corrective actions include:

* The database server cannot allocate system resources for the user thread at the moment. The client can retry the connection later. When other clients finish their work, some system resources should become available again. Check to see if the user is the right person to execute the utility or the program. For information about who can use what utilities, refer to the Trusted Facility Manual or your Administrator's Guide.

* A user who is not allowed to use a particular client application to connect to the database server tried to use the utility to connect. Client applications include SQL APIs, DB-Access, and all the database server utilities.

* A request for a Global Language Support (GLS) structure failed. Refer to the corrective actions for errors -23100, -23101, -23102, -23104, -23108, and -23110 for possible solutions.

* A user attempting to connect to the database server does not belong to the database server user group, as defined in $INFORMIXDIR/dbssodir/seccfg on a UNIX system or in the registry on a Windows system. Make sure that the user belongs to a user group that can access the database server. For more information about DBSSO users, see the Trusted Facility Manual.

Oninit® Troubleshooting Guidance

Reasons / Common Causes

-25571 fires when the database server can't create or spawn a user thread for a connecting client — per the official guidance.

  1. The database server currently unable to allocate system resources for the user thread, per the official guidance — the first named case; other clients finishing their work may free resources.
  2. A user not permitted to use the particular client application (SQL APIs, DB-Access, or a database server utility) attempting to connect, per the official guidance — the second named case.
  3. A Global Language Support (GLS) structure request failing, per the official guidance — the third named case; see errors -23100, -23101, -23102, -23104, -23108, -23110 for possible solutions.
  4. The connecting user not belonging to the database server user group (defined in $INFORMIXDIR/dbssodir/seccfg on UNIX, or the registry on Windows), per the official guidance — the fourth named case.
Solutions / Resolution
  1. Retry the connection later, per the official guidance, if resources are temporarily unavailable.
  2. Confirm the user is authorized to use the client application, per the official guidance, consulting the Trusted Facility Manual/Administrator's Guide for utility access rules.
  3. Resolve the underlying GLS failure, per the official guidance, following the corrective actions for errors -23100/-23101/-23102/-23104/-23108/-23110.
  4. Add the user to the database server user group, per the official guidance — see the Trusted Facility Manual for DBSSO user details.
Examples
N/A

No specific triggering statement is documented beyond a failed user-thread creation.

Diagnostic Checks
  1. Check system resource availability, the connecting user's application-access authorization, GLS status, and DBSSO group membership, per the four cases above.
Related Errors / Related Topics

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

The server couldn't create a user thread for a connecting client — check system resources, application authorization, GLS status, and DBSSO group membership.