Reporting Jobs and Objects Created by the Adapter Setup and Add Domain Category Wizards

About Reporting Jobs Created by the Adapter Setup Wizard and Add Domain Category Wizards

The Adapter Setup and Add Domain Category wizards programmatically create reporting jobs for many of the domain categories and time periods that you select. These reporting jobs are named using the convention <domain subcategory> <time period> (such as Daily, Weekly, and Monthly) Reporting, and they are stored in the same domain category folder as the aggregation and information map jobs.
Reporting jobs include Performance Report transformations that use report definitions and information maps to generate reports using data for IT resources. When a reporting job executes, it creates the necessary report packages and reports based on the information maps that are in the same domain category folder. The reports are then saved as tabular or graphic files (such as HTML or PNG files) in the Repository folder path of the SAS Content Server that you selected in the Adapter Setup or Add Domain Category wizards. For more information about the reporting jobs that the wizards create for specific domain categories and time periods, see How to Determine Whether the Adapter Setup Wizard or Add Domain Category Wizard Will Create Reporting Jobs for Your Selections.
Note: The metadata server and SAS Content Server must be running when reporting jobs execute or the jobs cannot generate output.
After a reporting job is deployed, scheduled, and executed, the resulting report output is available for viewing with ITRM Report Center. Among other features, this application enables you to access, filter, and manage your report content from a web browser. For more information, see Working with ITRM Report Center.

How to Determine Whether the Adapter Setup Wizard or Add Domain Category Wizard Will Create Reporting Jobs for Your Selections

SAS IT Resource Management supplies predefined report definitions for several domain categories and time periods. These report definitions include information such as the names of the variables, the report style, and other attributes that are used to build tabular and graphical reports from your IT resource data. The Adapter Setup and Add Domain Category wizards use these prepackaged report definitions in the reporting jobs that they create for the domain categories and time periods that you select.
Note: The prepackaged report definitions that the Adapter Setup and Add Domain Category wizard jobs use were created by the supplied SAS Enterprise Guide projects. You might want to modify a report that the Adapter Setup or Add Domain Category wizard creates. Similarly, you might want to create your own report that is similar to one that the wizards create. If so, then you can use the corresponding supplied SAS Enterprise Guide project as a template. To do so, copy the supplied project and make the necessary modifications to create a modified report definition. For more information about how to complete this and other related tasks, see How to Create or Modify Your Own Batch Reports and Managing SAS Enterprise Guide Projects for SAS IT Resource Management.
If you select a domain category and time period for which SAS IT Resource Management supplies report definitions, then the Adapter Setup or Add Domain Category wizard creates the appropriate reporting jobs. To determine whether the wizards are going to create reporting jobs for the domain category and time periods that you selected, view the Summary page of the wizard before you select Finish.
The Summary page lists the report jobs that the Adapter Setup and Add Domain Category wizard will create. It also shows the report definitions that the report jobs use, as shown in the following image:
Example of a Summary Page Listing Report Jobs
List of Report Jobs in the Summary Page of the Adapter Setup Wizard
Note: The Summary page also includes a note if no reporting jobs are to be created.
You can also determine whether the Adapter Setup or Add Domain Category wizard is going to create reporting jobs based on your selections. To do so, view the list of supplied report definitions for a given domain category and time period. If SAS IT Resource Management supplies report definitions for a given adapter, domain category, and time period, then the wizard creates a reporting job for those selections based on the configuration level that you selected. If there are no supplied report definitions for a given adapter, domain category, and time period, then the wizard does not create reporting jobs for those selections.
To view the supplied report definitions, perform the following steps:
  1. In the Folders tree, select Shared Datathen selectSAS IT Resource Managementthen select3.5 IT Report Definitions.
  2. Select an <adapter> folder.
  3. Select a <domain category> folder.
  4. Select Supplied.
  5. Select a <time period> folder.
Supplied Report Definitions for DT Perf Sentry, Server Disk, Day Data
Supplied Report Definitions for DT Perf Sentry, Server Disk, Day Data
You can also create your own report definitions, Performance Report transformations, and reporting jobs. You can add reporting jobs for the domain categories and time periods for which the wizards do not create reporting jobs. Report definitions that you create should be stored in the User Defined folder within the domain category folder. For more information about how to create your own report definitions, see About the ITRM Report Definition Task.
If you decide to create your own reporting objects and jobs, maintain consistency and efficiency by using the same naming conventions and folder structure that SAS IT Resource Management uses for supplied reports. For more information, see Link to "How to Create and Modify Your Own Batch Reports" and Naming Standards and Location of Objects.

Deploy and Run Jobs That the Adapter Setup or Add Domain Category Wizard Creates

The Adapter Setup and the Add Domain Category wizards create jobs. You must run those jobs as needed. These jobs depend on one another to process the raw data for reporting.
The following list shows the types of jobs that the wizards create and the dependencies of each. Each job type in the list is dependent on the job type that precedes it.
  1. staging job
  2. aggregation job
  3. information map job
  4. reporting job
For some domain categories, exception jobs are created. These jobs run the Exception transformation. The source table for these jobs must be created in order for these jobs to run. For example, if the source table is created in a staging job, then that staging job must run successfully before the exception job is run.
For more information, see Deploying and Running Report Jobs.
Note: Based on your specifications, the Adapter Setup and Add Domain Category wizards might not create all four types of jobs (staging, aggregation, information map, and reporting) when they execute. For example, you might specify in a wizard to create only a staging job. Or, you might select a supported adapter for which the wizards do not create reporting jobs.