purge_invalid_subscriptions

Deletes invalid and expired subscriptions. For security reasons, only a Teamcenter administrator can run this program. Non-administrator users can view the numbers of invalid and expired subscriptions without deleting them. A subscription references a target object as an external reference. If the target gets deleted, the subscription becomes invalid. The user can interactively delete invalid subscriptions in the rich client interface. Finding a few invalid subscriptions among a large number of subscriptions in the table sometimes is not easy. In addition, subscriptions expire after their expiration dates. Syntax purge_invalid_subscriptions [-u=user-id {-p=password | -pf=password-file} -g=group] [-report] [-e] [-h] Arguments -u Specifies the user ID. This must be 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. This argument is mutually exclusive with the -pf argument. -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. -report Reports the numbers of invalid and expired subscriptions without deleting them. -e Deletes expired subscriptions in addition to deleting invalid subscriptions. -h Displays help for this utility. Environment As specified in Setting up a Teamcenter command-line environment. Files As specified in Log files produced by Teamcenter. Restrictions None. Examples To delete invalid subscriptions, enter the following command on a single line: Copy purge_invalid_subscriptions -u=Tc-admin-user -p=password -g=group To delete invalid subscriptions and expired subscriptions, enter the following command on a single line: Copy purge_invalid_subscriptions -u=Tc-admin-user -p=password -g=group -e To report the numbers of invalid and expired subscriptions without deleting them, enter the following command on a single line: Copy purge_invalid_subscriptions -u=Tc-admin-user -p=password -g=group -report Related Topics Subscription Management