Refresh of Natural Load Pool

This document describes the prerequisites, restrictions and procedures that are applicable for refreshing a Natural load pool and contains a list of the keyword parameters provided in the PREFRESH program.

This section covers the following topics:

Prerequisites and Restrictions
Procedure
Keyword Parameters for the Program PREFRESH

Prerequisites and Restrictions

The Natural load pool must have been started with the keyword parameter ACCS=WRITE, using the program CMPSTART.
A Natural load pool which is also used by batch applications must not be refreshed while the Natural batch applications are in operation. A refresh is admissible only with TIAM and openUTM applications.
A new Natural nucleus can be loaded only into a global common memory pool.

Procedure

When a new Natural nucleus is to be loaded into the common memory pool, the name of the linked environment-independent nucleus must be identical with the existing name. The name of the Natural nucleus is equal to the name of the global common memory pool.

Example:

The existing Natural nucleus was started with the following parameters using the program CMPSTART:
```
/EXEC (CMPSTART,NATURAL.MOD)
NAME=NATSHARE,POSI=ABOVE,ADDR=250,PFIX=YES,SIZE=2MB,ALNK=NO  
ACCS=WRITE,LIBR=NATURAL.USER.MOD.A
```

The newly linked Natural nucleus is to be loaded from the library NATURAL.USER.MOD.B into the global common memory pool. This is accomplished with the program PREFRESH.

Example:

/.PREFRESH LOGON
/OPTION DUMP=YES
/SYSFILE SYSOUT=LST.PREFRESH.NATSHARE  
/SYSFILE SYSDTA=(SYSCMD)
/EXEC (PREFRESH,NATURAL.MOD)
NAME=NATSHARE,LIBR=NATURAL.USER.MOD.B
/LOGOFF N

or:

/load (prefresh,natural.mod) <enter>
% BLS0517 MODULE 'PREFRESH' LOADED
/r <enter>
*name=natshare,libr=natural.user.mod.b <enter>
* <enter>
REFR050: LOAD POOL NATSHARE IS SUCCESSFULLY REFRESHED  
/

The successful loading of the new Natural nucleus is confirmed by the message:
```
REFR050: LOAD POOL name IS SUCCESSFULLY REFRESHED
```

Keyword Parameters for the Program PREFRESH

The program PREFRESH has the following keyword parameters:

The program PREFRESH has the following syntax (If available, default values are shown.):

REFRESH NAME=name,LIBR=library,LOAD=BIND,ALNK=NO,TIM1=10,TIM2=20

NAME - Common Memory Pool and Module Name

This parameter determines the name of the module and the name of the common memory pool. The name must be specified. No default value exists.

NAME=xxxxxxxx

xxxxxxxx: valid module and common memory pool name.

The name must be identical with the existing module/common memory pool name.

The maximum number of characters is 8.

LIBR - Load Library

This parameter determines from where the defined module is to be loaded. The name must be specified. No default value exists.

LIBR=library library is the name of the load library.

LOAD - Module Load Method

This parameter determines which macro shall be used for loading a module into a common memory pool.

`LOAD=ASHARE`	The macro `ASHARE` will be used.
`LOAD=BIND`	By default, the macro `BIND` will be used.

Important:
When LOAD=ASHARE is defined, for the start of the common memory load pool (with program CMPSTART), LOAD=ASHARE also must be defined.

ALNK - Activate AUTOLNK Function

This parameter determines whether the AUTOLNK function of the dynamic binder loader (DBL) is activated.

`ALNK=YES`	The `AUTOLNK` function is activated.
`ALNK=NO`	By default, the `AUTOLNK` function is deactivated.

TIM1 - Wait Time in Seconds before the Load Pool Refresh is Started

This parameter determines the waiting time in seconds before the new Natural nucleus is loaded. It serves to synchronize Natural sessions which are currently active in the nucleus.

`TIM1=xx`	`xx` must be in the range from 1 up to 99.
`TIM1=10`	The default value is 10 seconds.

TIM2 - Wait Time in Seconds after the New Natural Nucleus was Loaded

This parameter determines the waiting time in seconds after the loading of the new Natural nucleus is complete until the serialization identification for the corresponding application has been enabled. It serves to synchronize the relativizing of all address constants in the newly loaded nucleus.

`TIM2=xx`	`xx` must be in the range from 1 up to 99.
`TIM1=20`	The default value is 20 seconds.