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.
The following topics are covered:
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 UTM applications.
A new Natural nucleus can be loaded only into a global common memory pool.
When a new Natural nucleus is to be loaded into the common memory pool, the name of the linked (reentrant) 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
The program PREFRESH
has the following keyword
parameters:
NAME
| LIBR
| LOAD
|
ALNK
|
TIM1
|
TIM2
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 |
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. |
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.
|
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.
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.
|
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. |
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. |