PROBLEM: Receiving Error "685: RSLVSP(_Usrq) failed to get user queue pointer" when attempting to access DataGate/400.

The information in this article applies to:

DataGate/400, All Versions connecting with TCP/IP
Acceler8DB
AS/400

SYMPTOMS:

These are the symptoms when a user receives the following error:

On the AS/400, the DataGate/400 License Manager and DataGate/400 End User jobs start and end in less than 1 second.

Figure 1 shows what the Spool file for DG8SVCPRF when this error occurs.

Figure 2

CAUSE:

The QALWUSRDMN System Value is not set to *ALL (See Figure 1). If it is not set to *ALL, the DataGate/400 library or libraries for multi-DataGate/400 installs is not listed in the Library for QALWUSRDMN System Value..

Figure 2

RESOLUTION:

NOTE: Please coordinate with your System Administrator or IBM while working on the AS/400.

After you have entered in the DataGate/400 Library in the QALWUSRDMN System Value screen (See Figure 3), you can have your end users connect to DataGate/400. No need to stop/start DataGate/400.

Figure 3

MORE INFORMATION:

DataGate/400 calls the Create User Queue (QUSCRTUQ) API and specifys Optional Parameter Group 2. Here is an excerpt from IBM's documentation on these parameters:

"...

Optional Parameter Group 2

Domain

INPUT; CHAR(10)

The domain into which the user queue should be created. If this parameter is not specified, the value of *DEFAULT will be assumed by the API. Valid values for this parameter are:

*DEFAULT Allows the system to decide into which domain the object should be created.

*SYSTEM Creates the user queue object into the system domain. The API can always create a user queue into the system domain regardless of the security level you are running at. However, system-domain user queues can only be used at security level 30 and below because there are no APIs to access user queues.

*USER Attempts to create the user queue object into the user domain. This is not always possible. If the library you are creating the user queue into does not appear in the QALWUSRDMN system value, the API cannot create the user queue into the user domain. An error message will be returned.

The API uses the following criteria to determine into which domain to create the user queue. The destination library is the library you specified in the qualified user queue name parameter. The optional domain parameter is the information specified in the domain parameter.

..."

Other Articles you may want to refer to:

Keywords: deployment, client, connection, service, error 685, User Domain, protection violation, Object Domain, License Manager