This document describes how to control the initialization of a Natural
swap pool and contains an overview of the keyword parameters available for
initialization in the macro NTSWPRM
.
The section covers the following topics:
The parameter SWPINIT
in the macro
NTSWPRM
controls the initialization of the swap
pool.
The swap pool manager tries to read the swap pool initialization data
with the swap pool name as key from the Natural system file FNAT
or FUSER
(see keyword parameters
SWPFILE
of macro NTSWPRM
).
If it finds data, they are used and the corresponding parameters in the macro
NTSWPRM
are ignored. If it does not find data, the
operand(s) of the keyword parameter
SWPSLSZ
in the macro NTSWPRM
will be used for initializing the
swap pool.
If the parameter
SWPSLSZ
contains only one slot size definition, the swap pool is initialized with one
logical swap pool. In the specified time interval (see parameter
SWPTIM1
in the macro NTSWPRM
), the swap pool manager controls
whether the swap pool needs to be reorganized or optimized (see also the
section Dynamic Swap-Pool
Reorganization). If the swap pool was reorganized, the
newly calculated initialization data for the swap pool are stored in the
Natural system file for the next initialization. If the swap pool's
reorganization has resulted in more than one logical swap pool, there will be
no further dynamic swap pool reorganization.
Dynamic swap pool reorganization is not possible when the swap pool contains more than one logical swap pool.
Further swap pool optimizations can be explicitly initialized with
the following Natural SYSTP
utility functions:
Slot Size Calculation,
Swap Pool Parameter Service (modification of the swap pool initialization data in the Natural system file),
Deactivate the Swap Pool and Activate the Swap Pool.
The maximum number of logical swap pools for dynamically reorganizing
or optimizing the swap pool can be defined in the operand of the keyword
parameter SWPLSWP
in macro NTSWPRM
.
No swap pool initialization data in the Natural system file will be
read or stored. The operand(s) of the keyword parameter
SWPSLSZ
in the macro NTSWPRM
will be used for initializing the
swap pool.
The rules for dynamically reorganizing or optimizing the swap pool
are the same as described under SWPINIT=AUTO
above,
except that no initialization data will be stored in the Natural system
file.
The following is an overview of the keyword parameters that are
available for initialization in the macro
NTSWPRM
.
Parameter | Explanation |
---|---|
SWPSLSZ
|
Defines the number of logical swap pools, their slot sizes and the numerical relation between slot number and logical swap pools. |
SWPINIT
|
Defines the access to the swap pool initialization data through the Natural system file. |
SWPLSWP
|
Defines the maximum number of logical swap pools for reorganizing swap pools dynamically. |
SWPSDIF
|
Defines the even-numbered minimum difference between the slot sizes of the different logical swap pools. This value will be controlled during slot-size calculation and dynamic swap-pool reorganization. |
The following TP-monitor-specific requirements apply:
Under openUTM:
The size of the swap pool must be specified in the operand of keyword
parameter SIZE
for macro ADDON
or program
CMPSTART
.
Under CICS:
The size, name and cache size of the swap pool are specified using
profile parameter BPI
or the
corresponding macro NTBPI
in the Natural parameter module,
that is, the (NT)BPI
settings in effect for the Natural
session initializing the Natural CICS environment are taken.