Pool management commands
The following commands help you manage your SAM pool. All of these commands can be issued by the SAM pool group owner or the admin of the owner's company.
flushpool
- You may want to periodically request your IDs to start new sessions due to
memory overconsumption or to request IDs to update its view of the database if a
table or set of tables have been updated.
The following request will terminate all sessions once they have been released back into the pool. It will not terminate any allocated or marked as busy sessions.
Request: https://www2.1010data.com/cgi-bin/gw?apiversion=3&api=flushpool &uid=clientx_admin&pswd=*********&gid=clientx
resetpool
- 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 receiving
errors like System busy, please try again, even
though IDs are not in use by the client application. A system busy error can
occur if the client application ends unexpectedly before sending a
reluid
command. In this event, submit aresetpool
command. This will interrupt and terminate any active processing in the pool.Request: https://www2.1010data.com/cgi-bin/gw?apiversion=3&api=resetpool &uid=clientx_admin&pswd=*********&gid=clientx
samstatus
samstatus
checks the status of IDs in a pool: whether they are logged in, marked as free (available for a new process), busy (allocated to a process), or marked (instructed to logout upon the next time the ID is released and free). This helps you assess the health and utilization of a pool, and aid in determining whether issuingresetpool
would help to restore normal usage.Request: https://www2.1010data.com/cgi-bin/gw?apiversion=3&api=samstatus &uid=clientx_admin&pswd=*****&gid=clientx
Note:samstatus
is a newer feature and may not yet be available for all sessions.