vm_report

Evaluates any or all volume management policies to generate a report. Because of performance considerations using the rich client application interface, Siemens Digital Industries Software recommends the system administrator execute this utility to create pending migration file sets. Sites can schedule this utility to execute overnight through a Linux cron job or Microsoft Windows at command. This utility can take considerable time to evaluate all migration policies. Syntax vm_report [-u=user-id {-p=password | -pf=password-file} -g=group] [-listvolumes] [-listpolicies] [-migrationreport=migration-policy] [-filepath=filepath] [-migrationreport=ALL {-srcvol=source-volume-name -destvol=destination-volume-name} -filepath=filepath] [-before=before-date] [-after=after-date] [-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. -listvolumes Indicates that the utility is to list all volumes in the database. -listpolicies Indicates that the utility is to list all active policies. -migrationreport Specifies migration policy for which the report need to be reported. To generate a report on all active migration policies, specify -migrationreport=ALL If you specify ALL for the migration policy, you must include either the -srcvol or -destvol arguments. -srcvol Specifies source volume name. -destvol Specifies destination volume name. -before Specifies the beginning date for reporting migration. For example, 23_Mar_2004. -after Specifies the ending date for reporting migration. For example, 23_May_2006. -filepath Specifies the operating system file path to which the report is saved. -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 Due to performance considerations, Siemens Digital Industries Software recommends a system administrator execute this utility instead of using the rich client application interface. Examples Execute the following command to generate report on all policies in the database: Copy vm_report -u=admin-user -p=admin-password -g=dba -migrationreport=ALL -srcvol=volume-one -destvol=volume-two -filepath=c:\temp\report.txt Execute the following command to generate report about a specific policy in the database: Copy vm_report -u=admin-user -p=admin-password -g=dba -migrationreport=policy-name -filepath=c:\temp\report.txt Execute the following command to list of all active policies names defined for a database: Copy vm_report -u=admin-user -p=admin-password -g=dba -listpolicies Related Topics Introduction to administering volumes