Grant DPR Authority (GRTDPRAUT)

The Grant DPR Authority (GRTDPRAUT) command authorizes a list of users to the DataPropagator control tables so that the users can be registrars and subscribers. Registrars can make files eligible for copying, and subscribers can create subscriptions to and propagate from a registered base file.

You cannot run the GRTDPRAUT command while the Capture or Apply processes are running, or when applications using the source tables are active. This is because authorizations cannot be changed on files that are in use.

As more tables are registered for capture by authorized registrars, the person who registered the tables must assign subscriber rights to the users who should be authorized to those tables.

The command issues an error message if a user specified on the command does not exist, if the user running the command is not authorized to the user profiles specified, if the DataPropagator control tables do not exist , or if the user running the command does not have permission to grant authorities to the DataPropagator control tables.

The GRTDPRAUT command compensates for these different authority requirements. For example, the authority requirements for the user who is running Capture and Apply may differ from the authority requirements for the user who defines registrations and subscriptions.

You must must have *ALLOBJ special authority to grant authorities with the GRTDPRAUT command.

Note: Do not precede an entry with an asterisk unless that entry is shown on the display itself or in the help information with an asterisk.

Error Messages for GRTDPRAUT

*ESCAPE Messages

ASN3011: Not allowed to grant registration authority.
ASN3013: Not allowed to grant subscription authority.
ASN3095: Registration authority granted. Not granted to some objects.
ASN3097: Subscription authority granted. Not granted to some objects.
ASN301A: The APYQUAL parameter cannot be used.
ASN301B: Not allowed to grant authority.
ASN301D: authority granted. Not granted to some objects.
ASN301E: in library , type was not found.
ASN301F: *ALLOBJ special authority is required.
ASN302A: Authority cannot be granted to in type .
ASN302B: The USER and APYQUAL parameters are incorrect.

Keyword	Description	Choices	Notes
CAPCTLLIB	Capture control library	Name, ASN	Optional
USER	User	Single values: PUBLIC Other values (up to 50 repetitions): Name*	Required, Positional 1
AUT	Authority	REGISTRAR, SUBSCRIBER, CAPTURE, APPLY	Required, Positional 2
APYQUAL	Apply qualifier	Character value, ALL, USER	Optional

Authority (AUT)

Identifies the type of DataPropagator authority being granted.

*REGISTRAR: The users are granted registrar authority.
*REGISTRAR authority will give the user the authorities necssary to define, change, and remove replication sources. The GRTDPRAUT command will not grant the authorities needed to run the Capture process. This must be done using the *CAPTURE keyword.
*SUBSCRIBER: The users are granted subscriber authority.
*SUBSCRIBER authority will give the user the authorities necessary to define, change, and remove replication targets. The GRTDPRAUT command will not grant the authorities needed to run the apply process. This must be done using the *APPLY keyword.
*CAPTURE: The users are granted capture authority.
A user with capture authority has sufficient authority to all the objects necessary to successfully run the Capture process.
*APPLY: The users are granted apply authority.
A user with apply authority has sufficient authority to all the objects located on this system necessary to run the Apply process. The command does not grant authority to any of the objects that reside on other databases that are accessed by the Apply process.

Apply qualifier (APYQUAL)

Identifies the apply qualifier that will be used. specified and when AUT(*APPLY) or AUT(*SUBSCRIBER) is specified.

*ALL

The user is granted authority to run the Apply process or define and remove subscriptions for all apply qualifiers.

The user will be granted authority to all CD tables and CCD tables associated with replication sources defined on this system.
The user will be granted authority to all replication targets listed in IBMSNAP_SUBS_MEMBR that reside on this system.

*USER

The users specified on the USER parameter will be granted authority to subscriptions with an apply qualifier the same as the user name.

apply-qualifier

The user is granted authority to run the apply process or define and remove subscriptions for the apply qualifiers associated with this apply qualifier.

The user will be granted authority to all replication sources, CD tables and CCD tables associated with records in IBMSNAP_PRUNCNTL that have a value in the APPLY_QUAL column matching the value input with the APYQUAL parameter.
The user will be granted authority to all replication targets on this system listed in IBMSNAP_SUBS_MEMBR that have a value in the APPLY_QUAL column matching the value input with the APYQUAL parameter.

Error messages

*ESCAPE Messages

ASN3011: Not allowed to grant registration authority.
ASN3013: Not allowed to grant subscription authority.
ASN3095: Registration authority granted. Not granted to some objects.
ASN3097: Subscription authority granted. Not granted to some objects.
ASN301A: The APYQUAL parameter cannot be used.
ASN301B: Not allowed to grant authority.
ASN301D: authority granted. Not granted to some objects.
ASN301E: in library , type was not found.
ASN301F: *ALLOBJ special authority is required.
ASN302A: Authority cannot be granted to in type .
ASN302B: The USER and APYQUAL parameters are incorrect.