RMTTASK

Valid for

Extract

Description

Use RMTTASK to create a one-time processing task on the target system. RMTTASK directs the Manager process on the target system to start Replicat process automatically to load the data and then stop it when the task is finished. This parameter is used for initial data loads.

A RMTHOST statement must precede the RMTTASK statement. RMTTASK is required for batch tasks.

Syntax

RMTTASK <task name>, GROUP <group name>
[, FORMAT RELEASE <xx>.<yy> ]
[, PARAMS "<replicat params>" ]

task_name

Enter REPLICAT, currently the only task on the remote system.

GROUP group_name

The name of the initial-load Replicat group on the target system. This option defines the target Replicat group processes the load data.

PARAMS "runtime_params"

Optional. Specifies run-time parameters to pass to the initial-load Replicat process other than standard parameters, such as report file, parameter file, and group name, which are supplied automatically.

FORMAT RELEASE <xx>.<yy>:

Specifies the trail format of the data that is sent by Extract to a trail, file, or (if a remote task). The value tells the reader process whether the data records are of a version that it supports. The format depends on the version of the Oracle GoldenGate process. Newer Oracle GoldenGate versions contain different characteristic than older ones.

FORMAT is a required keyword.

RELEASE specifies an Oracle GoldenGate release version. <xx> is the major version number, and <yy> is the minor version number. The <xx>.<yy> must reflect a current or earlier, generally available (GA) release of Oracle GoldenGate. Valid values are 9.0 through the current Oracle GoldenGate <xx>.<yy> version number, for example 19.1 or 21.3 (If you use an Oracle GoldenGate version that is earlier than 9.0, specify either 9.0 or 9.5.) The release version is programmatically mapped back to an appropriate internal compatibility level. The default is the current version of the process that writes to this trail.

Example

In the following example, records from table PRODUCT and ACCOUNT are sent to initial-load tasks on target system NY.

EXTRACT EXTTASK
RMTHOST NY, MGRPORT 7809
RMTTASK REPLICAT, GROUP tabload
TABLE $DATA.MASTER.PRODUCT; 
TABLE $DATA.MASTER.ACCOUNT;