DS - Define Size of Storage Buffer

This Natural profile parameter defines the default initial size of various Natural storage buffers. It corresponds to the NTDS macro in the Natural parameter module.

Possible settings See DS Parameter Syntax.
Default setting See Table of Buffer Sizes.  
Dynamic specification yes This parameter can only be specified dynamically. In the Natural parameter module, the corresponding macro NTDS is used instead.
Specification within session no  

Notes:

  1. In previous versions of Natural, individual profile parameters (for example, SSIZE) were used to define the sizes of the buffers. The DS profile parameter is a universal parameter to specify all buffer sizes.
  2. You may continue using the individual parameters or you may use the individual parameters in parallel to the parameter DS. During the dynamic parameter evaluation, individual buffer size parameters are converted internally into the new DS parameter format, for example, SSIZE=55 is converted into DS=(SSIZE,55).
  3. However, there are some buffer sizes (for example, ESIZE, VSIZE, etc.) which cannot be specified by the profile parameter DS, due to certain reasons, for example, the size is part of a larger buffer or the size defines the total maximum of a number of buffers.
  4. For further information, see Natural Storage Management and General Rules for Parameter Usage in the Operations documentation.

The following topics are covered below:


DS Parameter Syntax

The DS parameter is specified as follows:

DS=(name,size,name,size,...)

Where:

Syntax Element Value Explanation
name 1 - 8 characters. The buffer name (1-8 characters), see Table of Buffer Sizes.
size - The buffer size in kilobytes. For limit values, see Table of Buffer Sizes.

Note:
Multiple pairs of buffer name and size values can be specified; see Example of DS Parameter.

NTDS Macro Syntax

The NTDS macro is specified as follows:

         NTDS  name,size
         NTDS  name,size
         ...

Where:

Syntax Element Value Explanation
name 1 - 8 characters. The buffer name (1-8 characters), see Table of Buffer Sizes.
size - The buffer size in kilobytes. For limit values, see Table of Buffer Sizes.

Note:
A separate NTDS macro must be specified for each pair of name and size values; see Examples of NTDS Macros.

Table of Buffer Sizes

Buffer Name Description Buffer Size (KB) Default Available as subparameter of DS and alternatively as individual profile parameter
ASIZE Entire System Server auxiliary buffer 0 or 64 - 512 0 yes

Note:
For details, see description of profile parameter ASIZE.

BSIZE Size of EntireX Broker buffer 0 or 1 - 64 0 yes
CSIZE Size of Con-nect/Con-form buffer area 0 or 1 - 512 0 yes
DATSIZE Size of buffer for local data 10 - 2097151 32 yes
DSIZE Initial size of DBLOG buffer 0 or 2 - 2097151 2 yes

Note:
The individual profile parameter DSIZE allows you to set a maximum size in addition.

EDPSIZE Size of the Software AG Editor auxiliary buffer pool 0 or 48 - 2097151 0 yes
ETPSIZE Size of Entire Transaction Propagator buffer 0 or 10 - 128 0 yes
EXCSIZE Size of buffer for Natural Expert C interface n/a n/a yes

Note:
This subparameter is only retained for compatibility reasons.

EXRSIZE Size of buffer for Natural Expert rule tables n/a n/a yes

Note:
This subparameter is only retained for compatibility reasons.

FLTUSER Size of buffer for fast locate table and subroutine cache.

Information contained in the fast locate table improves performance when Natural objects are called repeatedly. Information contained in the subroutine cache improves performance when the name of the module in which the subroutine is defined is being retrieved from the subroutine name specified with the PERFORM statement.

The FLTUSER buffer contains only information related to Natural objects belonging to the user's application.

0 or 4 - 2097151 8 Available only as subparameter of DS.

Note:
The value 0 enforces that neither a fast locate table nor a subroutine cache is allocated and will cause more database calls to be issued in order to retrieve information about Natural objects that are to be called. Therefore, the value 0 should only be used in environments where Natural objects of the same name exist in different steplib libraries (see Steplib Libraries in Using Natural), and the steplib libraries should always be searched for an object in the defined order.

The following formula helps estimate the initial buffer size required to store all entries in the fast locate table:

6 KB + (number of objects * 112 bytes)

which corresponds to a setting of DS=(FLTUSER,21).

This specifies the buffer size for the session start; more space is allocated automatically during the session if required.

MONSIZE Size of SYSTP monitor buffer 0 or 5 - 256 0 yes
MULFETCH Size of multi-fetch buffer 0 or 1 - 1024 64 Available only as subparameter of DS.

Note:
A value specified for this buffer does not represent the default initial size but the maximum size which can be allocated for multi-fetch purposes.

See Size of the Multi-Fetch Buffer in the Programming Guide.

NAFSIZE Size of buffer for Natural Advanced Facilities 0 or 1 - 64 0 yes
NSFSIZE Size of SAF interface buffer. 0 or 8 - 64 0 Available only as subparameter of DS.

See information on how to adjust the Natural parameter module in Installing and Activating Natural SAF Security in the Natural SAF Security documentation.

RDCSIZE Size of buffer for the Natural Data Collector 0 or 2 - 128 0 yes
RJESIZE Initial size of NATRJE buffer 0 or 1 - 2097151 8 yes
RUNSIZE Size of runtime buffer 10 - 64 16 yes
SSIZE Size of Software AG Editor buffer 0 or 40 - 512 64 yes
TSIZE Size of the buffer for Adabas Text Retrieval 0 or 1 - 2097151 0 yes
WSISIZE Buffer for Natural Workstation Interface 0 or 10 - 256 0 yes
ZSIZE Size of Entire DB buffer area 0 or 1 - 64 0 yes

For detailed information, refer to the descriptions of the individual buffer size parameters.

Example of DS Parameter

DS=(ASIZE,33,TSIZE,60,EDPSIZE,500)

Example of NTDS Macro

         NTDS ASIZE,33 
         NTDS TSIZE,60 
         NTDS EDPSIZE,500