Replication Management API Reference, 130 of 179

ALTER_USER_AUTHORIZATION procedure

This procedure alters the contents of the DBA_REPCAT_USER_AUTHORIZATIONS view. Specifically, you can change user/deployment template authorization assignments. This procedure is helpful, for example, if an employee is reassigned and requires the snapshot environment of another deployment template. The DBA simply assigns the employee the new deployment template and the user is authorized to instantiate the target template.

Syntax

DBMS_REPCAT_RGT.ALTER_USER_AUTHORIZATION (
   user_name                   IN   VARCHAR2,
   refresh_template_name       IN   VARCHAR2,
   new_user_name               IN   VARCHAR2 := '-',
   new_refresh_template_name   IN   VARCHAR2 := '-');

Parameters

Table 8-238 ALTER_USER_AUTHORIZATION Procedure Parameters

Parameter	Description
user_name	Name of the user whose authorization you want to alter.
refresh_template_ name	Name of the deployment template that is currently assigned to the specified user that you want to alter.
new_user_name	Use this parameter to define a new user for this template authorization. Do not specify a value to keep the current user
new_refresh_ template_name	The deployment template that the specified user (either the existing or, if specified, the new user) is authorized to instantiate. Do not specify a value to keep the current deployment template.

Exceptions

Table 8-239 ALTER_USER_AUTHORIZATION Procedure Exceptions

Exception	Description
miss_user_ authorization	The combination of `user_name` and `refresh_template_name` values specified does not exist in the `DBA_REPCAT_USER_AUTHORIZATIONS` view.
miss_user	The user name specified for the `new_user_name` or `user_name` parameter is invalid or does not exist.
miss_refresh_ template	The deployment template specified for the `new_refresh_template` parameter is invalid or does not exist.
dupl_user_ authorization	A row already exists for the specified user name and deployment template name. See the `DBA_REPCAT_USER_AUTHORIZATIONS` view.