resetpool (Reset a SAM pool)

Terminates all sessions and releases all user IDs in the SAM pool.

You may want to force your IDs to start new sessions, such as when you want all IDs to show the latest available table and permission updates, or if you are receiving the error System busy, please try again. resetpool interrupts and terminates any active processing in the pool.

resetpool can be issued by the SAM pool group owner or the company administrator of the SAM pool group owner. Issuing resetpool does not log in the requesting ID.

Query string

The query string in the HTTP header must contain the following parameters:

Specify the name of the API transaction.
Specify the version of the API that should handle the requested transaction.

For the most up-to-date version, use apiversion=3.

Specify a valid 1010data user name.
Specify a valid unencrypted 1010data password for the 1010data user name provided to the uid parameter.

The response from the login transaction will provide an encrypted password, which must be supplied as the value for the pswd attribute for all the other transactions.

The group identifier for the SAM pool. In the 1010data Insights Platform, a SAM pool is a group containing some number of user IDs. A valid gid follows the same rules as a valid uid.
kill (optional)
Valid values for kill are as follows:
Terminate the existing session and start a new one.
Do not terminate the existing session.

If no session exists, a new one will be created. If a session does exist, an error is returned.

Note: If kill=no and a session is active, the system returns an error.
Log in and possess the existing session.
Authenticate with the system but do not kill, possess, or start any session.

The default is yes.

XML input to server

No XML input is required. All data for the transaction is specified in the connection string.

XML response from server

A successful result contains the following elements:

The return code generated by the transaction. For a list of return codes, see Return codes.
The message returned by the system. Specific messages correspond to specific return codes.

Query string example$UID&pswd=$PSWD&gid=$GID

resetpool example

In the following example, resetpool terminates all active processing in the clientx SAM pool.