3.1 Collector Parameters
Most Collector parameters are entered in the Extract parameter file, using the PARAMS
collector_params
option of the RMTHOST
parameter. The Manager automatically sends some of these parameters when it starts the Collector, such as -k and ENCRYPT
key and KEYNAME
options entered by the user.
The Collector parameters discussed here are for a Collector running on a remote NonStop system.
-
-
PROCESS
process_name
-
The name of the NonStop TCP/IP process.
-
-BULKIO
-
Results in Collector writing data in 28K blocks, rather than 4K. Setting
-BULKIO
can increase total throughput of the Collector and reduce overhead significantly. -
-BULKIOLEN
-
Use
BULKIOLEN
to customize the block size Collector should use when writing data. Increasing the block size used by Collector can contribute a net performance gain by increasing total throughput. Block sizes may be indicated in bytes or kilobytes, but the Collector only recognize sizes that are multiples of 2. If you choose a block size between 2 and the next multiple,BULKIOLEN
automatically rounds your specification down. -
-
b
backup_cpu
-
Runs the Collector backup process started in
backup_cpu
. This option is only for static servers. It is not valid for dynamic servers, which are persistent processes that will be restarted if the process has a failure. -
-B
-
-DEBUG
-
Starts the Collector in
DEBUG
mode to allow the user to analyze the actions of the program code. -
-EMSEMPHASIS
type
-
Controls whether or not emphasis will be turned on for certain types of messages coming from EMSCLNT on open systems.
type
can be one of the following:-
CRITICAL
-
Turns emphasis on for
CRITICAL
orWARNING
messages as well asFATAL
messages. -
FATAL
orERROR
-
Turns emphasis on only for
FATAL
messages.
The default is
CRITICAL.
-
-
-
ENCRYPT
encrypt_type
-
The type of encryption being passed from the Extract process, as specified with the
RMTHOST
parameter in the Extract parameter file.Valid values:
-
GGS
(Deprecated) -
BLOWFISH
AES
If using either
AES
orBLOWFISH
, specify the -KEYNAME
option. For more information about Oracle GoldenGate security, see Using Encryption. -
-
-f
-
Always forces file writes to be flushed to disk before returning a success status to the Extract process.
By default, the file system buffers the I/O because it is more efficient than flushing to disk with every operation. Generally, the performance benefits outweigh the small risk that data could be lost if the system fails after an I/O is confirmed successful, but before the buffer actually is flushed to disk. Use
-f
if this risk is unacceptable, with the understanding that it can compromise the performance of Oracle GoldenGate. -
-
HOMETERM
terminal
-
Identifies the home terminal for the Collector.
-
-k
-
Directs Collector to terminate when the Extract process that it is serving disconnects. This option is used by the Manager process when starting the Collector process.
-
-
KEYNAME
name
-
Specifies a key name defined in the local
ENCKEYS
lookup file.name
is the name of a key in a lookup file on the target system. For more information about Oracle GoldenGate security, see Using Encryption. -
-
l
file_name
-
Directs the Collector to log to
file_name
. The name should be fully qualified. -
-m
number
-
Specifies the maximum number of files to allocate.
-
-
NOFLUSHCACHE
|FLUSHCACHE
-
Turns on or off the flushing of the disk cache.
-
-p
port_number
-
A TCP/IP port number on which the Collector listens for connections from the Extract process. The default is port
7819
. -
-t
-
Turns on TCP tracing to write detail to EMS on socket operations. It is recommended that you use this parameter only when requested by Oracle GoldenGate Support.
-
-TCPSTATS
-
Specifies that TCP statistics should be printed at file rollover.
-
-v
-
Specifies that NonStop Collector processes use EMS logging.