This section summarizes the GGSCI commands and includes the following topics:
Topics:
Use the Manager commands to control the Manager process. Manager is the parent process of Oracle GoldenGate and is responsible for the management of its processes and files, resources, user interface, and the reporting of thresholds and errors.
Table 1-1 Manager Commands
Command | Description |
---|---|
Returns information about the Manager port and child processes. |
|
Returns information about a running Manager process. |
|
Starts the Manager process. |
|
Returns the state of the Manager process. |
|
Stops the Manager process. |
Use the Extract commands to create and manage Extract groups. The Extract process captures either full data records or transactional data changes, depending on configuration parameters, and then sends the data to a trail for further processing by a downstream process, such as a data-pump Extract or the Replicat process.
Table 1-2 Extract Commands
Command | Description |
---|---|
Creates an Extract group. |
|
Changes attributes of an Extract group |
|
Deletes run history for an Extract group |
|
Deletes an Extract group. |
|
Returns information about an Extract group. |
|
Forcibly terminates the run of an Extract group. |
|
Returns information about Extract lag. |
|
Registers an Extract group with an Oracle database. |
|
Sends instructions to, or returns information about, a running Extract group. |
|
Starts an Extract group. |
|
Returns processing statistics for an Extract group. |
|
Returns the state of an Extract group. |
|
Stops an Extract group. |
|
Unregisters an Extract group from an Oracle database. |
Use the Replicat commands to create and manage Replicat groups. The Replicat process reads data extracted by the Extract process and applies it to target tables or prepares it for use by another application, such as a load application.
Table 1-3 Replicat Commands
Command | Description |
---|---|
Adds a Replicat group. |
|
Changes attributes of a Replicat group. |
|
Deletes run history of a Replicat group. |
|
Deletes a Replicat group. |
|
Returns information about a Replicat group. |
|
Forcibly terminates a Replicat group. |
|
Returns information about Replicat lag. |
|
Registers a Replicat group with an Oracle database. |
|
Sends instructions to, or returns information about, a running Replicat group. |
|
Starts a Replicat group. |
|
Returns processing statistics for a Replicat group. |
|
Returns the state of a Replicat group. |
|
Stops a Replicat group. |
|
Returns all threads of a coordinated Replicat to a uniform start point after an unclean shutdown of the Replicat process. |
|
Unregisters a Replicat group from an Oracle database. |
Use the ER command to issue standard Extract and Replicat commands to multiple Extract and Replicat groups as a unit. See "ER" for how to use this command.
Table 1-4 ER Commands
Command | Description |
---|---|
|
Returns information about the specified wildcarded groups. |
|
Forcibly terminates the specified wildcarded groups. |
|
Returns lag information about the specified wildcarded groups. |
|
Sends instructions to, or returns information about, the specified wildcarded groups. |
|
Starts the specified wildcarded groups. |
|
Returns processing statistics for the specified wildcarded groups. |
|
Returns the state of the specified wildcarded groups. |
|
Stops the specified wildcarded groups. |
Use the wallet commands to manage the master-key wallet that stores Oracle GoldenGate master encryptions keys, and to add master keys to this wallet.
Table 1-5 Wallet Commands
Command | Description |
---|---|
Creates a wallet that stores master encryption keys. |
|
Opens a master-key wallet. |
|
Permanently removes from a wallet the master keys that are marked as deleted. |
|
Adds a master key to a master-key wallet. |
|
Returns information about master keys. |
|
Adds a new version of a master key. |
|
Marks a master key for deletion. |
|
Changes the state of a master key from being marked as deleted to marked as available. |
Use the credential store commands to manage an Oracle GoldenGate credential store and to add credentials to the credential store.
Table 1-6 Credential Store Commands
Command | Description |
---|---|
Creates a credentials store (wallet) that stores encrypted database user credentials. |
|
Changes the contents of a credentials store. |
|
Returns information about a credentials store. |
|
Deletes the wallet that serves as a credentials store. |
Use the trail commands to create and manage Oracle GoldenGate trails. A trail is a series of files in which Oracle GoldenGate temporarily stores extracted data on disk until it has been applied to the target location.
Table 1-7 Trail Commands
Command | Description |
---|---|
Adds a local trail to the Oracle GoldenGate configuration. |
|
Adds a remote trail to the Oracle GoldenGate configuration. |
|
Changes attributes of a local trail. |
|
Changes attributes of a remote trail. |
|
Removes a local trail from the Oracle GoldenGate configuration. |
|
Removes a remote trail from the Oracle GoldenGate configuration. |
|
Returns information about a local trail. |
|
Returns information about a remote trail. |
Use the parameter commands to view and manage Oracle GoldenGate parameter files. See Administering Oracle GoldenGate for Windows and UNIX for more information about how to work with parameter files.
Table 1-8 Parameter Commands
Command | Description |
---|---|
Opens a parameter file for editing in the default text editor. |
|
Sets the default text editor program for editing parameter files. |
|
Displays the contents of a parameter file in read-only mode on-screen. |
|
Queries for and displays static information. |
|
Displays currently-running parameter values. |
Use the database commands to interact with the database from GGSCI.
Table 1-9 Database Commands
Command | Description |
---|---|
Logs the GGSCI session into a database so that other commands that affect the database can be issued. |
|
Shows the data in the Oracle GoldenGate DDL history table. |
|
Encrypts a database login password. |
|
Updates an Oracle sequence so that initial redo records are available at the time that Extract starts capturing transaction data after the instantiation of the replication environment. |
|
Lists the tables in the database with names that match the input specification. |
|
Specifies the credentials of the user that an Oracle GoldenGate process uses to log into an Oracle mining database. |
|
Sets the CCSID of the GGSCI session in a DB2 for i environment. |
Use trandata commands to configure the appropriate database components to provide the transaction information that Oracle GoldenGate needs to replicate source data operations.
Table 1-10 Trandata Commands
Command | Description |
---|---|
Enables schema-level supplemental logging. |
|
Enables table-level supplemental logging. |
|
Disables schema-level supplemental logging. |
|
Disables table-level supplemental logging. |
|
Returns information about the state of schema-level supplemental logging. |
|
Returns information about the state of table-level supplemental logging. |
|
Sets whether and how table instantiation CSN filtering is used. |
|
Clears table instantiation CSN filtering. |
Use the checkpoint table commands to manage the checkpoint table that is used by Oracle GoldenGate to track the current position of Replicat in the trail.
For more information about checkpoints and using a checkpoint table, see Administering Oracle GoldenGate for Windows and UNIX.
Table 1-11 Checkpoint Table Commands
Command | Description |
---|---|
Creates a checkpoint table in a database. |
|
Removes checkpoint records that are no longer needed. |
|
Removes a checkpoint table from a database. |
|
Returns information about a checkpoint table. |
|
Adds a supplemental checkpoint table when upgrading Oracle GoldenGate from version 11.2.1.0.0 or earlier. |
Use the trace table commands to manage the Oracle GoldenGate trace table that is used with bidirectional synchronization of Oracle databases. Replicat generates an operation in the trace table at the start of each transaction. Extract ignores all transactions that begin with an operation to the trace table. Ignoring Replicat's operations prevents data from looping back and forth between the source and target tables.
For more information about bidirectional synchronization, see Administering Oracle GoldenGate for Windows and UNIX.
Table 1-12 Oracle Trace Table Commands
Command | Description |
---|---|
Creates a trace table. |
|
Removes a trace table. |
|
Returns information about a trace table. |
Use the data store commands to control the data store that Oracle GoldenGate uses to store monitoring information for use by Oracle GoldenGate Monitor.
Table 1-13 Oracle GoldenGate Veridata Data Store Commands
Command | Description |
---|---|
Changes the memory model that is used for interprocess communication by the data store. |
|
Creates the data store. |
|
Removes the data store. |
|
Returns information about the data store. |
|
Repairs the data store after an upgrade or if it is corrupt. |
Use the JAgent commands to control the Oracle GoldenGate Monitor JAgent.
Table 1-14 JAgent Commands
Command | Description |
---|---|
Returns information about the JAgent. |
|
Starts the JAgent. |
|
Returns the state of the JAgent. |
|
Stops the JAgent. |
Use the heartbeat table commands to control the Oracle GoldenGate automatic heartbeat functionality.
Table 1-15 Heartbeat Table Commands
Command | Description |
---|---|
Creates the objects required for automatic heartbeat functionality. |
|
Alters existing heartbeat objects. |
|
Deletes existing heartbeat objects. |
|
Deletes entries in the heartbeat table. |
|
Displays heartbeat table information. |
Use the following commands to control various other aspects of Oracle GoldenGate.
Table 1-16 Miscellaneous Commands
Command | Description |
---|---|
Executes a previous GGSCI command without modifications. |
|
Enables or disables the use of nested |
|
Creates the default directories within the Oracle GoldenGate home directory. |
|
Sets a default journal for multiple tables or files for the |
|
Allows the modification and re-execution of a previously issued GGSCI command. |
|
Provides assistance with syntax and usage of GGSCI commands. |
|
Shows a list of the most recently issued commands since the startup of the GGSCI session. |
|
Displays status and lag for all Oracle GoldenGate processes on a system. |
|
Displays recently processed markers from a NonStop system. |
|
Processes a file that contains a list of Oracle GoldenGate commands. |
|
Executes shell commands from within the GGSCI interface. |
|
Displays the attributes of the Oracle GoldenGate environment. |
|
Displays information about the operating system and database. |
|
Displays the Oracle GoldenGate error log ( |
|
Displays the process report or the discard file that is generated by Extract or Replicat. |