This document describes the TP monitor environment-specific requirements that apply and the keyword parameters can be used to define the Natural swap pool.
The following topics are covered:
The following environment-specific requirements apply:
Under UTM:
The Natural swap pool is defined by specifying macro
NTSWPRM
for assembling the Natural swap-pool parameter module.
Under CICS:
The Natural swap pool is defined by specifying
NTSWPRM
in the NCISCPCB
environment definition module.
The following keyword parameters can be used to define the Natural swap pool details:
LABEL
| DSPCONT
|
DSPLIFE
| SWPFILE
| MAXSIZE
|
SWPFACT
| SWPINIT
| SWPLSWP
| SWPPWRD
| SWPSDIF
| SWPSLSZ
| SWPTFIX
| SWPTIM1
| SWPTIM2
| SWPUSER
| NOVPA
| NOVPW
| WAITMS
| WRITMS
|
This parameter defines the CSECT name of the swap-pool parameter module.
LABEL=nnnnnnnn |
The name nnnnnnnn may
be 8 characters at maximum.
|
LABEL=NATSWPRM |
The default setting is the name of macro
NTSWPRM .
|
This parameter defines the time (in minutes) after which data space control takes place when the ESA Data Space area is full. When this time has elapsed, the slots in the Data Space are checked for whether their threads' life time has expired. If so, the compressed Natural user thread of each affected slot is rolled out into the roll file.
DSPCONT=nnn |
nnn must be in the
range of 1 to 480 .
|
DSPCONT=10 |
The default value is 10 (minutes).
|
This parameter defines the life time for a compressed Natural user thread in a slot of the ESA Data Space. When the data space slots control logic becomes active, the thread is rolled out if its life time has elapsed. The life time of a thread starts when the thread is written to the ESA Data Space.
DSPLIFE=nn |
nn must be in the
range of 1 to 60 .
|
DSPCONT=5 |
The default value is 5 (minutes).
|
This parameter defines whether the swap-pool initialization data are
stored in the Natural system file FNAT
or FUSER
when
the function
SWPINIT=AUTO
is used.
SWPFILE=FNAT/FUSER |
File definition for the swap pool initialization data. |
SWPFILE=FNAT |
The default value is FNAT .
|
This parameter defines the size
nnn
of the Natural user threads in KB.
For information on how to determine this size, see
Using the MAXSIZE
Parameter.
MAXSIZE=nnn |
nnn must be in the
range of 64 to 32768.
|
MAXSIZE=400 |
The default setting is 400 (KB).
|
Under CICS, this parameter specification is ignored, because the Natural CICS interface will automatically take the size of the largest thread for this parameter.
The factor n
you specify with
this parameter determines the size of a "unit" in the swap-pool
reorganization plus tables and minus tables.
SWPFACT=n |
Possible values for n
are 0 to 4 . n
determines the size of a "unit" as follows:
|
|
|
SWPFACT=1 |
The default setting is 4 KB. |
These tables are used to calculate slot sizes, to dynamically reorganize the swap pool and to get swap-pool statistics see Dynamic Swap-Pool Reorganization.
This parameter specifies the access to the swap-pool initialization data through the Natural system file.
SWPINIT= |
Blank, as described above under Swap Pool Initialization, see If You Set SWPINIT=. |
SWPINIT=AUTO |
This is the default setting. The swap-pool initialization data are to be read from/stored in the Natural system file. See also Swap Pool Initialization, If You Set SWPINIT=AUTO. |
For more information on how to use this parameter, see Swap Pool Initialization.
This parameter defines the maximum number
n
of logical swap pools to be used.
SWPLSWP=n |
Possible values for n
are 0 to 15 .
|
SWPLSWP=0 |
See Note 3 below. |
Notes:
The minimum size of a logical swap pool is 64 KB.
The value defined must not be smaller than the number of slot sizes
defined in the parameter
SWPSLSZ
.
If the default value 0
is used, the swap-pool manager
will compute the maximum number of logical swap pools.
This parameter will be ignored if the swap-pool initialization data could be read from the Natural system file.
With this parameter, you specify the password for the administration of
the swap-pool reorganization control data and the Buffer Usage Statistics in
the swap-pool manager subsystem of the Natural utility SYSTP
.
SWPPWRD=password
|
The password can be up
to 4 characters long.
|
SWPPWRD=ADMI |
This is the default value. |
With this parameter, you specify the minimum difference of the slot sizes in the logical swap pools.
SWPSDIF= nn |
nn must be an even
number and specifies the number of kilobytes (KB).
nn must be in the range of
2 to 98 .
|
SWPSDIF=8 |
The default value is 8 KB. |
Note:
This parameter will be ignored if the swap-pool initialization data
could be read from the Natural system file.
This parameter determines the number of logical swap pools, the slot sizes and the relation of slot numbers between the different logical swap pools. Possible values are:
|
nn | Determines the slot size of a logical swap pool in kilobytes
(must be an even number). nn must be in
the range of 20 to 998 .
|
f | Determines the relation in terms of a numerical factor between
the slot numbers of the different logical swap pools.
f must be in the range of
1 to 9 .
|
|
SWPSLSZ=(62,1) |
The default slot size is 62 KB. The default relation is 1. |
SWPLSZ=(44,1,62,2) /* SWAP POOL SIZE IS 2048 KB /* THERE WILL BE TWO LOGICAL SWAP POOLS, RELATION BETWEEN THEM IS 1:2 /* 1 LOGICAL SWAP POOL WITH 12 (1) 44-KB SLOTS /* 1 LOGICAL SWAP POOL WITH 24 (2) 62-KB SLOTS< SWPLSZ=(64,80,96) /* SWAP POOL SIZE IS 8 MB /* THERE WILL BE THREE LOGICAL SWAP POOLS, RELATION BETWEEN THEM IS 1:1:1 /* 1 LOGICAL SWAP POOL WITH 34 (1) 64-KB SLOTS /* 1 LOGICAL SWAP POOL WITH 34 (1) 80-KB SLOTS /* 1 LOGICAL SWAP POOL WITH 34 (1) 96-KB SLOTS
This parameter will be ignored if the swap-pool initialization data could be read from the Natural system file.
This parameter determines if the size of the swap pool slots is to be fixed or not. Possible values are:
SWPTFIX=Y |
The slot size defined with the
SWPSLSZ
parameter (see above) is taken as a fixed size and no reorganization of the
swap pool takes place.
|
SWPTFIX=N |
This is the default value. The slot size defined with the
SWPSLSZ
parameter (see above) is not taken as a fixed size and the swap pool is
reorganized when necessary; that is, the size of the slots is dynamically
adjusted to meet the actual requirements.
|
Note:
This parameter will be ignored if the physical swap pool contains
more than one logical swap pool.
With this parameter, you specify the time interval
nnn
at which a check is to be performed
to ascertain whether a swap-pool reorganization is necessary. Possible values
are:
SWPTIM1=nnn |
nnn must be in the
range from 1 to 540 (minutes).
|
SWPTIM1=(nnn,RESET) |
The contents of the swap-pool-reorganization statistics tables are deleted after the check (normally, they are only deleted after a swap-pool reorganization). |
SWPTIM1=30 |
The default value is 30 (minutes).
|
For details on how the check and a possible swap pool reorganization are performed, see Dynamic Swap-Pool Reorganization.
Important:
If the parameter SWPTFIX
is set to
Y
or if the physical swap pool contains more than than one logical
swap pool, the SWPTIM1
parameter does not
apply.
With this parameter, you can specify the time nn to elapse after the check for the necessity of a swap-pool reorganization is performed and before the actual reorganization is to be started.
SWPTIM2=nn
|
nn must be in the
range from 1 to 99 (minutes)
|
SWPTIM2=2 |
The default value is 2 (minutes).
|
During this time, no further user areas can be placed in the swap pool, while user areas still held in the swap pool can still be used and read in the Natural user thread.
For details on how the check and a possible swap-pool reorganization are performed, see Dynamic Swap-Pool Reorganization.
If the parameter SWPTFIX
is set to
Y
or if the physical swap pool contains more than than one logical
swap pool, the SWPTIM2
parameter does not apply.
With this parameter you can define which condition has to be met for a swap-pool reorganization to take place.
SWPUSER=nn
|
nn must be in the
range from 1 to 99 .
|
SWPUSER=20
|
The default value is 20 (percent).
|
You can define a percentage value nn which determines the percentage of dialog steps of all users where the length of the compressed user areas was 1 or more units larger (or 1 or more units smaller) than the current slot size. If a check establishes that this percentage is reached, a swap-pool reorganization takes place.
For details on how the check is performed, see Dynamic Swap-Pool Reorganization.
If the parameter SWPTFIX
is set to
Y
or if the physical swap pool contains more than than one logical
swap pool, the SWPUSER
parameter does not apply.
This parameter determines the number of waits for a completed asynchronous write.
NOVPA=nnn |
nnn must be in the
range of 1 to 999 .
|
NOVPA=20 |
The default value is 20 (waits).
|
This parameter determines the number of waits for an unlocked swap pool.
NOVPW=nnn
|
nnn must be in the
range of 1 to 999 .
|
NOVPW=15 |
The default value is 15 (waits).
|
This parameter determines the number of milliseconds for one wait of an unlocked swap pool.
WAITMS=nnn |
nnn must be in the
range of 1 to 999 .
|
WAITMS=5
|
The default value is 5 (milliseconds).
|
This parameter determines the number of milliseconds for one wait of a completed asynchronous write.
WRITMS=nnn |
nnn must be in the
range of 1 to 999 .
|
WRITMS=10 |
The default value is 10 ( milliseconds).
|