DBOPTIONS
Valid For
Extract and Replicat
Description
Use the DBOPTIONS
parameter to specify database options. This is a
global parameter, applying to all TABLE
or MAP
statements in the parameter file. Some options for the DBOPTIONS
parameters apply only to Extract or Replicat.
The DBOPTIONS
parameter can be placed anywhere in the parameter file irrespective of other parameters.
Default
None
Syntax
DBOPTIONS
[ALLOWLOBDATATRUNCATE | NOALLOWLOBDATATRUNCATE]
[ALLOWUNUSEDCOLUMN | NOALLOWUNUSEDCOLUMN]
[ALLOWNONSTANDARDINTERVALDATA]
[BINDCHARFORBITASCHAR]
[CATALOGCONNECT | NOCATALOGCONNECT]
[CONNECTIONPORT port]
[DECRYPTPASSWORD shared_secret ENCRYPTKEY {DEFAULT | key_name}]
[DEFERREFCONST]
[DISABLECOMMITNOWAIT]
[DISABLELOBCACHING]
[ENABLE_INSTANTIATION_FILTERING]
[EMPTYLOBSTRING 'string']
[FETCHBATCHSIZE records
]
[FETCHCHECKFREQ seconds
]
[FETCHLOBS | NOFETCHLOBS]
[FETCHRETRYCOUNT number]
[FETCHTIMEOUT seconds | NOFECHTIMEOUT]
[FORCE_XML_ESCAPE_CONVERSION]
[HOST {DNS_name | IP_address}]
[INTEGRATEDPARAMS(parameter
[, ...])]
[LIMITROWS | NOLIMITROWS]
[LOBBUFSIZE bytes
]
[LOBWRITESIZE bytes]
[MAXLOBKEYLEN datalength]
[SESSIONPOOLMAX max_value
|
[SESSIONPOOLMIN min_value
][SESSIONPOOLINCR increment_value
]
[SETTAG [tag_value
| NULL] ]
[SHOWINFOMESSAGES]
[SHOWWARNINGS]
[SKIPTEMPLOB | NOSKIPTEMPLOB]
[SOURCE_DB_NAME src_dbase_global_name]
[SPTHREAD | NOSPTHREAD]
[SQLMODE]
[SUPPRESSTEMPORALUPDATES]
[SUPPRESSTRIGGERS | NOSUPPRESSTRIGGERS]
[TDSPACKETSIZE bytes]
[TRANSNAME trans_name][USEDATABASEENCODING]
[XMLBUFSIZE bytes]
-
ALLOWLOBDATATRUNCATE | NOALLOWLOBDATATRUNCATE
-
Valid for Replicat for Db2 LUW and MySQL.
ALLOWLOBDATATRUNCATE
prevents Replicat from abending when replicatedLOB
data is too large for a targetCHAR
,VARCHAR
,BINARY
orVARBINARY
column and is applicable to target LOB columns only. or replicat of Db2 LUW,ALLOWLOBDATATRUNCATE
prevents Replicat from abending when replicatedLOB
data is too large for a targetLOB
column. TheLOB
data is truncated to the maximum size of the target column without any further error messages or warnings.NOALLOWLOBDATATRUNCATE
is the default and causes Replicat to abend with an error message if the replicated LOB is too large.
-
ALLOWUNUSEDCOLUMN
|NOALLOWUNUSEDCOLUMN
-
Valid for Extract for Oracle. Controls whether Extract abends when it encounters a table with an unused column.
The default is
ALLOWUNUSEDCOLUMN
. When Extract encounters a table with an unused column, it continues processing and generates a warning.When using this parameter, either the same unused column must exist on the target or a source definitions file for the table must be specified to Replicat, so that the correct metadata mapping can be performed.NOALLOWUNUSEDCOLUMN
causes Extract to abend on unused columns.
-
ALLOWNONSTANDARDINTERVALDATA
-
Valid for PostgreSQL.
Use
DBOPTIONS ALLOWNONSTANDARDINTERVALDATA
in the Extract parameter file to capture the mixed sign interval data (or any other format of interval data, which is not supported by Oracle GoldenGate) as a string (not as standard interval data). When this option is used, the format of the interval data that gets written to the trail and gets applied into the targetCHAR
column is as follows:year-component-sign years-months days-component-sign days hour-component-sign hours:minutes:seconds.fractional_seconds
For example,
+1026-9 +0 +0:0:22.000000
should be interpreted as 1026 years 9 months 0 days 0 hours 0 minutes 22 seconds.-0-0 -0 -8
should be interpreted as 0 years 0 months 0 days -8 hours.+1-3 +0 +3:20
should be interpreted as 1 years 3 months 0 days 3 hours 20 minutes.In case of Replicat, if the source interval data was captured using
DBOPTIONS ALLOWNONSTANDARDINTERVALDATA
and written as a string to the trail, the corresponding source column is allowed to be mapped to either achar
or abinary
type column on the target.
-
BINDCHARFORBITASCHAR
-
Valid for DEFGEN, Extract, and Replicat for DB2 for i. Allows columns that are defined as
CHAR
orVARCHAR
with CCSID 65535, orCHAR
andVARCHAR FOR BIT DATA
to be treated as if the field had a normal translatable encoding. The encoding is picked up from the job CCSID. When this option is in effect, DEFGEN does not indicate that the field is binary in thedefs
file. -
CATALOGCONNECT | NOCATALOGCONNECT
-
Valid for Extract and Replicat for ODBC databases.
By default, Oracle GoldenGate creates a new connection for catalog queries, but you can use
NOCATALOGCONNECT
to prevent that. -
CONNECTIONPORT
port
-
Valid for Replicat for multi-daemon MySQL. Specifies the TCP/IP port of the instance to which Replicat must connect. The minimum value is 1 and the default value is 3306.
-
DEFERREFCONST
|NODEFERREFCONST
-
Valid for nonintegrated Replicat for Oracle. Default option for parallel integrated Replicat.
Sets constraints to
DEFERRABLE
to delay the checking and enforcement of cascade delete and cascade update referential integrity constraints by the Oracle target database until the Replicat transaction is committed. At that point, if there are constraint violations, an error is generated. Integrated Replicat does not require disabling of referential constraints on the target system.You can use
DEFERREFCONST
instead of disabling the constraints on the target tables or setting them toDEFERRED
. When used,DEFERREFCONST
defers bothDEFERABLE
andNOT DEFERABLE
constraints.DEFERREFCONST
applies to every transaction that is processed by Replicat.DEFERREFCONST
parameter works on Oracle 11.2.0.2 and up.If used with an Oracle Database release that does not support this functionality,
DEFERREFCONST
is ignored without returning a notification to the Oracle GoldenGate log. To handle errors on the commit operation, you can useREPERROR
at the root level of the parameter file and specify theTRANSDISCARD
orTRANSEXCEPTION
option.Note:
Do not to use withDEFERREFCONST
coordinated Replicat because there is no way to guarantee that related rows in parent and child tables are processed by same threadThe
DBOPTIONS DEFERREFCONST
parallel will only be added to the Replicat configuration when you setGOLDENGATESETTIGS_REPLICATIONMODE=PARALLEL_NON_INTEGRATED
in the response file (.rsp
).Use the
NODEFERREFCONST
option to disable theDEFERREFCONST
option. -
DISABLECOMMITNOWAIT
-
Valid for Replicat for Oracle.
Disables the use of asynchronous
COMMIT
by Replicat. An asynchronousCOMMIT
statement includes theNOWAIT
option.When
DISABLECOMMITNOWAIT
is used, Replicat issues a standard synchronousCOMMIT
(COMMIT
withWAIT
option). -
DISABLELOBCACHING
-
Valid for nonintegrated Replicat for Oracle.
Disables Oracle's LOB caching mechanism. By default, Replicat enables Oracle's LOB caching mechanism.
-
ENABLE_INSTANTIATION_FILTERING
-
Valid for Oracle.
Enables automatic per table instantiation CSN filtering on tables instantiated using the
SET_INSTANTIATION_CSN
command.SOURCE_DB_NAME
is mandatory if Oracle AQ (Advanced Queuing) objects are included in replication, and procedural replication is enabled. -
FETCHBATCHSIZE
records
-
Valid for Extract for Oracle, DB2 for i, DB2 z/OS, PostgreSQL, and SQL Server.
Enables array fetches for initial loads to improve performance, rather than one row at a time. It is used for Initial Load Extract.
Valid values for Oracle, DB2 for i, DB2 z/OS, and SQL Server are 0 through 1000000 records per fetch. Valid values for DB2 LUW are 1 through 1000000 records per fetch; zero (0) is not a valid value.
The default is 1000. Performance slows when batch size gets very small or very large. If the table contains LOB data, Extract reverts to single-row fetch mode, and then resumes batch fetch mode afterward.
-
FETCHCHECKFREQ
seconds
-
Valid for integrated Extract for Oracle.
Specifies the number of seconds that Extract waits between each fetch check for the ADG to catch up. A low number improves latency though increases the number of queries of
current_scn from v$database
. The default is 3 seconds; the maximum is 120 seconds. -
FETCHLOBS | NOFETCHLOBS
-
Valid for Extract for DB2 for z/OS and DB2 for LUW.
Suppresses the fetching of LOBs directly from the database table when the LOB options for the table are set to
NOT LOGGED
. WithNOT LOGGED
, the value for the column is not available in the transaction logs and can only be obtained from the table itself. By default, Oracle GoldenGate captures changes to LOBs from the transaction logs. The default isFETCHLOBS
. -
FETCHRETRYCOUNT
number
-
Valid for Extract for Oracle.
Specifies the number of times that Extract tries before it reports ADG progress or the reason for no progress when waiting for the ADG to catch up. This value is multiplied with
FETCHCHECKFREQ
to determine approximately how often the ADG progress is reported. The default value forFETCHRETRYCOUNT
is 5 and the valid range of values is 0 - 1000. -
FETCHTIMEOUT seconds
|NOFETCHTIMEOUT
-
Valid for Extract for Oracle.
Specifies the number of seconds that Extract will wait after which it will abend when ADG makes no progress. No progress can be because the MRP is not running or because it is not applying redo changes. When this occurs, the ADG database should be examined. The default is 30 seconds; valid values are 0 - 4294967295 (ub4 max value) seconds.
NOFETCHTIMEOUT
means never timeout (the same asFETCHTIMEOUT 0
) and seconds cannot be specified with it.
-
FORCE_XML_ESCAPE_CONVERSION
-
For trail fie formats of Oracle GoldenGate19c, if
FORCE_XML_ESCAPE_CONVERSION
is enabled, Replicat will escape the linefeed characters for the character types in theANYDATA
columns. If this parameter is enabled for a trail file with a format of19.1
or higher, it is ignored because Extract already performs the linefeed escape.This parameter only affects
ANYDATA
columns whenNOUSENATIVEOBJSUPPORT
is turned on for Extract.Note:
This parameter option doesn't affect
ANYDATA
columns retrieved from the database by Logminer in native mode. -
HOST
{DNS_name | IP_address}
-
Valid for Replicat for multi-daemon MySQL.
Specifies the DNS name or IP address of the system that hosts the instance to which Replicat must connect.
-
INTEGRATEDPARAMS(
parameter
[, ...])
-
Valid for Integrated Replicat for Oracle.
Passes settings for parameters that control the database inbound server within the target Oracle database.
You can use the
commit_serialization
option withINTEGRATEDPARAMS
for integrated Replicat but not for parallel Replicat in integrated mode. Setting internal database parameters for Extract is done usingTRANLOGOPTIONS INTEGRATEDPARAMS
.For more information about integrated Replicat and a list of supported inbound server parameters, see Additional Parameter Options for Integrated Replicat and Parallel Replicat in Integrated Mode in Oracle GoldenGate Microservices Documentation.
-
LIMITROWS | NOLIMITROWS
-
Valid for Replicat for MariaDB, MySQL, Oracle, SingleStore, SQL Server, Sybase, and TimesTen.
LIMITROWS
prevents multiple rows from being updated or deleted by the same Replicat SQL statement when the target table does not have a primary or unique key.LIMITROWS
is the default.LIMITROWS
andNOLIMITROWS
apply globally to allMAP
statements in a parameter file.For MySQL,
LIMITROWS
uses aLIMIT 1
clause in theUPDATE
orDELETE
statement.For Oracle targets,
LIMITROWS
(the default) must be used. It uses eitherWHERE
ROWNUM = 1
orAND ROWNUM = 1
in theWHERE
clause.For SQL Server,
LIMITROWS
uses aSET ROWCOUNT 1
clause before theUPDATE
orDELETE
statement.NOLIMITROWS
permits multiple rows to be updated or deleted by the same Replicat SQL statement. -
LOBBUFSIZE
bytes
-
Valid for Extract for Db2 LUW, Db2 for i, Db2 z/OS, Oracle, PostgreSQL, and SQL Server.
For Oracle, it determines the memory buffer size in bytes to allocate for each embedded LOB attribute that is in an Oracle object type.
For non-Oracle databases, it specifies the buffer size to fetch LOB data during initial load.
Valid values are from 1024 and 104857600 bytes. The default is 1048576 bytes.
For Oracle, if the length of embedded LOB exceeds the specified
LOBBUFSIZE
size, an error message similar to the following is generated:GGS ERROR ZZ-0L3 Buffer overflow, needed: 2048, allocated: 1024.
-
LOBWRITESIZE
bytes
-
Valid for nonintegrated Replicat for Oracle.
Specifies a fragment size in bytes for each LOB that Replicat writes to the target database. The LOB data is stored in a buffer until this size is reached. Because LOBs must be written to the database in fragments, writing in larger blocks prevents excessive I/O. The higher the value, the fewer I/O calls that are made by Replicat to the database server to write the whole LOB to the database.
Specify a multiple of the Oracle LOB fragment size. A given value will be rounded up to a multiple of the Oracle LOB fragment size, if necessary. The default LOB write size is 32k if
DBOPTIONS
NOSKIPTEMPLOB
is specified, or 1MB ifDBOPTIONS SKIPTEMPLOB
is specified. Valid values are from 2,048 bytes to 2,097,152 bytes (2MB).By default, Replicat enables Oracle's LOB caching mechanism. To disable Oracle's LOB caching, use the
DISABLELOBCACHING
option ofDBOPTIONS
. -
MAXLOBKEYLEN datalength
- Valid for Extract for PostgreSQL.
-
SESSIONPOOLMAX
max_value
-
Valid for Extract in integrated mode for Oracle.
Sets a maximum value for the number of sessions in the OCI Session Pool, which is used by Extract for fetching from a container database. The default value is 10 sessions. Must be specified before the
USERIDALIAS
parameter; otherwise will be ignored and the default will be used. -
SESSIONPOOLMIN
min_value
-
Valid for Extract in integrated mode for Oracle.
Sets a minimum value for the number of sessions in the OCI Session Pool, which is used by Extract for fetching from a container database. The default value is 2 sessions. Must be specified before the
USERIDALIAS
parameter; otherwise will be ignored and the default will be used. -
SESSIONPOOLINCR
increment_value
-
Valid for Extract in integrated mode for Oracle.
Sets a value for the number of incremental sessions that can be added to the OCI Session Pool, which is used by Extract for fetching from a container database. The default value is 2 sessions. Must be specified before the
USERIDALIAS
parameter; otherwise will be ignored and the default will be used. -
SETTAG [
tag_value
| NULL
-
Valid for Replicat for Oracle.
Sets the value for an Oracle redo tag that will be used to identify the transactions of the associated Replicat in the redo log. A redo tag can also be used to identify transactions other than those of Replicat. This parameter is recommended over
EXCLUDEUSER
andTRACETABLE
.Use this option to prevent cycling (loop-back) of Replicat the individual records in a bi-directional configuration or to filter other transactions from capture. The default
SETTAG
value is 00 and is limited to 2K bytes. A valid value is any single Oracle Streams tag. A tag value can be up to 2000 hexadecimal digits (0-9 A-F) long.Transactions in the redo that are marked with the specified tag can be filtered by an Extract that has the
TRANLOGOPTIONS
parameter with theEXCLUDETAG
option set to thetag_value
. Use tag-based filtering to prevent cycling (loop-back) of Replicat transactions in a bi-directional configuration or to filter other transactions from capture. For more information, seeTRANLOGOPTIONS
.You can disable the tagging of DDL by using the
DDLOPTIONS
parameter with theNOTAG
option. -
SKIPTEMPLOB | NOSKIPTEMPLOB
-
Valid for Replicat for Oracle Database versions 11g and 12c. Controls how LOBs are applied to a target Oracle database. The default of
SKIPTEMPLOB
.SKIPTEMPLOB
improves performance by directly writing LOB data to the target LOB column. Replicat creates a SQL statement with an empty LOB value and returns the LOB locator to the bind variable. After the SQL statement is executed successfully, the LOB data is written directly to the LOB column using the returned LOB locator.NOSKIPTEMPLOB
uses a temporary LOB in the SQL statement. Replicat declares a bind variable within SQL statement and associates a temporary LOB, then writes to the temporary LOB. The Oracle Database applies the LOB column data from the temporary LOB.SKIPTEMPLOB
applies toINSERT
andUPDATE
operations that contain LOB data. It does not apply if the table has a functional index with a LOB column, if the LOB data is NULL, empty, or stored inline. It does not apply to partial LOB operations.SKIPTEMPLOB
causes Replicat to generate/perform 1 DML+ n LOB_WRITE (piece-wise) operations when updating/inserting a row with LOB columns. However,SKIPTEMPLOB
should not be used withFETCHPARTIALLOB
(an Extract Parameter) because it results in excessive fetching.NOSKIPTEMPLOB
is provided for backward compatibility; otherwise the default ofSKIPTEMPLOB
should be retained. -
SOURCE_DB_NAME
src_dbase
_
global_name
-
Valid for Oracle.
Indicates the Global Name of the Trail Source Database. It is used to query the relevant instantiation information when
DBOPTIONS ENABLE_INSTANTIATION_FILTERING
is enabled. This option is optional for instantiation filtering in a 12.2. trail file with metadata enabled.When the source has no
DOMAIN
, do not specify aDOMAIN
for the downstream database.TheSOURCE_DB_NAME
option is mandatory if Oracle AQ (Advanced Queuing) objects are included in replication, and procedural replication has been enabled. See the following example:DBOPTIONS SOURCE_DB_NAME CDB1_PDB1.NORTH.COM
-
SPTHREAD | NOSPTHREAD
-
Valid for Extract and Replicat. Not valid for Oracle and MySQL.
Creates a separate database connection thread for using
SQLEXEC
to execute stored procedures. The default isNOSPTHREAD
. -
SQLMODE
- With this option enabled, the
sql_mode
variable is set to to 'ANSI_QUOTES'
(set sql_mode = 'ANSI_QUOTES'
). Treat the double quotes ("
) as an identifier quote character (like the`
quote character) and not as a string quote character. You can still use`
to quote identifiers with this mode enabled. WithANSI_QUOTES
enabled, you cannot use double quotes ("
) to quote literal strings, because it is interpreted as an identifier.For more information, see Server SQL Modes.
-
SUPPRESSTEMPORALUPDATES
-
Valid for DB2 LUW 10.1 FixPack 2 and greater replication of temporal table.
Use
SUPPRESSTEMPORALUPDATES
to replicate system-period and bitemporal tables along with associated history tables. Oracle GoldenGate replicates the row begin, row end, and transaction start id columns along with the other columns of the table. You must ensure that the database instance has the execute permission to run theSYSPROC.SET_MAINT_MODE_RECORD_NO_TEMPORALHISTORY¿
stored procedure at the apply side.By default, Oracle GoldenGate does not replicate row begin, row end, and transaction start id columns. To preserve the original values of these columns, implement one of the followings options.
-
Add extra timestamp columns in the target temporal table and map the columns accordingly.
-
Use a non-temporal table at the apply side and map the columns accordingly.
Replication in Non-Oracle Environment:
In non-Oracle environments where there is no temporal tables at the apply side, you need to set the row begin, row end and transaction start id columns value. These source columns will have timestamp values that the target database may not support. You should first use the map conversion functions to convert these values into the format that target database supports, and then map the columns accordingly. For example, MySQL has a
DATETIME
range from `1000-01-01 00:00:00.000000' to '9999-12-31 23:59:59.999999¿'. You cannot replicate a DB2 LUW timestamp value of `0001-01-01-00.00.00.000000000000¿ to MySQL. To replicate such values you must convert this value into the MySQLDATETIME
format. For example, if a system-period or bitemporal table has the following timestamp column:SYS_START -------------------------------- 0001-01-01-00.00.00.000000000000
Then to replicate this column into MySQL, you would use the function
colmap()
as follows:map <source_schema>.<source_table>, target <target_schema>.<target_table> colmap(sys_start= @IF( ( @NUMSTR( @STREXT(sys_start,1,4))) > 1000, sys_start, '1000-01-01 00.00.00.000000'));
Initial Load of Temporal Table:
Oracle GoldenGate supports initial load of temporal table as usual.
Take into account the following considerations with temporal table:
-
Replication between system-period and application-period temporal table is not supported.
-
Replication from a non-temporal table to a temporal table is not supported.
-
Replication of system-period, bi-temporal tables, and
SUPPRESSTEMPORALUPDATES
with theINSERTALLRECORDS
parameter is not supported. -
If any unique index is created for application-period temporal table using
BUSINESS_TIME WITHOUT OVERLAPS
for the target table, then the same unique index must be created for the source table. -
Bidirectional replication between temporal tables is advised only with the default.
-
CDR is supported only with
SUPPRESSTEMPORALUPDATES
. There is no CDR support in bidirectional replication. -
By default, there are inconsistencies in row begin, row end, and transaction start id columns of the temporal tables when the source and target databases operate with different time zones. These timestamp columns of system-period and bitemporal tables are automatically populated by the respective database managers and will have values as per the respective time zones of the databases.
-
Using the default with
GETUPDATEBEFORES
is in the replicate parameter file, you cannot use the row begin, row end, and transaction start id columns in any delta calculations. For example, taking before and after image of such columns in any kind of calculations is not possible. These columns can be used in delta calculations usingSUPPRESSTEMPORALUPDATES
.
-
-
SUPPRESSTRIGGERS | NOSUPPRESSTRIGGERS
-
Valid for Integrated Replicat and Classic Replicat for Oracle.
Controls whether or not triggers are fired during the Replicat session. Provides an alternative to manually disabling triggers. (Integrated Replicat does not require disabling of triggers on the target system.)
SUPPRESSTRIGGERS
is the default and prevents triggers from firing on target objects that are configured for replication with Oracle GoldenGate.SUPPRESSTRIGGERS
is valid for Oracle Database 12c, 11g (11.2.0.2), and later 11g R2 releases.SUPPRESSTRIGGERS
is not valid for 11g R1.To allow a specific trigger to fire, you can use the following
SQLEXEC
statement in the Replicat parameter file, wheretrigger_owner
is the owner of the trigger andtrigger_name
is the name of the trigger.SQLEXEC 'DBMS_DDL.SET_TRIGGER_FIRING_PROPERTY('"S1"','"MY_TRIGGER"',FALSE);'
Note:
Once this
SQLEXEC
is executed withFALSE
, the trigger will continue to fire until the command is run again with a setting ofTRUE
.NOSUPPRESSTRIGGERS
allows target triggers to fire. To use[NO]SUPPRESSTRIGGERS
, the Replicat user must have the privileges granted through theOGG_APPLY
user role available from Oracle Database 23ai and higher or thedbms_goldengate_auth.grant_admin_privilege
package for Oracle Database 21c and lower. This procedure is part of the Oracle database installation. See the database documentation for more information.The
USERIDALIAS
parameter must precede aDBOPTIONS
statement that containsSUPPRESSTRIGGERS
orNOSUPPRESSTRIGGERS
. -
TRANSNAME
trans_name
-
Valid for Replicat for SQL Server.
Allows an individual Replicat to use a specific transaction name that is specified in the parameter file. The
trans_name
is the name of the transaction that the Replicat uses for target DML transactions and overrides the defaultggs_repl
transaction name when used.
-
USEDATABASEENCODING
-
By default, the DB2 for i Extract converts all text data to UTF-8 for non-DBCS data and UTF-16 for DBCS data. Using this option causes the Extract to store all text data in the trail in its native character encoding for non-DBCS data. Currently, DBCS (
GRAPHIC
/VARGRAPHIC
/DBCLOB
) data continues to be converted to UTF-16 whether this parameter is provided or not. For CCSID values that are not supported by Oracle GoldenGate, the Extract converts the data to UTF-8 for non-DBCS data and UTF-16 for DBCS data to ensure compatibility for all Replicats.
-
XMLBUFSIZE
bytes
-
Valid for Extract for Oracle.
Sets the size of the memory buffer that stores XML data that was extracted from the
sys.xmltype
attribute of aSDO_GEORASTER
object type. The default is 1048576 bytes (1MB). If the data exceeds the default buffer size, Extract will abend. If this occurs, increase the buffer size and start Extract again. The valid range of values is 1024 to 104857600 bytes.