Annonce : Purge en ligne et uxpurge : nouveautés sur la purge en ligne en V533 Rating Options

[men]

Bonjour,

la purge en ligne et l'uxpurge présentaient des différences qui pouvaient être gênantes et amener à lancer les 2 purges.

Le FX24567 de la V533 apporte des améliorations à la purge en ligne (ce patch n'est pas à ce jour en General Availability).

Voici les informations sur ces évolutions (cf lisezmoi du patch) :


La nouvelle version de la purge en ligne n'est pas activée par défaut, celle-ci peut-être activée via la variable d'environnement U_IO_PURGE_ENABLE définie à Y ; cette variable doit être positionnée dans le fichier dans les fichiers uxsetenv
Si activée, la purge online se compose d'une purge dynamique réalisée par l'ordonnanceur et d'une purge non dynamique réalisée cycliquement par un thread du serveur d'IO, ces 2 purges utilisant les mêmes paramètres qui sont définis dans un fichier de configuration propre à chaque espace, u_purge_param.ref situé dans le répertoire data de l'espace considéré.
Pour la purge dynamique, le fichier maître de purge est le fichier des lancements (u_fmsb), la purge d'un record dans le fichier u_fmsb déclenchant la purge des records associés dans les fichiers dynamiques (u_fmcx, u_fmhs, u_fmph, u_fmfu, u_fmev, u_fmtp, u_fmsp, u_fmer, u_fmeq) ; pour la purge dynamique, les critères de rétention pour les fichiers dynamiques sont donc ceux du fichiers des lancements ; les états purgés par la purge dynamique sont des états finaux ; en cas de changement dans le fichiers de paramètres de purge, les dates de purges positionnées par l'ordonnanceur sont recalculées afin que le changement
soit bien pris en compte. La purge non-dynamique purge les records non purgés par la purge dynamique ; les critères de rétention sont dans ce cas ceux du fichiers des lancements u_fmsb pour les fichier u_fmtp/u_fmsp/u_fmcm, ceux du fichier de contrôle u_fmcx pour les fichier u_fmer/u_fmeq/critères de gestion, et ceux du fichier historique u_fmhs pour les fichier u_fmph/u_fmfu. C'est le thread de purge du serveur d'IO qui gère la lecture du fichier des paramètres de purge, le thread lisant le fichier des paramètres à intervalle régulier, ou bien lorsque le binaire loadPurParFic <SOC> <ESP> <NODE> est utilisé ; le serveur d'IO est interrogé par l'ordonnanceur pour récupérer les paramètres de purge de façon à ce que la purge dynamique prenne en compte un changement dans les dits paramètres ; en cas de changement, la date de purge est recalculée en fonction des nouveaux paramètres.

Le fichier des paramètres de purge est propre à chaque espace, situé dans UXDEX/UXDAP/UXDSI/UXDIN et nommé : u_purge_param.ref

Le format du fichier est le suivant :
# pour un commentaire
Les lignes vides sont ignorées
Une ligne significative a le format suivant : PARAM=VAL

Les différents paramètres sont les suivants :
PUR_DYN Y/N
Activer/Désactiver la partie " purge dynamique " de la purge online
défaut Y
CHK_FIC JJJ:HH:MM
Cycle de check du fichier des paramètres de purge
défaut 001 :00 :00

PUR_CYC JJJ:HH:MM
Cycle de la purge non dynamique réalisée par l'IO
défaut --- :-- :--
PUR_HHMM HH:MM
Heure la purge non dynamique réalisée par l'IO
défaut 00 :01
PUR_LOG Y/N/F
Paramétrer les options de log de la purge
défaut N
PUR_FREEZE Y/N
Stopper/Démarrer la purge online
défaut N
LAN_RET_DEF JJJ:HH:MM
Durée de rétention par défaut pour le fichier des lancements
défaut 007 :00 :00
LAN_RET_'XX' JJJ:HH:MM
Durée de rétention spécifique à un état.
défaut LAN_RET_DEF
La liste des états possibles est (en gras les états relatifs à la purge dynamique)
H état désactivé
D état démarré
W état attente d'événement
R état refusé
WO état horaire dépassé après au moins un pilotage
LO état horaire dépassé sans pilotage
E état exécution en cours
A état attente d'exécution
I état incidenté
T état terminé
F état consignes de terminaison en cours

CTL_RET_DEF JJJ:HH:MM
Durée de rétention par défaut pour le fichier de contrôle
défaut 007 :00 :00
CTL_RET_'XX' JJJ:HH:MM
Durée de rétention spécifique à un état.
défaut CTL_RET_DEF
La liste des états possibles est :
D état démarré
W état attente d'événement
R état refusé
O état horaire dépassé
E état exécution en cours
A état attente d'exécution
I état incidenté
T état terminé
F état consignes de terminaison en cours
HST_RET_DEF JJJ:HH:MM
Durée de rétention par défaut pour le fichier historique

défaut 007 :00 :00
HST_RET_'XX' JJJ:HH:MM
Durée de rétention spécifique à un état.
défaut HST_RET_DEF
La liste des états possibles est :
D état démarré
W état attente d'événement
R état refusé
O état horaire dépassé
E état exécution en cours
A état attente d'exécution
I état incidenté
T état terminé
F état consignes de terminaison en cours

Aucun paramètre n'est obligatoire ; en cas d'absence d'un paramètre, la valeur par défaut est considérée.
La valeur par défaut est aussi considérée dans si un paramètre au format JJJ :HH :MM est défini à --- :-- :-- ou si un paramètre HH :MM est défini à -- :--.
Pour les durées de rétention, une zone définie à 000 :00 :00 signifie une durée de rétention infinie.
En cas d'absence du fichier de paramètres, problème de lecture de ce fichier, problème lors du parsing du fichier,.. les valeurs par défaut sont considérées lors du premier chargement des paramètres ; lors des chargements suivants, les valeurs préalablement chargées sont conservées.
PUR_CYC et PUR_HHMM sont incompatibles ; l'un des deux paramètres doit être laissé à --- :-- :-- ou -- :-- ; dans le cas où PUR_HHMM est utilisée, le cycle de purge de l'IO est positionné à 1 journée ; dans le cas où PUR_CYC est défini, la première purge non dynamique a lieu 1 minute après le chargement des paramètres ; ensuite le cycle de purge de l'IO est appliqué.
Pour le fichier u_fmcm et les critères de gestion, la durée de rétention considérée est la plus grande des durées de rétention associées au fichier considéré, respectivement donc fichier des lancements et fichier de contrôle.
Si le paramètre PUR_LOG est mis à Y, un fichier log par espace est créé u_purge.log, respectivement dans UXLEX, UXLAP, UXLIN, UXLSI. A Y, la liste des paramètres de purge est affichée à chaque chargement des paramètres et lors du démarrage de la purge non dynamique. A F, le fichier log contient en plus la liste des records effacés par la purge non dynamique, ainsi que la liste des records du sb effacés par la purge dynamique.
Le binaire chkPurParFic <fichier> permet de vérifier la syntaxe correcte du fichier des paramètres ; le parsing s'arrête à la première erreur et affiche la ligne en erreur. chkPurParFic <help> affiche l'aide pour ce binaire.
Le binaire loadPurParFic <SOC> <ESP> <NODE> permet de forcer un chargement des paramètres en dehors du cycle normal de chargement du fichier de paramètres par l'IO. binaire loadPurParFic <help> affiche l'aide pour ce binaire.
Dans tous les cas de chargement du fichier des paramètres, si le fichier n'a pas été modifié, le chargement ne provoque aucun changement au niveau des paramètres de la purge ; si le fichier est incorrect syntaxiquement, les paramètres de purge préalablement chargés sont conservés. Si PUR_CYC est défini, dans tous les cas de chargement, la purge non dynamique démarrera 1 minute après le chargement.
Dans le cas où les paramètres de purge font que la purge non dynamique et le chargement du fichier des paramètres doivent se faire au même moment, la purge non dynamique s'exécute d'abord.

Exemples de log avec PUR_LOG à Y :
##### LOAD OF PURGE PARAMETERS ##### [20080619141700]
ENABLE [Y] / FREEZE [Y] / DYN [N] / LOG [d] / CHECK PARAM CYCLE [001:00:00] /
IO PURGE CYCLE [000:00:10] / IO PURGE HOUR [--:--]
CTL_RET_A 000:00:05
CTL_RET_D 000:00:05
CTL_RET_DEF007:00:00
CTL_RET_E 000:00:05
CTL_RET_F 000:00:05
CTL_RET_I 000:00:05
CTL_RET_O 000:00:05
CTL_RET_R 000:00:05
CTL_RET_T 000:00:05
CTL_RET_W 000:00:05
HST_RET_A 000:00:05
HST_RET_D 000:00:05
HST_RET_DEF007:00:00
HST_RET_E 000:00:05
HST_RET_F 000:00:05
HST_RET_I 000:00:05
HST_RET_O 000:00:05
HST_RET_R 000:00:05
HST_RET_T 000:00:05
HST_RET_W 000:00:05
LAN_RET_A 000:00:05
LAN_RET_D 000:00:05
LAN_RET_DEF007:00:00
LAN_RET_E 000:00:05
LAN_RET_F 000:00:05
LAN_RET_H 000:00:05
LAN_RET_I 000:00:05
LAN_RET_LO 000:00:05
LAN_RET_R 000:00:05
LAN_RET_T 000:00:05
LAN_RET_W 000:00:05
LAN_RET_WO 000:00:05
--------------------------------------------
##### START OF IO PURGE [20080619141800] #####
CTL_RET_A 000:00:05
CTL_RET_D 000:00:05
CTL_RET_DEF007:00:00
CTL_RET_E 000:00:05
CTL_RET_F 000:00:05
CTL_RET_I 000:00:05
CTL_RET_O 000:00:05
CTL_RET_R 000:00:05
CTL_RET_T 000:00:05
CTL_RET_W 000:00:05
HST_RET_A 000:00:05
HST_RET_D 000:00:05
HST_RET_DEF007:00:00
HST_RET_E 000:00:05
HST_RET_F 000:00:05
HST_RET_I 000:00:05
HST_RET_O 000:00:05
HST_RET_R 000:00:05
HST_RET_T 000:00:05
HST_RET_W 000:00:05
LAN_RET_A 000:00:05
LAN_RET_D 000:00:05
LAN_RET_DEF007:00:00
LAN_RET_E 000:00:05
LAN_RET_F 000:00:05
LAN_RET_H 000:00:05
LAN_RET_I 000:00:05
LAN_RET_LO 000:00:05
LAN_RET_R 000:00:05
LAN_RET_T 000:00:05
LAN_RET_W 000:00:05
LAN_RET_WO 000:00:05
--------------------------------------------
##### END OF IO PURGE [20080619141800] #####
--------------------------------------------

Exemples de log avec PUR_LOG à F :
[SIO] [HS] [ ]/[000] [PURGE_OK ]/[000] [MUPURGE ] [T]
[0000000]/[0000147]/[0000174] [20080619140601]
[LAN] [SB] [ ]/[000] [PURGE_OK ]/[000] [CALPMFSO ] [T]
[0000000]/[0000236]/[0000279] [20080619143432]
[SIO] / [LAN] composant réalisant la purge
[HS] / [CX] / [SB] fichier considéré
[ ]/[000] session / numéro de session
[PURGE_OK ]/[000] uproc / numéro d'uproc
[MUPURGE ] ug
[T] état
[0000000]/[0000147]/[0000174] numsess/numproc/numlanc
[20080619140601] date de purge YYYYMMDDHHMMSS