Viewpoints

A Viewpoint is a filtered view of jobs and folders in your active environment that enables you to monitor the real-time execution status of your workflows across multiple Servers and Agents. You can create simple or sophisticated Viewpoints based on the hierarchies and filters that you define, as described below:

• Hierarchies: Determine the organizational appearance of a Viewpoint.

• Filters: Determine which attributes appear in your Viewpoint and operate on similarities, equalities, and Boolean logic.

Viewpoints are accessible only to the user who creates them—they cannot be shared.

In SLA Management, estimated job execution times appear in Viewpoints, as described in Service Management.

Creating a Viewpoint

This procedure describes how to create a private Viewpoint, which enables you to monitor the structure, scheduling, and real time execution status of workflows on one or more Servers.

Begin

1. From the Viewpoints toolbar, click Add Viewpoint.

   The Viewpoint creation pane appears.

2. Do the following to define the hierarchical order of the Viewpoint:

   1. Click Grouping.

      The Grouping section expands and the current hierarchy appears. By default, the hierarchy is set to Server > Application > Sub-application.

   2. Do one or more of the following to add or delete grouping attributes from the hierarchy:

      • Add: Click Add Level and selectSelect an attribute from the drop-down list.

        The grouping attribute appears at the lowest level of the hierarchy.

      • Delete: Mouse over a grouping attribute and click ✕.
        The attribute disappears from the hierarchy.

   3. To add to the current hierarchy, click Add Level and, from the Select drop-down, select an attribute.

3. Do the following to define Viewpoint filters:

   1. Click Filter.

      The Filter section appears.

   2. Complete the filter fields as required, as described in Viewpoint Fields.

      You can use wildcards and define more than one entry in many of the fields when a named attribute matches an existing attribute in your environment. For more information, see Pattern-Matching Strings.

4. Click Open.

   The Viewpoint is created.

5. From the Viewpoints toolbar Save.

   The Save Viewpoint dialog box appears.

6. In the Save Viewpoint dialog box, type a name and description of the Viewpoint and click Save.

   The Viewpoint is saved to the Viewpoints pane.

Viewpoint Fields

The following table describes the Viewpoint fields that you can complete when you create or edit a Viewpoint.

Field	Description
Folder Name	Defines the names of the folders A container of jobs and sub-folders that passes its definitions to the included jobs and sub-folders. that are included in the Viewpoint.
Application	Defines the names of the Application A job attribute that provides a logical name for sorting groups of jobs, which enables you to search for and update jobs. names that are included in the Viewpoint.
Sub-application	Defines the names of the Sub-application A job attribute that provides a logical name for sorting groups of jobs in an Application, which enables you to search and update jobs. names that are included in the Viewpoint.
Server	Defines the names of the Server names that are included in the Viewpoint.
Job Name	Defines the job name that is included in the Viewpoint.
Description	Defines the job description that is included in the Viewpoint.
Job Type	Defines the job types The type of the job, such as an OS Job that executes at the operating system level or integrations that run on third-party applications, such as AWS, Azure, and Control-M for Databases., such as OS jobs or SAP jobs, that included in the Viewpoint.
Run As	Defines the name of the Run As User An OS account name that is used to execute jobs on the host. that is included in the Viewpoint.
File Name	Indicates the filename of the script
File Path	Defines the location of the file, which contains the script, that is included in the Viewpoint.
Host	Defines the computer where the job is executed that is included in the Viewpoint.
Host Group	Defines the host group, which is a collection of Agents or Agentless Hosts, that is included in the Viewpoint. For more information, see Host Groups.
Critical	Determines whether critical-path jobs are included in the Viewpoint. For more information, see Job General Attributes.
Cyclic	Indicates that the job is set to execute cyclically A SMART folder or job that executes multiple times in one run, whether for specific intervals, sequences of intervals, or times..
Included in an SLA	Includes jobs that belong to an SLA Management Service A service that enables you to monitor critical job flows for potential delays and failures..
Rule-Based Calendar	Determines a Rule-Based Calendar A type of calendar with multiple sets of scheduling criteria, including a confirmation calendar and activity period, which you can base on another calendar.
Command	Defines the OS Command line executed by the job.
Override Path	Determines the alternative file path for running a job if the specified file path is not found.
Job Status	Determines whether jobs that Ended OK, Not OK, or both are included in the Viewopint.
Run Date	Shows the date that the job executed.
Execution Time	Shows the number of seconds that it takes to execute the job.
Run ID	Shows the run ID The identification code for a SMART folder, sub-folder, or job execution. number.
Folder Held	Determines which Folder is in a Hold A job action that stops the job from executing or pauses a job that is currently executing. status.
Held	Determines which job is in a hold status.
Include Deleted Jobs	Shows deleted jobs in the Viewpoint.
Resource Pools	Specifies the Resource Pool A type of quantifiable resource, which represents the total amount of resources from a physical or logical device that a job can access. and for each job the quantity required/used by that job.
Lock Resources	Specifies whether the job requires exclusive or shared access to the Lock Resource A type of prerequisite that controls the flow of the workflow, which represents a physical or logical device that folders, sub-folders, or jobs can exclusively access or share..
Wait for Event Name	Specifies the name of the Wait For event An conditional entity that creates a sequential relationship between jobs by enabling the successor job to execute after the predecessor job has executed..
Wait for Event Date	Shows the date of the Wait For event in mmdd format.
Event Name	Specifies the name of the Add/Delete event.
Event Date	Shows the date of the Add/Delete event in mmdd format.

Creating a Historical Viewpoint

This procedure describes how to create a historical Viewpoint using previously saved Viewpoints, which enables you to review job data from past dates.

Before You Begin

You must create and save at least one Viewpoint to use this tool.

Begin

1. From the table of saved Viewpoints in the Viewpoints tab, click on the Viewpoint that contains the historical job data you want to review.

2. From the Viewpoints toolbar, click History.

   A dialog box with a calendar appears.

3. From the calendar, click the date you want to review.

   The saved Viewpoint for that date appears.

   • You can edit Viewpoint fields by clicking Edit.

   • Jobs from earlier dates that remain in the active environment appear in the Run Date column in List View.