Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

SA
NK
AR
no GA
n- NE
tra S
ns AN
fe (s
ra a
ble nk
lic ar.g
en a
Tools

se ne
to san
us @
e or
th ac
is le
Gu .c
Copyright © 2014, Oracle and/or its affiliates. All rights reserved.
ide om
. ) ha
sa
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Objectives

After completing this lesson, you should be able to use the

following Oracle GoldenGate troubleshooting tools:
• Knowledge Documents
• Documentation

sa
• ShowSyntax parameter

. ) ha
• logdump utility

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 2

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Tools: Overview

GoldenGate self-help tools include:

• Knowledge documents
– Maintained by experts and accessible from My Oracle Support
• Documentation

sa
– Configuration instructions and descriptions of Oracle GoldenGate

. ) ha
errors, commands, parameters, and functions
• ShowSyntax parameter

ide om
– Shows Replicat SQL statements

Gu .c
is le
• logdump utility

th ac
– Tool for viewing and analyzing Oracle GoldenGate trails

e or
• Trace and TLTrace parameters
us @
to san
– Debugging feature to detect bottlenecks
• Oracle GoldenGate Veridata
se ne

– High-speed solution to compare tables

en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 3

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Roadmap

• Knowledge documents
– Web-based
• Documentation
• ShowSyntax parameter

sa
• logdump utility

. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 4

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Knowledge Documents

• Go to My Oracle Support (http://support.oracle.com):

– New users must register for an account with a Customer
Support Identifier (Support ID) and must be approved by
their Customer User Administrator (CUA).

sa
• The customer portal enables you to search knowledge

. ) ha
documents about known issues:

ide om
– Enter GoldenGate as the product.

Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 5

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Roadmap

• Knowledge documents
• Documentation
– HTML
– PDF

sa
• ShowSyntax parameter

. ) ha
• logdump utility

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 6

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Oracle GoldenGate Documentation

Oracle GoldenGate:
• Installation and Setup Guides
• Windows and UNIX Administrator’s Guide

sa
• Windows and UNIX Reference Guide

. ) ha
• Windows and UNIX Troubleshooting and Tuning Guide
• Release Notes

ide om
• Error Messages Guide

Gu .c
is le
Download or view this documentation from the following

th ac
location:

e or
us @
http://www.oracle.com/technetwork/middleware/goldengate/doc
to san
umentation/index.html
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

• Oracle GoldenGate Installation and Setup Guides: Provide an installation guide and
ns AN

setup guide for each database that is supported by Oracle GoldenGate. Each guide
tra S

includes database-specific configuration information.

n- NE

• Oracle GoldenGate Windows and UNIX Administrator’s Guide: Introduces Oracle

no GA

GoldenGate components and explains how to plan for, configure, and implement Oracle
GoldenGate on Windows and UNIX platforms
AR

• Oracle GoldenGate Windows and UNIX Reference Guide: Provides detailed

NK

information about Oracle GoldenGate parameters, commands, and functions for the
Windows and UNIX platforms
SA

• Oracle GoldenGate Windows and UNIX Troubleshooting and Tuning Guide:

Provides suggestions for improving the performance of Oracle GoldenGate in different
situations; also provides solutions to common problems
• Oracle GoldenGate for Windows and UNIX Error Messages Guide: Contains a list of
the OGG-0xxxxx message numbers, descriptions, causes, and suggested actions to
remedy problems.
Note: As a general rule, messages may appear as WARNING when, in fact, they cause
a process to abort.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 7

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

•
•
•
•
SA
NK
AR
no GA
Documentation

logdump utility
n- NE
tra S
ns AN
fe (s
Knowledge documents

ra a
ShowSyntax parameter

ble nk
lic ar.g
en a
se ne
Roadmap

to san
us @
e or
th ac
is le
Gu .c
Copyright © 2014, Oracle and/or its affiliates. All rights reserved.
ide om
. ) ha
sa

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 8

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

ShowSyntax Parameter: Overview

• With this parameter, Replicat displays SQL DML

statements before executing them.
• ShowSyntax helps you diagnose failed operations such
as the following:

sa
– The WHERE clause may be using a non-indexed column.

. ) ha
– A row may be locked by another process.

ide om
– There may be no value for the SET clause.

Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

When you use ShowSyntax for the first time, use it only with guidance from an Oracle
ns AN

support analyst. It is a debugging parameter and can cause unwanted results if it is used
tra S

improperly.
n- NE

• It requires manual intervention, so all automated processing of statements is

no GA

suspended.
• It slows down processing and can cause processing backups and latency.
AR

This parameter is recommended for use in a test environment; create duplicates of your
NK

groups and tables so you do not affect the production environment.

SA

Important: This parameter is valid only for Replicat from the OS prompt, and not from inside
GGSCI.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 9

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

ShowSyntax Parameter: Usage

• Parameters that must be used with ShowSyntax:

– NoDynSQL
– NoBinaryChars
Note: Each must be on a line by itself, before ShowSyntax.

sa
• Start Replicat from the command shell in the home

. ) ha
directory.

ide om
– Do not specify a report file. The output must go to screen.

Gu .c
is le
Shell> ./replicat paramfile dirprm/<replicat_name>.prm

th ac
• The first SQL statement is displayed with some prompts.

e or
• In Oracle GoldenGate 12c, ShowSyntax now works with
us @
dynamic SQL.
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Remove (comment out) ShowSyntax, NoBinaryChars, and NoDynSQL when finished.

ns AN

In releases prior to Oracle GoldenGate 12c, ShowSyntax required the use of other
tra S

parameters including NoBinaryChars and NoDynSQL.

n- NE

In Oracle GoldenGate 12c, by default, Replicat does not show LOB data or other data types
no GA

that are treated as a LOB by the database or by Oracle GoldenGate, whether or not the data
is bound in SQL. Examples include LOB, XML, and UDT data types. Instead, Replicat shows
AR

a data identifier (for example, <LOB data>). To display this type of data, specify the
NK

INCLUDELOB option of ShowSyntax. If the column data is not bound in a SQL statement,
Replicat does not show the data even when INCLUDELOB is used.
SA

NoBinaryChars is an undocumented parameter that causes Oracle GoldenGate to treat

binary data as a null-terminated string.
NoDynSQL causes Replicat to use literal SQL statements instead of dynamic SQL, as in the
following examples:
• Statement without NoDynSQL: UPDATE <table> …. WHERE ID = :B
• Statement with NoDynSQL: UPDATE <table>…WHERE ID = '1234'
Instead of using bind variables, NoDynSQL creates the statements each time.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 10

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

ShowSyntax Parameter: Output

**************************************************************
**
Run Time Messages
**************************************************************
**

sa
Opened trail file ./dirdat/aa000000 at 2014-02-09 13:38:35
MAP resolved (entry ODS.SCUSTMER):

. ) ha
MAP ODS.SCUSTMER, TARGET ODS.TCUSTMER, SQLEXEC (ID sel_tcust,
QUERY "SELECT city from ODS.TCUSTMER WHERE cust_code = 'ABC'",

ide om
NOPARAMS), colmap (cust_code = cust_code, name = name, city =

Gu .c
@getval (sel_tcust.city), state = state), REPERROR (1403,

is le
EXCEPTION), REPERROR (0001, EXCEPTION);

th ac
Using the following key columns for target table ODS.TCUSTMER:

e or
CUST_CODE.

us @
INSERT INTO "ODS"."TCUSTMER" ("CUST_CODE","NAME","STATE")
VALUES to san
('WILL','BG SOFTWARE CO.','WA')
se ne

Statement length: 101

(S)top display, (K)eep displaying (default):
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Prompts
ns AN

• K=Keep Displaying: This is the default. To execute the current statement and
tra S

display the next. Even though K is the default, you still have to type K to make it do
n- NE

something. Just pressing Enter is not enough.

no GA

• S=Stop Display: To resume normal processing and stop printing SQL statements to
screen
AR

In this example, the literal SQL statement that Replicat delivers to the target database is
NK

displayed. These statements can be used with an Oracle explain plan to determine if the
database will use indexes to access the data. Sometimes a full-table scan, that is, not using
SA

an index, can cause a performance lag.

Note: To know for sure if the lack of an index is a good thing or a bad thing, see one of the
following Oracle University courses:
• Oracle SQL Tuning for Developers (D73549GC10)
• Oracle Database 11g: SQL Tuning Workshop Ed 2 (D52163GC20)

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 11

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

•
•
•
•
SA
NK
AR
no GA
Documentation

logdump utility
n- NE
tra S
ns AN
fe (s
Knowledge documents

ra a
ShowSyntax parameter

ble nk
lic ar.g
en a
se ne
Roadmap

to san
us @
e or
th ac
is le
Gu .c
Copyright © 2014, Oracle and/or its affiliates. All rights reserved.
ide om
. ) ha
sa

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 12

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Overview

• With logdump , you can:

– Search for, filter, view, and save data that is stored in an
Oracle GoldenGate trail or extract file
– Save part of a trail to another trail file

sa
– Edit and reuse a history of numbered logdump command

. ) ha
lines

ide om
• Use logdump only if you need to view data in the Oracle
GoldenGate trail files.

Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Note: For detailed information about using logdump, see the Oracle GoldenGate Windows
ns AN

and UNIX Troubleshooting and Tuning Guide.

tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 13

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Record Components

Header area: Contains transaction information (The data

area is below the header.)

Operation type

sa
and the time

. ) ha
that the record
was written

ide om
Source table

Gu .c
is le
Image type:

th ac
Can be a before or

e or
after image

us @
Record data
Column to san Record data (in ASCII)
information (in hex)
se ne

Length of record and its RBA

position in the trail file
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Oracle GoldenGate trail files are unstructured. The Oracle GoldenGate record header
ns AN

provides metadata of the data contained in the record and includes the following information:
tra S

• Operation type (such as an insert, update, or delete)

n- NE

• Before or after indicator for updates

no GA

• Transaction information (such as the transaction group and commit time stamp)
AR

The data area of the Oracle GoldenGate record contains the following:
• Time that the change was written to the GoldenGate file
NK

• Type of database operation

SA

• Length of the record

• Relative byte address in the GoldenGate file
• Table name
• Change data in hex and ASCII format
If before images are configured to be captured (for example, to enable a procedure to
compare before values in the WHERE clause), a before image also appears in the record.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 14

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Header Fields

• Hdr-Ind
– Should always be E, indicating that the record was created
by Extract. Any other value indicates invalid data.
• UndoFlag

sa
– (NonStop) This is set when extracting aborted transactions

. ) ha
from the TMF trail.

ide om
• RecLength

Gu .c
– The length (in bytes) of the record buffer

is le
th ac
• IOType

e or
– The type of operation represented by the record. The most

us @
common types are 3 (delete), 5 (insert), 10 (update), 15
to san
(compressed update), and 116 (LOB).
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Hdr-Ind
ns AN

This should always be a value of E, indicating that the record was created by the Extract
tra S

process. Any other value indicates invalid data.

n- NE

UndoFlag
no GA

Normally, UndoFlag is set to 0. But if the record is the backout of a previously successful
operation, UndoFlag is set to 1. An undo that is performed by the disc process because of a
AR

constraint violation is not marked as an undo.

NK

RecLength
SA

This is always 28 KB. The data portion accommodates up to 24 KB of data (excluding LONG,
LOB, and UDT data), plus four for internal indicators. Extract abends when the length of the
data being written exceeds 24 KB. Update operations are most affected by this. In addition to
writing the after image of the updated columns to the record, GoldenGate also must write the
following for use in locating the target row:
• For updated rows that have a defined key, a substitute key defined with a KeyCols
clause, or a unique index, Extract sends the before image of the key or indexed
columns.
• For updated rows without a unique identifier, Extract sends the entire before image of
the row.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 15

 The combined size of a before image (or key/index image) and the after image cannot exceed
24 KB.
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

The 24 KB limit does not include the full size of VARCHAR2 and LOB/LONG/XML columns. It
includes only a specific number of bytes. GoldenGate stores a database change record in two
segments in the trail file: the base segment and the LOB segment. The base segment stores
all of the basic data types (such as CHAR, NUMBER, DATE, and so on) and reserves space
for the following types (if any of these columns exist):
• The first 200 bytes of each VARCHAR2
• The first 8000 bytes of each BLOB/LONG RAW
• The first 4000 bytes of each XML/CLOB/LONG

sa
The LOB segment stores the rest of a VARCHAR2 or LOB/LONG/XML column―namely, the

. ) ha
part that could not fit into the base segment. As many LOB segments as are needed are
created in 2000-byte chunks that follow the base segment in the trail. (Exception: If a

ide om
VARCHAR2 is part of the primary key, the whole VARCHAR2 is stored in the base segment,
regardless of its size.)

Gu .c
is le
It is the base segment that has the size limitation of 24 KB. To prevent data from exceeding

th ac
that size, GoldenGate sums the defined length of each column in a table (excluding any

e or
VARCHAR2 or LOB/LONG/XML), the assumption being that at least some rows will reach the

us @
defined lengths. That sum is reduced by the fixed amount of space reserved for VARCHAR2s
to san
(200 bytes each), BLOB/LONG RAWs (8000 bytes each), and XML/CLOB/LONGs (4000
bytes each). An additional 2 bytes per column are allocated to internal GoldenGate identifiers.
se ne

Note: The preceding information is from Technical Services ticket 4426.

en a
lic ar.g

IOType
For a list of record types, see the Logdump chapter of the Oracle GoldenGate Windows and
ble nk

UNIX Reference Guide, or issue the Show RecType logdump command.

ra a

Note: this IOT is not to be confused with database index-organized tables (IOT).
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 16

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Header Fields

• TransInd
– The position of the record in the current transaction, with the
following values:
— 0: The first record in the transaction

sa
— 1: Neither the first record nor the last record in the transaction

. ) ha
— 2: The last record in the transaction
3: The only record in the transaction

ide om
—

• SysKeyLen

Gu .c
is le
– (NonStop) The length of the system key (4 bytes or 8 bytes)

th ac
if the source is a NonStop file and has a system key

e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 17

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Header Fields

• AuditRBA
– For Oracle, this is the sequence number of the data source
(redo log).
• Continued

sa
– For Windows and UNIX, this identifies a BLOB segment.

. ) ha
– BLOBs that are too large to fit within one record are stored

ide om
across multiple records.

Gu .c
– Y = BLOB segment; N = not a BLOB segment

is le
•

th ac
Partition

e or
– This depends on the record type.

us @
– For NonStop BulkIO records, this indicates the number of the
to san
source partition where the bulk operation was performed.
se ne

– For nonbulk operations, the partition is either 0 or 4.

en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

AuditRBA
ns AN

For some data sources, such as NonStop, this is the relative byte address of the commit
tra S

record. In this case, all records in a transaction will have the same relative byte address. The
n- NE

sum of IO Time + AuditRBA uniquely identifies data for that transaction.

no GA

Partition
AR

Partition tells GoldenGate the NonStop source partition to which the data was originally
written. Replicat uses the Partition field to determine the name of the target partition. The
NK

file name in the record header is always the name of the primary partition. Valid values for
BulkIO records are 0 through 15. For nonbulk operations, the partition can be either 0 or 4,
SA

with 4 indicating that the data is in FieldComp format.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 18

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Header Fields

• BeforeAfter
– BeforeAfter identifies whether the record is a before (B)
or after (A) image of an update operation.
– Inserts are always after images; deletes are always before

sa
images.

. ) ha
• IO Time

ide om
– Time stamp of the commit record

Gu .c
– All records in a transaction have the same commit time

is le
stamp.

th ac
•

e or
OrigNode

us @
– (NonStop) Node number of the system where the data was
to san
extracted
se ne

– Other database records have 0 here.

en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

BeforeAfter
ns AN

If the primary key is part of the update, both a before image and an after image are saved.
tra S

IOType is 115 (primary key update).

n- NE

IO Time
no GA

The time stamp uses local system time (based on GMT). If the transaction comes in over
AR

TCP/IP, the Server Collector checks the time; if the time differs from the local CPU clock, the
Server Collector makes an adjustment. This adjustment can be suppressed by using
NK

NoTCPSourceTimer.
SA

OrigNode
Each system in a NonStop cluster has a unique node number. Node numbers can range from
0 through 255. For records other than NonStop in origin, OrigNode is 0.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 19

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Utility: Header Fields

• FormatType
– Identifies whether the data was read from the transaction log or
fetched from the database:
— F: Fetched from database

sa
— R: Readable in transaction log

. ) ha
• Incomplete
– Is no longer used

ide om
• AuditPos

Gu .c
– Identifies the position of the Extract process in the transaction log

is le
th ac
– For an Oracle database, this is the relative byte address in the

e or
redo log.

us @
• RecCount to san
– When Windows and UNIX LOB data is divided into 2 KB chunks
se ne

to be written to the GoldenGate file, RecCount is used to

en a

reassemble the chunks.

lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

When you use the “Extract to File” initial load method from an Oracle database with
ns AN

SOURCEISTABLE and either EXTFILE or RMTFILE, the FormatType shows R rather than
tra S

F.
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 20

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Open

To open a trail file:

1. Determine the trail file to view (usually shown in the error
message).
2. Run the logdump program from the Oracle GoldenGate

sa
home directory.

. ) ha
3. Open the file:

ide om
Syntax:

Gu .c
is le
Logdump > Open <file_name>

th ac
Example:

e or
us @
Logdump > Open /home/ggs/dirdat/rt000000
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 21

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump

To set up the view:

• View record header with the data.
Logdump > GHdr On

sa
• Add column information.

. ) ha
Logdump > Detail On
• Add hex and ASCII data values to the column list.

ide om
Gu .c
Logdump > Detail Data

is le
• Control how much record data is displayed.

th ac
e or
Logdump > RecLen 280

us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Detail Data
ns AN

Including column data can add significantly to the size of the displayed record if the table has
tra S

many columns.
n- NE

RecLen
no GA

Use RecLen to control how much of the record data is displayed. You can use RecLen to
AR

control the amount of scrolling that must be done when records are large, while still showing
enough data to evaluate the record. Data beyond the specified length is truncated.
NK

UserToken
SA

You can also choose to view user tokens. By default, the name of the token and its length are
displayed. Use the UserToken Detail option to show the actual token data.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 22

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: ScanFor

To go to the first record and to move from one record to

another in sequence:

Logdump > Pos 0

sa
Logdump > Next (or just enter N)

. ) ha
To position at an approximate starting point and locate the next

ide om
good header record:

Gu .c
is le
th ac
Logdump > Pos <approximate_location>

e or
Logdump > ScanForHeader (or just enter sfh)

us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Results from ScanForHeader

ns AN

Hdr-Ind : E (x45) Partition : . (x00)

tra S

UndoFlag : . (x00) BeforeAfter: A (x41)

n- NE

RecLength : 66 (x0042) IO Time : 2011/02/10 17:46:09.181

no GA

IOType : 5 (x05) OrigNode : 108 (x6c)

TransInd : . (x00) FormatType : F (x46)
AR

SyskeyLen : 0 (x00) Incomplete : . (x00)

NK

AuditRBA : 126445880 AuditPos : 0

SA

2014/02/10 17:46:09.181 Insert Len 66 Log RBA 0

Name: TCUSTORD
After Image: Partition 0
5749 4C4C 3139 3934 2D30 392D | WILL1994-09-30:15:33
3A30 3043 4152 2020 2020 2020 | :00CAR ........
0000 3031 3735 3230 3030 0000 | ..01752000..000003..
0000 0000 0064 | .....d

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 23

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: ScanFor

To scan for the end of a transaction:

Logdump > ScanForEndTransaction Last operation in

Hdr-Ind : E (x45) Partition : . (x00) the transaction

sa
UndoFlag : . (x00) BeforeAfter: A (x41)
RecLength : 66 (x0042) IO Time : 2014/02/10 17:46:09.181

. ) ha
IOType : 5 (x05) OrigNode : 108 (x6c)
TransInd : . (x02) FormatType : F (x46)

ide om
SyskeyLen : 0 (x00) Incomplete : . (x00)

Gu .c
AuditRBA : 126445880 AuditPos : 0

is le
th ac
2014/02/10 17:46:09.181 Insert Len 66 Log RBA 0

e or
Name: TCUSTORD

us @
After Image: Partition 0
5749 4C4C 3139 3934 2D30 392D | to san WILL1994-09-30:15:33
3A30 3043 4152 2020 2020 2020 | :00CAR ........
se ne

0000 3031 3735 3230 3030 0000 | ..01752000..000003..

0000 0000 0064 | .....d
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

ScanForEndTransaction
ns AN

Use ScanForEndTransaction (or sfet) to scan for a record in an Oracle GoldenGate trail
tra S

with a transaction indicator (TransInd) of x02. Other indicators can be the following:
n- NE

• X00: First statement in the transaction

no GA

• x01: Statement in the middle of the transaction

AR

• x02: Last statement in the transaction

When an x02 indicator is found, enter n again; logdump displays the first record of the next
NK

transaction. You can also find the beginning of the next transaction by using the
SA

ScanForNextTrans command.
TransInd
Examining TransInd can help you determine if records are corrupted. For example, if you
see an x02 end-of-transaction record, and if the next record is either x01 or x02, there is a
record missing from the transaction (the first operation was lost). This indicates that the trail
was overwritten. You can determine whether this is true by looking at the IO Time field to
see if there are unusual time differences (maybe the next record is older than the previous
one rather than newer). Also, the AuditPos and AuditRBA in the next record could reflect
an unexpected result (perhaps an earlier position in the file instead of the expected later
position).

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 24

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Filter

To filter on a table name:

Logdump > Filter Include Filename HR.SALES
Logdump > Filter Match All
Logdump > N
_________________________________________________________________

sa
Hdr-Ind : E (x45) Partition : . (x00)

. ) ha
UndoFlag : . (x00) BeforeAfter: A (x41)
RecLength : 56 (x0038) IO Time : 2014/01/30 15:56:40.814

ide om
IOType : 5 (x05) OrigNode : 108 (x6c)
TransInd : . (x01) FormatType : F (x46)

Gu .c
SyskeyLen : 0 (x00) Incomplete : . (x00)

is le
AuditRBA : 105974056

th ac
e or
2014/02/03 15:56:40.814 Insert Len 56 Log RBA 1230

us @
Name: HR.SALES Partition 0
After Image:
to san
3220 2020 4A61 6D65 7320 2020 2020 4A6F 686E 736F | 2 James Johnso
6E20 2020 2020 2020 2020 2020 2020 4368 6F75 6472 | n Choudr
se ne

616E 7420 2020 2020 2020 2020 2020 4C41 | LA

en a

Filtering suppressed 18 records

lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Filter is case sensitive. Enter table names as they appear in the source database. They will
ns AN

appear in the trail record in the same case in which they appear in the database. If the source
tra S

database is not case sensitive, names are converted by Oracle GoldenGate to uppercase
n- NE

before writing them to the trail, and you then use uppercase in your filter specification.
no GA

• Match All: Is required only if there are multiple filter criteria and you want the filter to
match all of them
AR

• Match Any: Applies the filter if the criteria match any of the multiple filters
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 25

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Hex

To locate a hex data value:

Logdump > Filter Inc Hex /68656C20/
Logdump > Pos 0
Logdump > N
_________________________________________________________________

sa
Hdr-Ind : E (x45) Partition : . (x00)

. ) ha
UndoFlag : . (x00) BeforeAfter: B (x42)
RecLength : 56 (x0038) IO Time : 2014/01/30 16:22:14.205
IOType : 3 (x03) OrigNode : 108 (x6c)

ide om
TransInd : . (x01) FormatType : F (x46)
SyskeyLen : 0 (x00) Incomplete : . (x00) If more data was

Gu .c
AuditRBA : 109406324 showing, you could

is le
Found hex string see ASCII values.

th ac
2014/01/30 16:22:14.205 Delete Len 56 Log RBA 64424

e or
File: TCUSTMER Partition 0

us @
Before Image:
to san
3620 2020 4A61 6D65 7320 2020 2020 4A6F 686E 736F
6E20 2020 2020 2020 2020 2020 2020 4574 6865 6C20
| 6 James Johnso
| n Ethel
2020 2020 2020 2020 2020 2020 2020 4C41 | LA
se ne

Filtering suppressed 545 records Shows number of records

en a

suppressed by filtering
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Filter provides many options. For a complete reference, see the logdump documentation
ns AN

in the Oracle GoldenGate documentation set.

tra S

Use the RecLen command to specify the amount of data that is displayed.
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 26

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Position

To position (go to) a specific RBA in the file:

Logdump > Pos 1148
Current position set to RBA 1148
Logdump > N

sa
. ) ha
(Displays the record located at that RBA)

ide om
To go to the first record in the file:

Gu .c
is le
th ac
Logdump > Pos First

e or
Current position set to RBA 0

us @
Logdump > N
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

The position of each record is noted in the record header in the AuditPos field.
ns AN

When there is an error, the RBA is usually listed in the message.

tra S
n- NE

Note: There is also a logdump command named ScanForRBA, which searches based on
the transaction RBA. This is not the command to use when searching for an RBA in the trail.
no GA

Instead, use the Pos command to get to an RBA in a trail file.

AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 27

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Count

To count the records in a trail file:

Logdump > Count

LogTrail /ggs/dirdat/rt000000 has 4828 records

sa
Total Data Bytes 334802

. ) ha
Avg Bytes/Record 69
Delete 900

ide om
Insert 3902

Gu .c
FieldComp 26

is le
Before Images 900

th ac
After Images 3928

e or
us @
Average of 25 Transactions to san
Bytes/Trans ..... 22661
se ne

Records/Trans ... 193

Files/Trans ..... 8
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Without options, the Count display shows the following:

ns AN

• The RBA where the count began

tra S
n- NE

• Number of records in the file as of the RBA where the count began
• Total number of data bytes and average number of bytes per record
no GA

• Information about the operation types

AR

• Information about the transactions

NK

With options, you can view count information for each table and specify how the count is
generated:
SA

• Detail: Produces a summary count plus a count for each table or file that was
processed by Extract. The information includes the total and average numbers of data
bytes, as well as information about the operations on the table.
• START[TIME] <time_string>: Begins the count with the first record written at the
specified time
• END[TIME] <time_string>: Stops the count with the last record written at the
specified time

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 28

 • INT[ERVAL] <minutes>: Displays statistics for total bytes, average bytes, and the
number of each type of operation that occurred within a specified interval of time (in
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

minutes), and then displays the totals for those statistics

• LOG <wildcard>: Produces a count for multiple trail or extract files that are specified
with a wildcard character (*)
• FILE <specification>: Specifies the count to be generated for the specified table
or group of tables designated with a wildcard character (*)

sa
. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 29

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Count

To count the records in a trail file (continued):

:
(Continued)

sa
:
TCUSTMER

. ) ha
Total Data Bytes 105624
Avg Bytes/Record 55

ide om
Delete 300

Gu .c
Insert 1578

is le
FieldComp 12

th ac
Before Images 300

e or
After Images 1590

us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Reasons to use Count to obtain statistics:

ns AN

• The statistics in GGSCI show statistics from the process startup. They are reset if
tra S

restarted.
n- NE

• You can determine the most heavily updated tables.

no GA

• You can go back in time to old trails.

AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 30

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Count

To count the records in a trail file (continued):

TCUSTORD
Total Data Bytes 229178

sa
Avg Bytes/Record 78
Delete 600

. ) ha
Insert 2324
FieldComp 14

ide om
Before Images 600

Gu .c
After Images 233

is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Because Count did not filter on table, each table’s count is shown.
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 31

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Save

To save some or all records to a new trail file:

Logdump > Save /home/oracle/save/sv000005 10 records

or …

sa
Logdump > Save /home/oracle/save/sv000005

. ) ha
ide om
Gu .c
is le
th ac
e or
us @
To close the current file and open the next file in the trail:
to san
se ne

Logdump > NextTrail

en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Saving Records
ns AN

Use Save to write a subset of the records to a new trail or Extract file.
tra S
n- NE

• By saving a subset to a new file, you can work with a smaller file that is easier to debug.
• Saving to another file also enables you to extract valid records that can be processed by
no GA

GoldenGate, while excluding records that may be causing errors.

AR

To set the version of the trail or file (to an old or a new format), use the TrailFormat
command. Note: Including the ! symbol (exclamation point) overwrites an existing file of the
NK

same name.
SA

• <n> records | <n> bytes: Specifies either a number of records or a number of

data bytes to write to the new file. This is taken forward from the current position in the
file.
• NoComment: Suppresses the leading and trailing comment records that are usually
placed by Logdump in the new file.
• OldFormat | NewFormat: Writes the data in either the current trail format
(NewFormat, which is the default) or the format that was used for GoldenGate versions
6.0 and earlier (OldFormat)

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 32

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Environment

To see the current logdump environment:

Logdump > Env

sa
Shows features that are enabled (such as filter and header

. ) ha
views) and environment information (such as current trail and
position)

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Sample env Output

ns AN

Current Volume: /home/ggs

tra S
n- NE

LogTrail: /home/ggs/dirdat/rt000000
Trail Format: New
no GA

End of File: 33876

AR

Current Position: 428

NK

Next Position: 535

SA

Last Modtime: 2014/02/25 08:14:26.000.000

Display RecLen: 140
Logtrail Filter: On
Show Ghdr: On
Detail: Data

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 33

 HeaderToken: On
UserToken: On
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Trans History: 3 Transactions, Records 100, Bytes 100000

LargeBlock I/O: On, Blocksize 57344
Local System: BigEndian
Logtrail Data: BigEndian/ASCII
Logtrail Header: ASCII
Dump: ASCII
Timeoffset: LOCAL

sa
Scan Notify Interval: 10000 records, Scrolling On

. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 34

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Using logdump: Logging

To keep a log of your session:

Logdump > log to MySession.txt
To stop logging:

sa
Logdump > log stop

. ) ha
To write text to the log:
Logdump > writelog "Customer name is ABC Company"

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 35

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Getting logdump Help and Exiting

To get help:
Logdump > Help

Note: logdump utility information is available in the

sa
Oracle GoldenGate Troubleshooting and Tuning Guide.

. ) ha
To exit logdump, use either of the following:

ide om
Gu .c
Logdump > Exit

is le
th ac
e or
Logdump > Quit

us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

logdump Help: Sample

ns AN

The following is an excerpt from the help output:

tra S
n- NE

FC [<num> | <string>] - Edit previous command

HISTORY - List previous commands
no GA

OPEN | FROM <filename> - Open a Log file

AR

RECORD | REC - Display audit record

NK

NEXT [ <count> ] - Display next data record

SKIP [ <count> ] - Skip down <count> records
SA

COUNT - Count the records in the file

[START[time] <timestr>,]
[END[time] <timestr>,]
[INT[erval] <minutes>,]
[LOG[trail] <wildcard-template>,]
[FILE <wildcard-template>,]
[DETAIL <timestr> format is [yy]yy-mm-dd] [hh[:mm][:ss]] ]

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 36

 POSITION [ <rba> | FIRST ] - Set position in file
RecLEN [ <size> ] - Sets max output length
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

EXIT | QUIT - Exit the program

FILES | FI | DIR - Display filenames
ENV - Show current settings

sa
. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 37

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Other Useful logdump Commands

• CD | Volume
• Decrypt On|Off
• ScanForRBA (sfr)
•

sa
ScanForTime (sfts)

. ) ha
• ScanForType (sft)
•

ide om
Skip
•

Gu .c
Time

is le
• TimeOffset

th ac
e or
• X

us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

• CD | Volume: Sets the default folder, directory, or saved volume

ns AN

• Decrypt: Decrypts an encrypted trail

tra S

• ScanForRBA (sfr): Scans for the record at a relative byte address specified by the
n- NE

AuditRBA field of the record header

no GA

• ScanForTime (sfts): Scans for a record that contains a specific time stamp. The
time stamp is contained in the IO Time field of the record header.
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 38

 • ScanForType (sft): Scans for the next record of the specified type
• Skip: Skips a specified number of records
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

• Time: Displays the current time in local and GMT formats

• TimeOffset: Sets the logdump time format (local, GMT, or a GMT offset)
• X: Executes a shell command and then returns to the logdump prompt

sa
. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 39

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Other Useful logdump Commands

To find tables that have long-running transactions, heavy

volume, LOB data, or other transactions that interrupt normal
processing:
• Use the TransHist command to set the size of the table

sa
in bytes (200 max).

. ) ha
• Use either TransRecLimit or TransByteLimit to set a

ide om
lower boundary for what is considered a normal-sized

Gu .c
transaction.

is le
th ac
• Use the Count command to display statistics about

e or
transaction size.
us @
to san
• Use the logdump Position <RBA> command to go to
each RBA listed in the Count output. This gives you the
se ne

name of the table that generated the transaction.

en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Using TransHist
ns AN

Transactions are tracked in descending order (according to the total number of bytes) to help
tra S

you do the following:

n- NE

• Determine whether the environment generates large transactions.

no GA

• Identify the relative size of those transactions.

AR

When the history table is full, the smallest transaction is removed to enable a larger
transaction to be added to the list.
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 40

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Other Useful logdump Commands

Use the Count command to view statistics that are tracked

with TransHist.
• The output appears at the end of the Count statistics.
• Transaction size information is reported when logdump

sa
finishes scanning the files:

. ) ha
Transactions with at least 100 records or 100000 bytes
2014/02/01 09:31:24.000.000 00:00:00.000, Seq 0, RBA 13101

ide om
Bytes/Trans ..... 1168167
Records/Trans ... 1001

Gu .c
Files/Trans ..... 1
2014/02/01 09:31:35.000.000 00:00:11.000, Seq 0, RBA 1205292

is le
Bytes/Trans ..... 1168167

th ac
Records/Trans ... 1001

e or
Files/Trans ..... 1
2014/02/01 09:31:41.000.000 00:00:06.000, Seq 0, RBA 2397483

us @
Bytes/Trans ..... 1168167
Records/Trans ... 1001
Files/Trans ..... 1
to san
2014/02/01 09:42:36.000.000 00:10:55.000, Seq 0, RBA 3589674
se ne

Bytes/Trans ..... 373736

Records/Trans ... 3014
en a
lic ar.g

Files/Trans ..... 1S
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

In the screenshot, the first line (Transactions with at least 100 records or
ns AN

100000 bytes) indicates that the size boundary was set to the default of 100 operations or
tra S

100 KB. The defaults can be changed with the TransByteLimit and TransRecLimit
n- NE

parameters.
no GA

TransRecLimit and TransByteLimit prevent normal-sized transactions from being

tracked in the transaction table specified with the TransHist command. Setting a boundary
AR

reduces the amount of data that is stored and, consequently, the amount of data that must be
reviewed when troubleshooting.
NK

• TransRecLimit <n>: Sets a lower boundary for the number of records in a

SA

transaction. It should be set to represent a normal-sized transaction for the environment

that is being evaluated with logdump.
• TransByteLimit <n>: Sets a lower boundary for the number of bytes in a
transaction. It should be set to represent a normal-sized transaction for the environment
that is being evaluated with logdump.

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 41

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

logdump Filtering

Filter capabilities include:

FILTER INCLUDE | EXCLUDE] <options>
<options> are
RecTYPE <type number | type name>

sa
STRING [BOTH] /<text>/ [<column range>]
HEX <hex string> [<column range>]

. ) ha
TransID <transaction identifier>
FILENAME <filename template>

ide om
STARTTIME <date-time string>

Gu .c
ENDTIME <date-time string>

is le
TransIND [<comparison>] <nn>

th ac
RecLEN [<comparison>] <nn>

e or
AUDITRBA [<comparison>] <nnnnnnnn>

us @
<column range> is <start column>:<end column> e.g.
to san
0:231
se ne

<comparison> is one of =, ==, !=, <>, <, >, <=, >= EQ,
en a

GT, LE, GE, LE, NE

lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Adding a filter to your search criteria is one of the best features of logdump. Here are some
ns AN

additional filter options:

tra S

FILTER SHOW
n- NE

FILTER ENABLE | ON - Enable filtering

no GA

FILTER DISABLE | OFF - Disable filtering

AR

FILTER CLEAR [ <filterid> | <ALL> ]

FILTER MATCH ANY | ALL
NK

FILTER [INClude | EXCLude] <options>

SA

<options> are
RecTYPE <type number | type name>
STRING [BOTH] /<text>/ [<column range>]
HEX <hex string> [<column range>]
TransID <TMF transaction identifier>
FILENAME <filename template>
PROCESS <processname template>

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 42

 INT16 <16-bit integer>
INT32 <32-bit integer>
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

INT64 <64-bit integer>

STARTTIME <date-time string>
ENDTIME <date-time string>
SYSKEY [<comparison>] <32/64-bit syskey>
TransIND [<comparison>] <nn>
UNDOFLAG [<comparison>] <nn>
RecLEN [<comparison>] <nn>
AUDITRBA [<comparison>] <nnnnnnnn>

sa
ANSINAME <ansi table name>
<filterid>

. ) ha
RecTYPE,STRING,HEX,TransID,FILENAME,PROCESS,INT16,
INT32,INT64,RBA,STARTTIME,ENDTIME

ide om
TransIND, UNDOFLAG, RecLEN, AUDITRBA, ANSINAME

Gu .c
<column range>

is le
<start column>:<end column> e.g. 0:231

th ac
<comparison>

e or
=, ==, !=, <>, <, >, <=, >= EQ, GT, LE, GE, LE, NE

us @
X <program> [string] - Execute <program>
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 43

 TransHist nnnn - Set size of transaction history
TransRecLimit nnnn - Set low record count threshold
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

TransByteLimit nnnn - Set low byte count threshold

LOG {STOP} | { [TO] <filename> } - Write a session log
BEGIN <date-time> - Set next read position using a time stamp
SAVE <savefilename> [!] <options> - Write data to a savefile
<options> are:
nnn RECORDS | nnn BYTES
[NOCOMMENT] - suppress the header/trailer recs

sa
[OLDFORMAT] - force oldformat records

. ) ha
[NEWFORMAT] - force newformat records
[EXT ( <pri>, <sec> [,<max>])] - Savefile Extent sizes on NSK

ide om
[MEGabytes <nnnn>] - For extent size calculation

Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 44

 USERTOKEN OFF | on | detail - show user token info
HEADERTOKEN OFF| on | detail - show header token info
Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

GGSTOKEN OFF | on | detail - show GGS token info

ASCIIHEADER ON | off - toggle header charset
EBCDICHEADER on| OFF - toggle header charset
ASCIIDATA ON | on - toggle user data charset
EBCDICDATA on | OFF - toggle user data charset
ASCIIDUMP ON | off - toggle charset for hex/ascii display
EBCDICDUMP on | OFF - toggle charset for hex/ascii display

sa
TRAILFORMAT old| new - force trail type

. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk
ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 45

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Quiz

What should you do if you want to have SQL DML statements

displayed before executing them?
a. Enable the ShowSyntax parameter.
b. Execute the ScanForRBA command.

sa
c. Execute the Detail On command.

. ) ha
d. None of the above

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s

Answer: a
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 46

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Practice 3 Overview:
Examining the Evidence
The practices in this lesson cover the use of the following:
• ShowSyntax
• logdump

sa
. ) ha
ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 47

Unauthorized reproduction or distribution prohibited. Copyright© 2022, Oracle University and/or its affiliates.

Summary

In this lesson, you should have learned how to use the

following Oracle GoldenGate troubleshooting tools:
• Knowledge documents

sa
• Documentation

. ) ha
• ShowSyntax parameter
• Logdump utility

ide om
Gu .c
is le
th ac
e or
us @
to san
se ne
en a
lic ar.g
ble nk

Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

ra a
fe (s
ns AN
tra S
n- NE
no GA
AR
NK
SA

Oracle GoldenGate 12c: Troubleshooting and Tuning 3 - 48