Administer > System configuration parameters > Servlet parameters > Parameter: appthreadspersession

Parameter: appthreadspersession

Startup parameters change the behavior of the Service Manager server. You can always set a startup parameter from the server's operating system command prompt.

Parameter

appthreadspersession

Description

This parameter gives a site some control over the amount of server memory that a user can consume by limiting the number of application tabs that can be opened through the client. If a user performs an action that will result in opening a new application tab that exceeds the limit (for example, the maximum number of tabs is set at three and the user performs an action that would open a fourth tab), a message is displayed letting the user know that the maximum number of application tabs has been exceeded and the action is denied.

This parameter can also be used during load tests to prevent a common problem where a script that is recorded never closes the application tab, and then results in out-of-memory errors.

Note A user cannot open the last allowed tab by executing a command via the command line. For example, the appthreadspersession parameter is set to 5, a user has four open tabs (including the first tab). The user tries to open the fifth tab by executing a command (for example, the db command) via the command line. In this scenario, the fifth tab cannot be opened. However, the user can open the fifth tab from the System Navigator.

This is a known limitation caused by the mechanism that calculates the number of open tabs.

Valid if set from

Server's operating system command prompt

Initialization file (sm.ini)

Requires restart of the Service Manager server?

No

Default value

0 (Unlimited number of application tabs.)

Note If you are running in scripting mode, the default value is 5.

Possible values

No maximum is enforced.

Example usage

Command line: sm -appthreadspersession:3

Initialization file: appthreadspersession:3

Related topics

System parameters
Enter a parameter in the sm.ini file