Create a Replication Agent instance and specify a resource file at the same time.
If the Replication Agent for Microsoft SQL Server or Replication Agent for Oracle primary database user login does not exist in the primary data server, the utility creates it, if specified in the resource file (create_pds_username=yes). If the user login does exist in the primary data server but does not have all the required privileges, set create to yes, to have the utility grant all required permissions.
If the Replication Agent for Microsoft SQL Server or Replication Agent for Oracle primary database user login does exist in the primary data server, has all the required privileges, and the resource file specifies that it should be created, the utility returns an error message and does not create the instance.
Otherwise, the utility returns an error message and does not create the instance.
Creates and configures a Replication Agent instance, based on the contents of the specified resource file.
Creates or grants all required privileges for the instance user, if specified in the resource file.
Starts the new Replication Agent instance, if specified in the resource file.
Initializes the new Replication Agent instance, if specified in the resource file.
The utility also returns information about the instance created and the result.
If instance creation fails, ra_admin returns an error message and information about the failure.