How to use the licensing Control-M reporting tool

BMC Software requests yearly a licencing report of the usage of Control-M at the customer site, for that they send you a request to generate a report by using a Usage Reporting Tool provided by them and send back the the generated Report.
When I tried to use the tool, I encountered an issue (java), I was using the version 9.0.19.200, therefore if you are facing with the same issue, I will explain you here a workaround.

Usually, the Licensing mode is per Tasks or per Endpoint (number of active components = Agents, remote agents, plugins …), here I will explain only when your licencing mode is per Tasks.

The purpose is to use the Reporting usage tool available either with the installation of the Control-M client Workload automation (WLA) or downloaded from Bmc Support portal, then generates the requested reports to be sent back to BMC Software, but also how to resolve the issue with Java if you are facing with that.

Note: you can also read additional instructions here controlm-utility-instructions
=> Follow the instruction for “Reporting Task Usage”

1. Launch the tool

From the Windows menu

I am using the version 9.0.19.200, if you are run the utility from Windows menu, a cmd window is opened first, the after the java window, but if the cmd windows contains java error messages
=> then don’t go further, there is an issue with the java environment which the tool can’t load. A .jar file is missing.

Solution: Download and install the latest version of the tool

2. Preparation

2.1 Download the tool

2.2 Unzip the package

2.3 Preparation to launch the tool manually

• Open cmd prompt
• ssign the variable JAVA_HOME if not set

Note: You can use the Control-M client Java_home

• set JAVA_HOME=C:Program FilesBMC SoftwareControl-M EMControlM_9_0_19_200JRE

Note:Don’t enclose with “” otherwise it wouldn’t work

• Check your variable if it is well set by running this following command

  C: TEMP> "%JAVA_HOME%/bin/java" -version
  openjdk version "1.8.0_192"
  OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_192-b12)
  OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.192-b12, mixed mode)
  

3 Launch the Reporting tool

• Still in the cmd window where you set the variable %JAVA_HOME%, navigate to the folder where you unzipped the file
• Run the command : usagetool_run.cmd => a Windows form appears, now without the cmd windows containing the Java error as before in the background



• Enter the information regarding the connection to the emuser Control-M database.
  * HOST
  * PORT
  * SERVICE_NAME or dbname

  For oracle, this can be found in the file: $HOME/ctm_em/oracle/network/admin/tnsnames.ora
  For PostgreSQL in the file: $HOME/pgsql/data/pg_service.conf

  You can enter the information per environment and generate a Report, e.g. Dev or all environments at once (Dev, Uat, Prod …) in the Control-M environments form
  

• Then click on Next, it will try to connect to the EM database
  1) If it fails, then you get this error message, you have to review the exact syntax defined in the database config file, usually the reason is eacuse the domain name is missing with the host name
  

  2) If the connection is successfull you get this result
  

  3) Generate the Reports
  This is the last Step, which is the to generate the reports.
  We get this form below showing that some reports were generated, and they are located under the sub-folder reports
  

  4 List of Reports and other files generated

  
  

  4.1 Reports

  
  The most interesting files are:

• ALL_per_task_.csv: it shows the count per



• ALL_per_task_total.csv: it shows the total count for all environments
• ALL_per_taskmost_active.pdf: it shows also the total count for all environments but in a dashboard



4.2 Configuration file


If you want to generate reports another day, you don’t have to enter again the connexion parameters, they are saved in a configuration file under the subfolder .dataenv.txt.

The content of the env.txt file


5 Conclusions


1) We managed to resolve the issue with java, then we are now able to generate report

2) you can send back to BMC Software the requested report, only the reports.zip file is enough

Post Views: 2,235