
Natural for Mainframes	Version 8.2.6 for Mainframes	SEARCH CONTENTS \| PDF BOOKS \| HOME UP PREV NEXT

— Parameter Reference —

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:

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.
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).
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.
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
NTDS Macro Syntax
Table of Buffer Sizes
Example of DS Parameter
Example of NTDS Macro

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

SEARCH CONTENTS | PDF BOOKS | HOME UP PREV NEXT