Activity Screen

From OpsWise Documentation Wiki

Open as PDF

Contents 1 Overview 1.1 Accessing the Activity Screen 1.2 Changing the Sorting 1.3 Changing the Columns 1.3.1 To move columns 1.3.2 To add or remove columns 1.4 Changing the Refresh Rate 1.5 Column Descriptions 2 Changing the Activity Report 2.1 Selecting a Different Activity Report 2.2 Creating a New Activity Report 2.3 Updating, Copying, Deleting Activity Reports 2.3.1 Updating an Activity Report 2.3.2 Copying an Activity Report 2.3.3 Deleting an Activity Report 3 Displaying Details about Task Instances

Overview

The Activity screen is a real-time display of task status and the OpsWise Automation Center's central console of activity. It displays all or a selected group of task instances, controlled by the Activity Report selected in the drop-down menu. The selected report also defines what columns are displayed.

This display also allows you to issue commands against task instances. If you want to issue commands against multiple instances, see Monitoring Activity from All Task Instances. You can also retrieve output from any completed task.

Accessing the Activity Screen

From the navigation pane, select Automation Center > Activity. The Activity screen displays, based on the most recently selected report. Shown below is a sample Activity display, using the report, "Today's Task Instances by Created Time."

Changing the Sorting

You can change the sorting on the display and add or remove columns.

1. Right-click on the title of the column you want to sort by. A pop-up menu displays.



2. To change the sorting, click Sort Ascending or Sort Descending.

Changing the Columns

You can move columns around on the screen or add or remove columns.

To move columns

1. Highlight the column you want to move.
2. Drag it to a new location. The arrows indicate where the column will be placed, as shown.



3. Drop the column when the arrows are pointing to the location you want.

To add or remove columns

1. Right-click on any column title .
2. Click Columns.
3. Select or deselect the columns you want to add or remove, respectively.

To make more considerable changes to the column display, update the report.

Changing the Refresh Rate

The default refresh rate on the Activity display is every 5 seconds. To change the rate:

1. Click Set Rate.



2. Enter the new rate in seconds, and click OK to save or Cancel to cancel the change.

Column Descriptions

Described below are the columns on the Activity display.

Column Name	Description
Instance Name	The name of the task that is being run.
Status	The status of this task. Defined - All task types. The new task instance has been created (the task has been launched). Not yet implemented. Waiting - All task types. The task has been loaded by a workflow and is waiting to run. Held - All task types. The task has been put on hold by a user. Resource Wait - The task with a virtual resource defined is waiting for enough units to become available on the virtual resource. Undeliverable - Agent-based tasks. The agent is unavailable. Queued - Agent-based tasks only. The task has been queued on a resource. Submitted - z/OS only. The task has been submitted to the z/OS Job Entry subsystem and scheduled by the z/OS Job Scheduler. Action Required - Manual tasks only. When a manual task launches, it goes into Action Required status, meaning a user must perform some manual activity. For details, see Manual task. Started - Agent-based and Manual tasks only. The task has started. For agent-based tasks, this means the agent has received the task. Running - All task types. The task is running. For agent-based tasks, the agent has started running the program. Running Problems - Workflows only. One or more tasks within the workflow has one of the following statuses: Held Undeliverable Running Problems (for sub-workflows) Cancel Pending In Doubt Start Failure Cancelled In Doubt - Agent-based tasks only. The agent is "in doubt" about the current status of the task instance. This may occur if an agent or agent connection goes down. In this case, the agent restarts and reviews its data about tasks in progress. If the agent finds a task still running, it resumes normal monitoring. If the agent cannot find the task, this usually indicates that the task completed, but the agent considers the task status to be "in doubt." Start Failure - All task types. The task was unable to start. Cancelled - All task types. The task was cancelled by a user. Failed - All task types. The task ran to a failure status. Skipped - All task types. The task was skipped by a user. Finished - All task types. The task was forced by the user to finish. The user may do this in cases where the task had "Cancelled" or "Failed" status, and the user needed to release other task instances depending on the successful completion of this task instance in a workflow. For more information, see Force Finishing a Task. Success - All task types. The task has completed successfully
Invoked By	How the task instance was launched. Options: Trigger: [Trigger Name] - The instance was launched by the named trigger. Workflow: [Workflow Name] - The instance was launched by the named workflow. Manually Launched - The instance was launched by a user. To identify the user who launched the instance: Click on the underlined Instance Name to display record details. Click the Show Details button. OpsWise Automation Center generates a report about the instance record and displays it in a new browser tab. Locate the field sys_created_by. That field contains the ID of the user who launched the task instance.
Start Time	The date and time the instance was launched.
End Time	The date and time the instance finished running.
Type	The type of task instance.
Duration	The amount of time the instance took to run.
Agent	If the task is agent-based, the name of the agent.
Member of Groups	If the task is assigned to a group, the name of the group.

Changing the Activity Report

You can change the selection in your Activity screen by selecting an existing Activity Report or creating a new one.

Selecting a Different Activity Report

To select a different Activity Report, click the Activity Report dropdown and click on the report you want to display. The following default reports are available:

• Active Task Instances — Displays all instances with an active status, including: Defined, Waiting, Held, Waiting for Resources, Action Required, Queued, Started, Running, In Doubt.

• Active Workflow Task Instances — Displays all workflow instances with an active status, including: Defined, Waiting, Held, Waiting for Resources, Action Required, Queued, Started, Running, In Doubt.

• Active/Late Task Instances — Displays all instances with a started late flag set to true and an active status, including: Defined, Waiting, Held, Waiting for Resources, Action Required, Queued, Started, Running, In Doubt.

• All Task Instance(s) by Status — Displays all instances, sorted by status.

• Cancelled Task Instances — Displays all instances with a status of Cancelled.

• Held Task Instance(s) — Displays all instances that were created on the current date and have a status of Held.

• In Doubt Task Instances — Displays all task instances with a status of In Doubt.

• Queued Task Instances — Displays all instances with a status of Queued.

• Running Task Instances — Displays all instances with a status of Running.

• Today's Failed Task Instances by Status — Displays all instances that were created on the current date and have one of the following statuses: Failed, Cancelled, Start Failure.

• Today's Successful Task Instances — Displays all instances that were created on the current date and have a status of Success.

• Today's Task Instance(s) by Created Time — Displays all instances that were created on the current date, sorted by created time.

• Today's Task Instance(s) by Type — Displays all instances that were created on the current date, sorted by type.

• Undeliverable Task Instances — Displays all instances with a status of Undeliverable (agent not available).

• Unsuccessful Task Instances — Displays all instances with a status of Failed, Cancelled, Start Failure, Finished.

• Waiting for Resources Task Instances — Displays all instances with a status of Waiting for Resources.

• Waiting Task Instances — Displays all instances with a status of Waiting.

• Workflow Task Instances — Displays all workflows, not including the task instances within the workflows.

• Workflow Task Instances with Problems — Displays all workflows with a status of Running Problems, not including the task instances within the workflows.

Creating a New Activity Report

Activity Reports select data about task instances from an OpsWise Automation Center table called the Activity[ops_exec] table. To create an Activity Report, you use the same form that is used to create reports. When you are generating normal reports, you can use any table from the OpsWise Automation Center database; when you create Activity Reports, you only use the Activity [ops_exec] table.

1. From the Activity Report screen, click New Report. The New Report form displays.
2. For an Activity Report, you must specify the following:
• For Type, specify List.
• For the Table field, select Activity [ops_exec]; otherwise, the saved report will not appear in the Activity Reports dropdown.

Using the instructions in Creating an Activity Report for guidance, specify the Activity Report parameters. For assistance in selecting columns, refer to the field descriptions provided with each task type.

3. To save the new Activity Report and add it to the drop-down, click Save. The report runs immediately and displays in the lower half of the screen. The new Activity Report is also added to the Activity Report drop-down menu.

Updating, Copying, Deleting Activity Reports

All Activity Reports are stored under Automation Center > Reports, under the Activity heading within one of the following sections:

• My Saved reports (if Visible to = Me)
• My Groups' reports (if Visible to = AutomationCenter_SysAdmin)
• Global reports (if Visible to = Everyone)

To update, copy, or delete an Activity Report, select Automation Center > Reports and scroll to the Activity section where the report is stored, as described above.

Updating an Activity Report

1. Display the report you want to modify.
2. Make your changes and click Update.

Copying an Activity Report

1. Display the report you want to copy.
2. Give the report a new name, specify your changes, if any, and click Insert.

Deleting an Activity Report

1. Display the report you want to delete.
2. Click Delete.

Displaying Details about Task Instances

You can view details about task instances currently being displayed on the Activity screen. Click on the Instance Name.

• If the task is a workflow, the worklow monitor opens. If you want to view record details such as status description about the workflow, use All Task Instances.

• If the task is not a workflow, the system displays the record details on the task screen.

From this screen, you can do the following:

• If the task was triggered by a workflow, you can view the parent workflow by clicking the View Parent button. This jumps to the workflow record. To display the workflow monitor, click View Workflow.
• Where applicable, you can manually intervene in processing by issuing a command.
• To show all the details of this task instance, click Show Details. A new browser tab opens and displays a report of the task instance. For a description of the data being displayed, see the documentation for that task type.
• If the task instance is complete and it generated any output, you can view it by clicking the Output tab.