Overview

Roles control user and group access to administrative functions within Universal Controller. A user or group that has been assigned a role has permission to perform any function defined for that role.

Permissions control user and group access to specific functions for specific types of Controller records.

Some roles have permissions for specific functions that can be assigned individually. For example, a user that has been assigned the ops_agent_cluster_admin role has permission to perform all functions associated with Agent Clusters. A user that has not been assigned the ops_agent_cluster_admin role still can be given permission to perform individual functions associated with Agent Clusters via the Agent Cluster Permissions.

Conversely, since there is no role associated with Agents, permissions for a user to perform functions associated with Agents must be assigned specific Agent Permissions.

Note

The ops_admin role assigns a user permission to perform all functions.

Assigning Roles to Users or Groups

Roles control user access to functions that include:

Setting up security.
Creating reports, filters, and gauges.
Creating Agent Clusters, SNMP Managers.
Creating Email Connections, Database Connections, PeopleSoft Connections, and SAP Connections.
Creating and promoting bundles of records.

Each role is a predefined collection of administrative functions (see Description of Roles, below). By assigning a role to a user or group, you automatically give that user or group all functions associated with that role.

Note

You cannot add new roles to the Controller; you must assign administrative functions to groups or users using the predefined roles.

To assign roles to a user or group:

Step 1	Open a User or Group record.
Step 2	For a User, click the User Roles tab. A list of Roles assigned to the User displays. For a Group, click the Group Roles tab. A list of Roles assigned to the Group displays.
Step 3	Click Edit. An Edit Members pop-up displays that allows you to assign Roles to the User / Group. For example: The Collection window displays all Roles that have not been assigned to this User / Group. The Roles List window displays all Roles that have been assigned to this User / Group.
Step 4	To filter the Users/Groups listed in the Collection window, enter characters in the text field above the Name column. Only Users/Groups containing that sequence of characters will display in the list.
Step 5	To assign a Role to the User / Group, move the Role from the Collection window to the Roles window: To move a single Role, double-click it or click it once and then click the > arrow. To move multiple Roles, Ctrl-click them and then click the > arrow. To move all Roles, click the >> arrow. To unassign a Role to the User / Group, move the Role from the Roles window to the Collection window: To move a single Role, double-click it or click it once and then click the < arrow. To move multiple Roles, Ctrl-click them and then click the < arrow. To move all Roles, click the << arrow.
Step 6	Click Save.

Description of Roles

The following table summarizes the roles available in the Controller.

Role Name	Available Functions	Contains Roles
ops_admin	All functions; this is the Universal Controller administrator role. The easiest way to assign full permissions to a user is to add the user to the Administrator Group, which by default is assigned the ops_admin role. Note The ops_admin role contains all other roles. If a user is assigned the ops_admin role, no other roles need to be assigned to that user, and unassigning any other role from the user will not revoke that role.	The ops_admin role contains all other roles.
ops_agent_cluster_admin	Create, read, update, and delete agent clusters. (Also see Agent Cluster Permissions, below.)
ops_audit_view	Read all Audits. If Audit Owner Read Permitted system property = true, users can view their own audits without having either the ops_admin role or the ops_audit_view role.
ops_bundle_admin	Create, read, update, and delete Bundles. View Promotion Targets, including agent mappings. View Promotion History. View a record's list of bundles. View Promotion Schedules. Add a record to a bundle. Create bundles by date. Generate a Bundle Report. (Also see Bundle Permissions and Promotion Target Permissions, below.)
ops_dashboard_global	Create, update, and delete Dashboard Details with Everyone visibility; updating includes updating Dashboard visibility.
ops_dashboard_group	Create, update, and delete Dashboard Details that are visible for a group in which this user is a member; updating includes updating Dashboard visibility.
ops_dba	Create, update, delete Database Connections. (Also see Database Connection Permissions, below.)
ops_email_admin	Create, read, update, delete Email Connections. (Also see Email Connection Permissions, below.)
ops_filter_global	Create Filters with Everyone visibility.
ops_filter_group	Create Filters that belong to a group of which this user is a member.
ops_forecast_view	Read Forecast Calendar, Forecasts List, and Forecast Details. Note Users also can read forecast information, without being assigned this role, if they have Read permission for the Task specified in the Forecast Details.
ops_imex	List Import/Export XML.
ops_jcl_edit	Modify the JCL contents and update it.	ops_jcl_view
ops_jcl_view	Submit the JCL view request to the agent and view the contents of it.
ops_ldap_admin	Read and update LDAP Settings.
ops_multi_update	Update multiple records.
ops_oauth_admin	Create, read, update, and delete OAuth Clients.
ops_oms_admin	Create, update, and delete OMS Servers.
ops_peoplesoft_admin	Create, read, update, and delete PeopleSoft Connections. (Also see PeopleSoft Connection Permissions, below.)
ops_promotion_accept_bundle	Accept bundles being promoted to a target server. (The Accept Bundle command is executed on the target server automatically as part of the Promote and Promote Bundle commands and does not involve user interaction.)
ops_promotion_admin	Create, read, update, and delete Promotion Targets, including agent mappings. View Bundles. Refresh Target Agents. Promote records. Promote or schedule the promotion of a bundle. Reschedule, cancel, and delete Promotion Schedules. Generate a Bundle report. Accept bundles being promoted to a target server. (The Accept Bundle command is executed on the target server automatically as part of the Promote and Promote Bundle commands and does not involve user interaction.) Note By default, the ops_promotion_admin role also grants Read permission for any type of definition that can be added to a Bundle, given the expectation that a promotion administrator would review the content of a Bundle before promoting it. To change this default behaviour, see the Promotion Read Permission Required Universal Controller property. (Also see Bundle Permissions and Promotion Target Permissions, below.)	ops_promotion_accept_bundle
ops_property_admin	Read, update, and delete Universal Controller system properties and Password Settings.
ops_report_admin	Create, read, update, and delete any report, regardless of visibility, in addition to the roles granted by the ops_widget_admin role. Create, update, and delete Dashboard Details with Everyone visibility and Dashboard Details that are visible for a group in which this user is a member; updating includes updating Dashboard visibility. The Strict Report Create Constraints Universal Controller system property specifies whether or not to restrict report creation only to users with the ops_admin, ops_report_admin, ops_report_group, or ops_report_global role. The Strict Dashboard Create Constraints Universal Controller system property specifies whether or not to restrict Dashboard creation only to users with the ops_admin, ops_report_admin, ops_dashboard_group, or ops_dashboard_global role.	ops_dashboard_global ops_dashboard_group ops_report_global ops_report_group ops_report_publish ops_widget_admin
ops_report_global	Create global reports.
ops_report_group	Create reports that belong to a group to which this user is a member.
ops_report_publish	Publish reports. (This role was applicable only to the Controller 5.x release.)
ops_restore_version	Restore old versions of records.
ops_sap_admin	Create, read, update, and delete SAP Connections. (Also see SAP Connection Permissions, below.)
ops_server_operation_admin	Run Server Operations.
ops_service	Log in and view Home Dashboard. The Active Task Instances By Status widget will remain blank unless the user is assigned the Task Instance Read permission, as the ops_service role does not include access to such data. Read Agents. Read Universal Controller system properties. Read Password Settings. Read LDAP Settings (and run the Test Connection command). Read Single Sign-On Settings. Read Universal Event Templates and related data (Fields and Field Choices). Read Universal Templates and related data (Fields and Field Choices). Read Data Backup/Purge. Unless the user also is assigned the ops_audit_view role, the Audit tab on the Data Backup/Purge Details, which allows for conveniently viewing related Audit records, will not be available. Read Users and related data (Roles, Group Membership, and Permissions). Read Groups and related data (Roles, Group Membership, Child Groups, and Permissions). Read Universal Controller Metrics (Monitoring Web Services).
ops_simulation_view	Read Simulation records.
ops_snmp_admin	Create, read, update, and delete SNMP Managers, to which the Controller sends SNMP notifications. (Also see SNMP Manager Permissions, below.)
ops_sso_admin	Read and update Single Sign-On Settings.
ops_universal_event_template_admin	Create, read, update, and delete Universal Event Templates.	ops_universal_event_template_view
ops_universal_event_template_view	Read Universal Event Templates.
ops_universal_template_admin	Create, read, update, and delete Universal Templates (including Universal Template Event Templates).	ops_universal_template_view
ops_universal_template_view	Read Universal Templates (including Universal Template Event Templates).
ops_user_admin	Create, read, update, and delete users and groups.	ops_user_impersonate
ops_user_impersonate	Allows an authenticated user to impersonate another user by using the X-Impersonate-User HTTP header on a Web Service request.
ops_webhook_admin	Create, read, update, and delete Webhooks. Enable, Disable, and Assign Execution User for Webhooks.	ops_webhook_view
ops_webhook_view	Read Webhooks.
ops_widget_admin	Create, update, and delete Widgets.

Assigning Permissions to Users or Groups

Permissions control user access to specific types of Controller records, such as task or trigger, and the types of functions that can be performed for those record types, such as create or delete.

You can further narrow down which records each permission applies to by specifying either name parameters or Business Services. For example, a given permission might apply only to tasks whose name begins with "SF," or a permission might apply only to tasks that have been assigned to a specific Business Service or to tasks that do not belong to any Business Services. See General Permissions Field Descriptions, below, for more details.

To add permissions to a user or group:

Step 1	Open a User or Group record.
Step 2	Click the Permissions tab. A list of permissions assigned to the User / Group displays. For Example: Note The Business Services column represents a virtual field whose value is determined by data from both the Member of Business Services field and the Member of Any Business Service or Unassigned field. If you want to apply a sort relating to the data in Business Services, you have to add either or both Member of Business Services and Member of Any Business Service or Unassigned fields as columns and apply the desired sort on either or both of them.
Step 3	Click New. The Permissions Details pop-up displays.
Step 4	Select permissions for the selected user or group. The permissions available differ depending on the Type of permission that you select. Available permissions are Create, Read, Update, Delete, and Execute. For some record types, additional Commands are available. If the permission does not apply to the record type in the Type drop-down, the permission does not appear in the display. These permissions automatically include other permissions: Create permission includes Read and Update permissions. Update permission includes Read permission. Delete permission includes Read permission.

General Permissions Field Descriptions

The following fields of information and buttons display in the Permissions Details for all Permission types:

Field Name	Description
Details	This section contains detailed information about the permission.
Name	Applies this permission to records whose name matches the string specified here. Wildcards are supported.
Business Service Criteria	This section contains criteria for selecting records to apply permissions by their business service membership.
Member of Any Business Service or Unassigned Member of Specific Business Services or Unassigned Member of Specific Business Services Unassigned Not Member of Specific Business Services or Unassigned Not Member of Specific Business Services	Criteria for matching records by their business service membership. Member of Any Business Service or Unassigned Member of Specific Business Services or Unassigned You must specify one or more business services from the Specific Business Services drop-down. Member of Specific Business Services You must specify one or more business services from the Specific Business Services drop-down. Unassigned Not Member of Specific Business Services or Unassigned You must specify one or more business services from the Specific Business Services drop-down. Not Member of Specific Business Services You must specify one or more business services from the Specific Business Services drop-down.
Metadata	This section contains Metadata information about this record.
UUID	Universally Unique Identifier of this record.
Updated By	Name of the user that last updated this record.
Updated	Date and time that this record was last updated.
Created By	Name of the user that created this record.
Created	Date and time that this record was created.
Buttons	This section identifies the buttons displayed above and below the Permissions Details that let you perform various actions.
Save	Saves a new record in the Controller database.
Save & New	Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.
Update	Saves updates to the record.
Delete	Deletes the current record.
Refresh	Refreshes any dynamic data displayed in the Details.
Close	For pop-up view only; closes the pop-up view of this record.

Types of Permissions

This section identifies the different types of permissions that you can add to a user or group.

Agent Permissions

Options	Description
Read	Grants permission to read an Agent definition. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an Agent definition. (Only certain fields can be updated.)
Delete	Grants permission to delete an Agent.
Execute	Grants permission to execute a task on an Agent.
Commands	ALL: Grants permission to suspend and resume Agents. Resume Agent: Grants permission to resume the ability of a suspended Agent to run tasks. Suspend Agent: Grants permission to suspend the ability of an Agent to run tasks.

Agent Cluster Permissions

(You also can assign Agent Cluster Permissions to a user by assigning the ops_agent_cluster_admin role to the user.)

Options	Description
Create	Grants permission to create a new Agent Cluster.
Read	Grants permission to read an Agent Cluster definition. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an Agent Cluster definition. (Only certain fields can be updated.)
Delete	Grants permission to delete an Agent Cluster.
Commands	ALL: Grants permission to issue any command. Resume Agent Cluster: Grants permission to resume the ability of a suspended Agent Cluster to run tasks. Suspend Agent Cluster: Grants permission to suspend the ability of an Agent Cluster to run tasks. Resume Agent Cluster Membership: Grants permission to resume the membership of an Agent in an Agent Cluster. Suspend Agent Cluster Membership: Grants permission to suspend the membership of an Agent from an Agent Cluster. Resolve Agent Cluster: Grants permission to resolve the Network Alias of an Agent Cluster with a Distribution type of Network Alias.

Application Permissions

Options	Description
Create	Grants permission to create a new Application.
Read	Grants permission to read an Application.
Update	Grants permission to update an Application.
Delete	Grants permission to delete an Application.
Commands	See Application Control Tasks for details. Options: ALL: Grants permission to execute a Start, Stop, and Query from the Application resource screen. Start: Grants permission to execute a Start from the Application resource screen. Stop: Grants permission to execute a Stop from the Application resource screen. Query: Grants permission to execute a Query from the Application resource screen.

Bundle Permissions

(You also can assign Bundle Permissions to a user by assigning the ops_bundle_admin role to the user.)

Options	Description
Create	Grants permission to create a Bundle matching both the specified name wildcard and business service membership, including the use of the Create Bundle By Date and Create Bundle By Business Service commands.
Read	Grants permission to read a Bundle matching both the specified name wildcard and business service membership. User can run a Bundle Report for a Bundle matching both the specified name wildcard and business service membership. User can Read a Promotion Schedule associated with a Bundle matching both the specified name wildcard and business service membership.
Update	Grants permission to update a Bundle matching both the specified name wildcard and business service membership, including the use of the Add To Bundle command.
Delete	Grants permission to delete a Bundle matching both the specified name wildcard and business service membership.
Commands	ALL: Grants permission to issue any command. Promote Bundle: Grants permission to promote a Bundle. For the ALL or Promote Bundle command: User can promote a Bundle matching both the specified name wildcard and business service membership, assuming the user has Read permission for the Bundle. User can Cancel, Reschedule, or Delete a Promotion Schedule associated with a Bundle matching both the specified name wildcard and business service membership, assuming the user has Read permission for the Bundle.

Calendar Permissions

Options	Description
Create	Grants permission to create a new Calendar.
Read	Grants permission to read a Calendar. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update a Calendar.
Delete	Grants permission to delete a Calendar.
Commands	ALL: Grants permission to issue any command. Copy Calendar: Grants permission to copy a Calendar.

Credential Permissions

Options	Description
Create	Grants permission to create a new Credential.
Read	Grants permission to read a Credential. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update a Credential.
Delete	Grants permission to delete a Credential.
Execute	Grants permission to execute a task that requires a Credential.
Commands	N/A

Database Connection Permissions

(You also can assign Database Connection Permissions to a user by assigning the ops_dba role to the user.)

Options	Description
Create	Grants permission to create a new Database Connection.
Read	Grants permission to read a Database Connection. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update a Database Connection.
Delete	Grants permission to delete a Database Connection.
Execute	Grants permission to execute a task that requires a Database Connection. (Displays only if the Strict Connection Execute Constraints Universal Controller system property is true.)
Commands	ALL: Grants permission to issue any command. Copy Database Connection: Grants permissions to copy a Database Connection. Test Connection: Grants permission to test a Database Connection.

Email Connection Permissions

(You also can assign Email Connection Permissions to a user by assigning the ops_email_admin role to the user.)

Options	Description
Create	Grants permission to create a new Email Connection.
Read	Grants permission to read an Email Connection. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an Email Connection.
Delete	Grants permission to delete an Email Connection.
Execute	Grants permission to execute a task that requires an Email Connection. (Displays only if the Strict Connection Execute Constraints Universal Controller system property is true.)
Commands	ALL: Grants permission to issue any command. Copy Email Connection: Grants permissions to copy an Email Connection. Test Connection: Grants permission to test an Email Connection.

Email Template Permissions

Options	Description
Create	Grants permission to create a new Email Template.
Read	Grants permission to read an Email Template. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an Email Template.
Delete	Grants permission to delete an Email Template.
Commands	ALL: Grants permission to issue any command. Copy Email Template: Grants permission to copy an Email Template.

OAuth Client Permissions

(You also can assign OAuth Client Permissions to a user by assigning the ops_oauth_admin role to the user.)

Options	Description
Create	Grants permission to create a new OAuth Client.
Read	Grants permission to read an OAuth Client.
Update	Grants permission to update an OAuth Client.
Delete	Grants permission to delete an OAuth Client.
Commands	-- None --

OMS Server Permissions

(You also can assign OMS Server Permissions to a user by assigning the ops_oms_admin role to the user.)

Options	Description
Create	Grants permission to create a new OMS Server.
Read	Grants permission to read an OMS Server. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an OMS Server.
Delete	Grants permission to delete an OMS Server.
Commands	ALL: Grants permission to suspend and resume OMS Servers. Resume: Grants permission to resume the connection of a suspended OMS Server. Suspend: Grants permission to suspend the connection of an OMS Server.

PeopleSoft Connection Permissions

(You also can assign PeopleSoft Connection Permissions to a user by assigning the ops_peoplesoft_admin role to the user.)

Options	Description
Create	Grants permission to create a new PeopleSoft Connection.
Read	Grants permission to read a PeopleSoft Connection. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update a PeopleSoft Connection.
Delete	Grants permission to delete a PeopleSoft Connection.
Execute	Grants permission to execute a task that requires a PeopleSoft Connection. (Displays only if the Strict Connection Execute Constraints Universal Controller system property is true.)
Commands	ALL: Grants permission to issue any command. Copy PeopleSoft Connection: Grants permission to copy a PeopleSoft Connection.

Promotion Target Permissions

(You also can assign Promotion Target Permissions to a user by assigning the ops_promotion_admin role to the user.)

Options	Description
Create	Grants permission to create a Promotion Target matching both the specified name wildcard and business service membership.
Read	Grants permission to read a Promotion Target matching both the specified name wildcard and business service membership. User can View Target Server Info for Promotion Target matching both the specified name wildcard and business service membership.
Update	Grants permission to update a Promotion Target matching both the specified name wildcard and business service membership.
Delete	Grants permission to delete a Promotion Target matching both the specified name wildcard and business service membership
Execute	Grants permission to promote a Bundle using a Promotion Target matching both the specified name wildcard and business service membership, assuming the user has both Read permission and Promote Bundle command permission for the Bundle.
Commands	ALL: Grants permission to issue any command. Refresh Target Agents: Grants permission to refresh Target Agents.

SAP Connection Permissions

(You also can assign SAP Connection Permissions to a user by assigning the ops_sap_admin role to the user.)

Options	Description
Create	Grants permission to create a new SAP Connection.
Read	Grants permission to read an SAP Connection. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an SAP Connection.
Delete	Grants permission to delete an SAP Connection.
Execute	Grants permission to execute a task that requires an SAP Connection. (Displays only if the Strict Connection Execute Constraints Universal Controller system property is true.)
Commands	ALL: Grants permission to issue any command. Copy SAP Connection: Grants permissions to copy an SAP Connection.

Script Permissions

Options	Description
Create	Grants permission to create a new Script.
Read	Grants permission to read a Script.
Update	Grants permission to update a Script.
Delete	Grants permission to delete a Script.
Execute	Grants permission to execute a Script contained by a task.
Commands	ALL: Grants permission to issue any command. Copy Script: Grants permission to copy a Script.

SNMP Manager Permissions

(You also can assign SNMP Manager Permissions to a user by assigning the ops_snmp_admin role to the user.)

Options	Description
Create	Grants permission to create a new SNMP Manager.
Read	Grants permission to read an SNMP Manager. The Read check box will be checked automatically if the Business Service Visibility Restricted Universal Controller system property is false.
Update	Grants permission to update an SNMP Manager.
Delete	Grants permission to delete an SNMP Manager.
Execute	Grants permission to execute a task that requires an SNMP Manager. (Displays only if the Strict Connection Execute Constraints Universal Controller system property is true.)
Commands	ALL: Grants permission to issue any command. Copy SNMP Manager: Grants permissions to copy an SNMP Manager.

Task Permissions

Options	Description
Create	Grants permission to create a new Task.
Read	Grants permission to read a Task.
Update	Grants permission to update a Task.
Delete	Grants permission to delete a Task.
Commands	ALL: Grants permission to issue any command. Copy Task: Grants permission to copy a Task. Launch: Grants permission to launch a Task. Recalculate Forecast: Grants permission to recalculate a forecast. Reset Statistics: Grants permission to reset statistics, including statistics being tracked by each parent Workflow of a Task. Reset z/OS Override Statistics: Grants permission to reset z/OS override statistics. Set Execution Restriction: Grants permission to set an execution restriction for a task in a workflow.

Task Instance Permissions

Options	Description
Create	Task instances are created automatically when the task launches, so the Create permission does not appear.
Read	Grants permission to read a Task Instance
Update	Grants permission to update certain fields on a Task Instance.
Delete	Grants permission to delete a Task Instance.
Commands	For command descriptions, see Manually Running and Controlling Tasks. ALL: Grants permission to issue any command. Cancel: Grants permission to cancel a Task Instance. Clear All Dependencies: Grants permission to clear all dependencies on a Task Instance. Clear Predecessors: Grants permission to clear all predecessors on a Task Instance. Clear Exclusive: Grants permission to clear all mutual exclusive dependencies from a Task Instance. Clear Resources: Grants permission to clear all resource dependencies of a Task Instance. Clear Time Wait/Delay: Grants permission to clear all Wait To Start and Delay On Start specifications for a Task Instance. Force Finish: Grants permission to force finish a Task Instance. Force Finish/Cancel: Grants permission to force finish/cancel a Task Instance. Hold: Grants permission to put a Task Instance on hold. Insert Task: Grants permission to insert a task on the workflow monitor of a workflow Task Instance. Mark as Satisfied: Can mark a dependency as satisfied. Re-run: Grants permission to re-run a Task Instance. Release: Grants permission to release a Task Instance from hold. Release Recursive: Grants permission to release a workflow and all its tasks from hold. Retrieve Output: Grants permission to execute the Retrieve Output button. Set Priority Low: Grants permission to change the priority of a task to Low. Set Priority Medium: Grants permission to change the priority of a task to Medium. Set Priority High: Grants permission to change the priority of a task to High. Set Completed: Grants permission to set a Manual Task Instance status to completed. Set Started: Grants permission to set a Manual Task Instance status to a new started time. Skip: Grants permission to skip a Task Instance. Unskip: Grants permission to unskip a Task Instance selected to be skipped. Note Universal Controller will initially check for command permission specifically for the task instance. If no command permission is granted for the task instance, Universal Controller will check if command permission is granted for the parent workflow task instance, and then continue to check for command permission up the workflow task instance hierarchy.

Universal Controller 7.6.x

Roles and Permissions