File recall quotas

You can define file recall quotas to limit the number of possible file recalls during a time span. You can define a system-wide default quota and define quotas for particular Windows user and group accounts.

Several quotas can be defined for one user account: The quota that applies to a user account is the effective quota.

User account quotas define the allowed number of file recalls in a time span for an individual user account. If a user account quota is defined, only this quota applies to the user account. Default and group account quotas are overridden by a user account quota.

Group account quotas define the allowed number of file recalls in a time span for each user account in a group. If a user account is a member of two or more groups and has no user account quota, the group with the least restrictive quota applies to the user account.

The default quota applies to user accounts for which no group account quota or user account quota is defined.

You can define quotas for global groups and for universal groups. You cannot define quotas for local domain groups. Local-domain group quotas that were defined in previous versions of HSM for Windows are ignored.

Quotas can be updated at any time with the HSM GUI. The update is effective immediately without restarting the HSM for Windows client. The update is displayed in the Live Quotas tab of the Recall Quotas window after the user recalls a file.

The HSM for Windows client compares the file recalls quota with the actual file recalls during a time span. The time span is a moving window. For example, assume that you define a quota of five files per 60 seconds. When a user tries to recall a file, the HSM for Windows client compares the file recalls quota with the number of file recalls in the previous 60 seconds. If the user recalled five files in the previous 60 seconds, the user cannot recall another file until more time elapses. When less than five files were recalled in the previous 60 seconds, the user can recall another file.

When a user reaches a file recall quota, a subsequent file recall request is rejected. The HSM for Windows client returns the code STATUS_FILE_IS_OFFLINE. The behavior of the calling application depends on the response of the calling application to the return code.

Quotas affect only the recall of migrated files from users that access stub files. Quotas do not have any influence on retrieving files with the HSM for Windows client GUI.

If a user reaches the quota, you can reset the file recall counter. You can reset the file recall counter with the dsmquota.exe command or Live Quotas tab of the Recall Quotas window of the HSM for Windows client GUI.

The quota configuration is stored in the HSM for Windows client installation directory in \config\quota.cfg. After you change quotas, a backup of quota.cfg is saved in the backup directory \config\backup\quota.cfg.