hsm_capacity_alert

Evaluates if the Teamcenter volume tiers filled capacity exceeds the specified alert capacity levels. When the filled capacity exceeds the alert capacity level, an e-mail is sent to the system administrator. The capacity levels are measured in percentage of total capacity. Sites can schedule this utility to execute overnight using a Linux cron job or the Microsoft Windows at command. This utility can require considerable time to evaluate the capacity levels on different tiers. Syntax hsm_capacity_alert [-u=user-id {-p=password | -pf=password-file} -g=group] -alertcapacity=percentage -tier=tier-level [-v] [-h] Arguments -u Specifies the user ID. This is a user with Teamcenter administration privileges. Note If Security Services single sign-on (SSO) is enabled for your server, the -u and -p arguments are authenticated externally through SSO rather than being authenticated against the Teamcenter database. If you do not supply these arguments, the utility attempts to join an existing SSO session. If no session is found, you are prompted to enter a user ID and password. -p Specifies the password. -pf Specifies the password file. For more information about managing password files, see Manage password files. This argument is mutually exclusive with the -p argument. -g Specifies the group associated with the user. If used without a value, the user's default group is assumed. -alertcapacity Specifies alert capacity as a percentage of total capacity. You can include the percent symbol (%) in this argument. -tier Specifies volume tier. Valid values are 1, primary, and 2 secondary. -v Verbose mode. Provides information about results and progress. -h Displays help for this utility. Environment The generic command window set with all Teamcenter-related environments. As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions This utility requires that the HSM_primary_tier_hosts and HSM_secondary_tier_capacity preferences contain estimated total capacity values. These preferences are set using preferences_manager utility. Return Values Return value upon success 0 Return value upon failure 1 Examples To determine if the primary tier capacity exceeds 80% of total capacity, enter the following command: Copy hsm_capacity_alert -u=admin-user -p=admin-password -g=dba -tier=1 -alertcapacity=80% When the filled capacity exceeds 80 percent of total capacity level, an e-mail is sent to the system administrator. Related Topics Introduction to administering volumes