APYJRNCHGX

Appliquer modifs journal étend

En bref

La commande APYJRNCHGX (Appliquer les modifications journalisées étendues) permet d'appliquer les modifications journalisées pour un objet journalisé spécifique sur une version sauvegardée de l'objet pour rétablir celui-ci après une erreur opérationnelle ou un dommage quelconque.

APYJRNCHGX se lit APY (Appliquer) + JRNCHGX. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

APYJRNCHGX JRN(…) FILE(…)

Paramètres

JRN Journal obligatoire
FILE Nom du fichier journalisé obligatoire
RCVRNG Plage de récepteurs de journal
FROMENTLRG Premier num. séq. maxi
TOENTLRG Dern. num. séq. maxi
TOTIME Date et heure de fin
TOJOBO Nom de travail qualifié
TOJOBC Nom de travail qualifié
CMTBDY Frontière de validation
OPTION Option
OBJERROPT Option erreur objet
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie
DETAIL Détail
FROMENT Numéro de séquence de début
TOENT Numéro de séquence de fin

Astuce : dans une session 5250, tapez APYJRNCHGX puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

A noter des différences mineures entre cette commande et la commande APYJRNCHG (Appliquer des modifications journalisées). Cette commande ne s'applique qu'aux postes de fichiers base de données et nécessite la mise en application de tous les fichiers d'une bibliothèque.

Remarque :La commande APYJRNCHGX est une solution tactique offrant une fonction qui n'a pas été fournie par la commande APYJRNCHG standard jusqu'à la V6R1M0. Le support pour la commande APYJRNCHGX sera retirée dans une version à venir.

Certaines modifications de niveau objet appliquées sont des postes issus d'instructions SQL. La réexécution de ces postes peut allonger l'exécution de APYJRNCHGX. Le délai de réexécution par défaut du poste ALTER TABLE, REFRESH TABLE ou de réorganisation du poste de fichier physique est 24 heures, le délai par défaut étant de 12 heures pour un poste de validation, d'invalidation ou d'annulation d'invalidation. Le délai de réexécution par défaut du poste DROP TABLE est de 1 heure, et de 5 minutes pour les autres postes de modification SQL de niveau objet.

Pour attribuer une valeur supérieure ou inférieure à ce réglage, ajoutez une variable d'environnement dénommée :

QIBM_JO_APPLY_ALTER_TABLE_TIMEOUT - poste modification de table (D CG)
QIBM_JO_APPLY_REFRESH_TABLE_TIMEOUT - poste régénération de table (D TQ)
QIBM_JO_APPLY_DROP_TABLE_TIMEOUT - poste suppression de table (F DM), poste suppression de fichier (D DT) et poste suppression de membre (F DM)
QIBM_JO_APPLY_REORG_TIMEOUT - poste réorganisation de fichier physique (F RM)
QIBM_JO_APPLY_TIMEOUT - pour tous les autres postes de modification de niveau objet
QIBM_JO_APPLY_CM_RB_CN_TIMEOUT - poste validation (C CM), invalidation (C RB), annulation d'invalidation (C CN)

La valeur de toutes les variables d'environnement est exprimée en secondes.

La valeur minimale pour n'importe laquelle de ces variables d'environnement est 60 secondes. Si une valeur inférieure à 60 est indiquée pour n'importe laquelle de ces variables d'environnement, une valeur de 60 secondes sera employée.

Ces variables d'environnement doivent figurer en majuscules et être définie avant l'exécution de la commande APYJRNCHGX.

Remarque :Les commandes de manipulation de variable d'environnement sont les suivantes : ADDENVVAR (ajout), CHGENVVAR (modification) et WRKENVVAR (gestion).

Pour obtenir la liste complète des différents postes et savoir comment ils sont gérés par cette commande (y compris les postes qui peuvent interrompre la commande), reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ Recherchez "actions d'application ou de retrait de modifications journalisées".

Pour des raisons de compatibilité, la liste des paramètres de APYJRNCHGX est quasi identique à celle de APYJRNCHG, mais les paramètres OBJ et OBJPATH ne sont pas disponibles. De plus, la spécification de fichiers et la spécification de membres sont limitées à library/*ALL et à *ALL respectivement.

Une unité d'exécution secondaire permet d'appliquer les modifications de niveau objet. L'application de certains postes de journal peut échouer si la valeur système QMLTTHDACN est fixée à 3 (*NORUN). La valeur de QMLTTHDACN recommandée lors d'une opération APYJRNCHGX est 2. L'état de l'unité d'exécution secondaire peut être contrôlé à l'aide de l'option 20 de la commande WRKJOB.

Les modifications journalisées sont appliquées depuis le point de départ indiqué (la dernière sauvegarde de l'objet ou un poste particulier du journal) jusqu'au point de fin. Le point de fin peut correspondre à l'endroit où toutes les modifications ont été effectuées dans l'objet, où la dernière restauration de l'objet a eu lieu, où un poste particulier a été atteint, où un délai prédéfini a expiré ou encore où l'objet a été ouvert ou fermé par un travail (Le paramètre CMTBDY permet de gérer les modifications en attente).

Remarque :Vous devez être attentif à la sélection de la plage de postes à appliquer en cas de suppression de fichiers avant la restauration de la bibliothèque de bases de données dans le cadre du scénario de reprise. Il faut garder à l'esprit que les postes de suppression de fichier ("DELETE FILES") seront appliqués s'ils figurent dans la plage indiquée. Dans ce cas, il est recommandé soit de spécifier un numéro de séquence de fin, soit d'effectuer la reprise à une date et une heure précises (condition préalable à toute opération de reprise).

Remarque :La commande DSPJRN (Afficher un journal) permet de déterminer les points de départ et/ou de fin.

Une liste d'objets journalisés peut être définie. Les modifications journalisées sont appliquées dans l'ordre des postes du journal, c'est-à-dire l'ordre dans lequel les modifications des objets ont été effectuées.

Comme pour la commande APYJRNCHG, les opérations de niveau enregistrement ne s'effectuent pas sous contrôle de validation. Cependant, les opérations de niveau objet précédemment réalisées sous contrôle de validation s'effectuent dans les mêmes conditions lors de l'application. Si la transaction de contrôle de validation a été validée initialement, les opérations de niveau objet seront validées lors de l'application du poste de validation correspondant. Si la transaction de contrôle de validation a été annulée initialement, les opérations de niveau objet seront annulées lors de l'application du poste d'annulation correspondant.

Si une erreur se produit lors de l'opération avant l'application effective du poste de validation ou d'annulation correspondant, toutes les opérations de niveau objet en attente sont validées ou annulées, selon que la transaction a été validée ou annulée initialement. Puisque les opérations de niveau objet en souffrance réalisées avant ce numéro de séquence risquent d'être annulées, il est important d'examiner attentivement le journal et de reprendre manuellement l'application de postes.

Si une annulation (ROLLBACK) est effectuée sur une opération de niveau objet en raison d'une condition d'erreur, le système risque de se trouver dans une situation où des modifications partielles de niveau enregistrement ont été appliquées et où certaines transactions ne se trouvent pas à une frontière de validation. Il convient alors d'examiner le journal attentivement et de poursuivre le traitement manuellement.

Par exemple, une transaction contient plusieurs insertions, suivies d'un ajout de colonne réalisé à l'aide d'une instruction ALTER TABLE, lui-même suivi de plusieurs insertions (de longueur différente aux premières) ; cette transaction se termine par une instruction ROLLBACK. Si l'opération d'application est interrompue immédiatement après l'instruction ALTER TABLE, le système, considérant que la transaction s'est terminée dans une opération ROLLBACK, annulerait l'opération ALTER TABLE. Dans ce cas, si l'application reprenait, le second jeu d'insertions échouerait en raison d'une discordance de longueurs d'enregistrement. Alors que ce scénario est improbable, il est important de comprendre les mécanismes sous-jacents de l'application, afin de poursuivre le traitement en cas d'erreur.

Si un poste code journal J type SI (correspondant à JRNSTATE(*STANDBY)) est trouvé, l'opération s'arrête pour tous les objets quelle que soit la valeur OBJERROPT indiquée. Il peut en résulter une mise à jour partielle d'objets à partir de postes de journal.

La commande peut également s'interrompre pour un objet précis lorsque les postes du journal contiennent des opérations qu'elle ne peut pas réexécuter. Si cette application rencontre d'autres modifications pour cet objet, celles-ci ne seront pas appliquées. En revanche, l'opération se poursuivra pour les autres objets indiqués si OBJERROPT(*CONTINUE) est indiqué. Par exemple, la commande prend fin pour un objet précis lorsqu'une des situations suivantes se vérifie pour un poste de journal :

Un membre de fichier base de données physique a été restauré.
La journalisation d'un fichier base de données physique s'est arrêtée.
Le système avait déjà appliqué ou retiré les modifications à l'aide de la commande APYJRNCHG, APYJRNCHGX ou RMVJRNCHG.

La commande s'interrompt également en présence de conditions illogiques. Par exemple, lors des opérations suivantes :

Ajout d'un enregistrement à un numéro relatif d'enregistrement existant pour un membre de fichier base de données
Ajout d'un enregistrement au-delà de la position de l'enregistrement suivant, après la fin du fichier base de données
Ajout d'un enregistrement comportant une clé en double pour un membre de fichier base de données
Tentative de suppression d'un enregistrement déjà supprimé pour un membre de fichier base de données
Mise à jour d'un enregistrement inexistant dans un membre de fichier base de données

La plupart de ces conditions illogiques surviennent lorsque l'application des modifications journalisées n'est pas démarrée au bon endroit du journal compte tenu du contenu des objets.

Si la commande s'arrête en raison de conditions illogiques mais qu'il est possible de relancer l'opération d'application, vous pouvez relancer la commande, en indiquant un nouveau numéro de séquence de début.

L'application des modifications reste possible lorsque les numéros de séquence ont été redéfinis. Le système envoie un message d'information et poursuit l'application des modifications.

Restrictions :

Cette commande est fournie avec le droit public *EXCLUDE et les profils utilisateur QPGMR et QSRV disposent des droits privés requis pour son utilisation.
Les modifications des objets indiqués dans cette commande doivent être journalisées.
Le contrôle de validation ne peut pas être actif dans le travail avant l'utilisation de cette commande.
Si un objet est restauré avant l'application des modifications, ce dernier doit avoir été journalisé lors de la sauvegarde.
Les objets indiqués dans la commande sont alloués exclusivement lors de l'application des modifications. Si un objet ne peut pas être alloué, la commande prend fin et aucune modification journalisée n'est appliquée.
Si aucun poste de journal ne correspond à la période indiquée dans la commande, cette dernière prend fin et aucune modification journalisée n'est appliquée.
Si les numéros de séquence des journaux ont été réinitialisés dans la plage de récepteurs définie et qu'un numéro de séquence est indiqué au paramètre FROMENT, FROMENTLRG, TOENT ou TOENTLRG, la première occurrence du numéro de séquence spécifié pour l'un des paramètres est utilisée.
Les paramètres TOJOBO et TOJOBC ne peuvent pas être utilisés pour indiquer quand doit prendre fin l'application des modifications journalisées si un ou plusieurs récepteurs de journal de la plage indiquée étaient attachés à un journal défini avec RCVSIZOPT (*MINFIXLEN).
Les paramètres TOJOBO et TOJOBC ne peuvent être utilisés si l'objet pour lequel des modifications sont mises en oeuvre n'étaient pas des postes d'ouverture et de fermeture d'enregistrement. Pour plus de détails, reportez-vous au paramètre OMTJRNE des commandes STRJRN, STRJRNPF, STRJRNLIB et CHGJRNOBJ.
Le nombre maximal d'objets pour lesquels des modifications peuvent être appliquées à l'aide de cette commande est de 12 000 000. Si les spécifications contiennent plus de 12 000 000 objets, un message d'erreur est émis et aucune modification n'est appliquée.
Cette limite inclut tout objet créé suite à l'application d'opérations de niveau objet. Si la limite est atteinte, le nouveau membre ne sera pas créé. A ce moment, l'application se termine pour l'objet ayant déclenché la création (d'un fichier base de données) ; tous les postes précédents sont appliqués. Si OBJERROPT(*CONTINUE) a été défini, l'application se poursuit pour d'autres membres du fichier et pour d'autres fichiers.

Lors de l'application de modifications d'un fichier base de données, un objet est associé à chaque membre et un objet supplémentaire l'est au fichier.
L'exécution de la commande APYJRNCHGX en vue d'appliquer des modifications en provenance d'un récepteur de journal avec des postes consignés à partir d'une autre édition (plus ancienne ou plus récente) peut avoir des résultats inattendus.
Il n'est pas possible d'utiliser la commande APYJRNCHGX pour appliquer des modifications en provenance de récepteurs de journal sur lesquels des postes de journal sont susceptibles de manquer suite au filtrage des objets journal éloigné ou au filtrage des programmes.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
JRN	Journal	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Journal	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
FILE	Nom du fichier journalisé	Values (jusqu'à 300 répétitions): Liste d'éléments	Obligatoire, positionnel 2
	Élément 1: Fichier physique journalisé	Nom d'objet qualifié
	Qualificatif 1: Fichier physique journalisé	*ALL
	Qualificatif 2: Biblio	Nom
	Élément 2: Membre	*ALL
RCVRNG	Plage de récepteurs de journal	Valeurs uniques: LASTSAVE, CURRENT Autres valeurs: Liste d'éléments	Facultatif, positionnel 3
	Élément 1: Début au récepteur de journal	Nom d'objet qualifié
	Qualificatif 1: Début au récepteur de journal	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 2: Fin au récepteur de journal	Valeurs uniques: CURRENT Autres valeurs: Nom d'objet qualifié*
	Qualificatif 1: Fin au récepteur de journal	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
FROMENTLRG	Premier num. séq. maxi	Valeur caractère, LASTSAVE, FIRST	Facultatif
TOENTLRG	Dern. num. séq. maxi	Valeur caractère, LASTRST, LAST	Facultatif
TOTIME	Date et heure de fin	Liste d'éléments	Facultatif
	Élément 1: Date de fin	Date
	Élément 2: Heure de fin	Heure
TOJOBO	Nom de travail qualifié	Nom de travail qualifié	Facultatif
	Qualificatif 1: Nom de travail qualifié	Nom
	Qualificatif 2: Utilisat	Nom
	Qualificatif 3: Numéro	000000-999999
TOJOBC	Nom de travail qualifié	Nom de travail qualifié	Facultatif
	Qualificatif 1: Nom de travail qualifié	Nom
	Qualificatif 2: Utilisat	Nom
	Qualificatif 3: Numéro	000000-999999
CMTBDY	Frontière de validation	YES, NO	Facultatif
OPTION	Option	NONE, IGNINQMSG	Facultatif
OBJERROPT	Option erreur objet	CONTINUE, END	Facultatif
OUTPUT	Sortie	NONE, OUTFILE	Facultatif
OUTFILE	Fichier recevant la sortie	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier recevant la sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTMBR	Options pour membre de sortie	Liste d'éléments	Facultatif
	Élément 1: Membre recevant la sortie	Nom, *FIRST
	Élément 2: Remplacement ou ajout enregs	REPLACE, ADD
DETAIL	Détail	ALL, ERR	Facultatif
FROMENT	Numéro de séquence de début	1-9999999999, LASTSAVE, FIRST	Facultatif
TOENT	Numéro de séquence de fin	1-9999999999, LASTRST, LAST	Facultatif

Journal (JRN)

Indique le journal associé aux postes à appliquer.

Ce paramètre est obligatoire.

Qualificatif 1 : Journal

nom-journal: Indique le nom du journal associé aux postes à appliquer.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le système effectue la recherche dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Nom du fichier journalisé (FILE)

Indique jusqu'à 300 postes de combinaisons bibliothèque/*ALL en cours d'application.

Ce paramètre est obligatoire.

Elément 1 : Fichier physique journalisé

Qualificatif 1 : Fichier physique journalisé

*ALL: La commande affecte tous les fichiers physiques de la bibliothèque indiquée dont les modifications sont enregistrées dans le journal indiqué. Le nom de la bibliothèque est obligatoire. Si *ALL est indiqué alors que l'utilisateur ne possède pas les droits requis sur au moins un fichier de la bibliothèque, un message est émis et l'application des modifications prend fin. Si l'utilisateur dispose d'un droit d'accès à un ou plusieurs fichiers dans la bibliothèque, l'opération d'application s'effectue sur tous ces fichiers.
Remarque :Le lancement de l'opération d'application est déterminé par l'existence d'au moins un fichier journalisé dans la bibliothèque (pour lequel l'utilisateur doit disposer d'un droit d'accès adéquat).

Qualificatif 2 : Biblio

nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Elément 2 : Membre

Entrez le nom du membre affecté par cette commande.

*ALL: La commande affecte tous les membres du fichier.

Plage de récepteurs de journal (RCVRNG)

Indique le début et la fin de la plage de récepteurs de journal utilisée pour l'application des modifications journalisées. Le système applique les modifications des récepteurs, en commençant par le premier, jusqu'à ce que la fin de la plage de récepteurs soit atteinte.

Remarque :Le nombre maximal de récepteurs pouvant être inclus dans une plage est égal à 2045. Si la plage contient plus de 2045 récepteurs, un message d'erreur est émis et aucune modification n'est appliquée. Vous pouvez modifier les valeurs de ce paramètre de manière à ne pas dépasser la limite admise.

Valeurs uniques

*LASTSAVE: La plage de récepteurs de journal est définie par le système, d'après les informations de sauvegarde des objets concernés par cette opération. Cette valeur n'est correcte que si *LASTSAVE est également spécifié pour le paramètre Numéro de séquence de début (FROMENT) et le paramètre Premier num. séq. maxi (FROMENTLRG).
*CURRENT: Le récepteur de journal en cours lors du démarrage de l'application des modifications journalisées est utilisé.

Elément 1 : Début au récepteur de journal

Qualificatif 1 : Début au récepteur de journal

nom-premier-récepteur: Indiquez le nom et la bibliothèque du premier récepteur de journal (le plus ancien).

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le récepteur de journal est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant le récepteur de journal.

Elément 2 : Fin au récepteur de journal

Qualificatif 1 : Fin au récepteur de journal

*CURRENT: Le récepteur de journal en cours lors du démarrage de l'application des modifications journalisées est utilisé.
nom-dernier-récepteur: Indiquez le nom du dernier récepteur de journal (le plus récent). Si la fin de la chaîne de récepteurs est atteinte sans que le récepteur n'ait été trouvé, aucune modification journalisée n'est appliquée et un message d'arrêt programme est émis.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le récepteur de journal est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque contenant le récepteur de journal.

Premier num. séq. maxi (FROMENTLRG)

Indique le poste utilisé comme point de départ pour l'application des modifications journalisées.

Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de début (FROMENT) ou le paramètre Premier num. séq. maxi (FROMENTLRG), jamais pour les deux.

*LASTSAVE

L'application des modifications journalisées s'effectue à partir du premier poste de journal existant depuis la dernière sauvegarde de l'objet. Le système détermine, pour tous les objets auxquels doit s'appliquer cette commande, le premier poste à traiter. Cette valeur implique que l'objet vienne juste d'être restauré.

Si la version restaurée de l'objet est issue d'une version sauvegardée à l'aide de la fonction de sauvegarde en mise à jour, le système appliquera les modifications du poste de début de sauvegarde qu'il s'agisse ou non de la dernière sauvegarde de l'objet. Lors de l'utilisation de la fonction de sauvegarde en mise à jour, les informations requises pour l'application des modifications journalisées sont sauvegardées avec l'objet et restaurées. Quand tous les objets spécifiés dans la commande d'application ont été restaurés à partir de sauvegardes ayant utilisé la fonction de sauvegarde en mise à jour, le système peut trouver les points de sauvegarde de ces objets sans devoir rechercher tous les récepteurs de journal. Ceci permet d'améliorer les performances du processus d'application.

Si la version restaurée de l'objet était une version sauvegardée alors qu'il n'était pas utilisé (il s'agit d'une sauvegarde normale), le système vérifie que les informations de chaque objet indiqué, telles que la date et l'heure de la restauration, sont postérieures à la date et à l'heure de la dernière sauvegarde. Il vérifie également que la date et l'heure de sauvegarde de l'objet restauré sur le système sont identiques à celles de sa dernière sauvegarde, comme indiqué dans le journal.

Si les dates et les heures ne correspondent pas, aucun poste n'est appliqué et un message d'interrogation (CPA7050) est envoyé à l'utilisateur ou à l'opérateur système pour lui demander d'annuler l'opération ou de ne pas la prendre en compte. Dans ce dernier cas, le système tente d'exécuter l'opération. En cas d'annulation, l'opération s'arrête et aucun poste de journal n'est appliqué.

Si la fonction de sauvegarde en mise à jour a été utilisée lors de la dernière sauvegarde de l'objet, la copie de sauvegarde de chacun des objets comporte toutes les modifications dans les postes du journal, jusqu'au poste de journal de début de sauvegarde correspondant. Dans ce cas, les modifications sont appliquées à partir du premier poste du journal situé après le poste de début de sauvegarde.

Si la dernière sauvegarde de l'objet a été effectuée alors que celui-ci n'était pas en cours d'utilisation (sauvegarde normale), la copie de sauvegarde de chacun des objets comporte toutes les modifications dans les postes du journal, jusqu'au poste de journal Objet sauvegardé. Dans ce cas, les modifications sont appliquées à partir du premier poste du journal situé après le poste Objet sauvegardé.

Remarque :*LASTSAVE doit être indiqué si des membres de fichiers base de données qui ont été sauvegardés avec *NOCMTBDY comme second élément du paramètre SAVACTWAIT (dans la commande de sauvegarde) se trouvent dans un état où des modifications journalisées doivent être appliquées. S'il n'est pas possible de compléter des transactions partielles à l'aide de modifications journalisées d'application, la commande RMVJRNCHG peut être employée pour retirer ces transactions. S'il n'est possible d'utiliser ni APYJRNCHG, ni RMVJRNCHG, et qu'aucune version du fichier ne peut être restaurée, la commande CHGJRNOBJ (Modifier un objet journalisé) permet, en dernier ressort, d'utiliser le fichier tout en conservant les transactions partielles dans l'objet.

*FIRST

L'application des modifications journalisées s'effectue à partir du premier poste de journal du premier récepteur défini pour cette commande.

numéro-séquence-début

Indiquez le numéro de séquence du premier poste de journal à appliquer. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Remarque :Lors de la saisie d'un numéro de séquence, évitez d'associer *LASTSAVE au paramètre Plage de récepteurs de journal (RCVRNG) et *LASTRST au paramètre Dern. num. séq. maxi (TOENTLRG).

Remarque :Concernant les postes de niveau objet du journal, le paramètre FROMENTLRG employé est le paramètre FROMENTLRG le plus ancien de n'importe quel membre de fichier de la liste de sélection existant lors du lancement de l'opération d'application.

Dern. num. séq. maxi (TOENTLRG)

Indique le poste utilisé comme point de fin pour l'application des modifications journalisées.

Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de fin (TOENT) ou le paramètre Dern. num. séq. maxi (TOENTLRG), jamais pour les deux.

*LASTRST

L'application des modifications journalisées se termine par le poste enregistré avant la dernière restauration de l'objet. Le système détermine, pour tous les objets auxquels doit s'appliquer cette commande, le dernier poste à traiter. Le système vérifie que la date et l'heure de la version restaurée de l'objet figurant sur le système correspondent à celles de la dernière restauration de l'objet indiquées dans le journal. Si les dates et les heures ne correspondent pas, aucun poste n'est appliqué et un message d'interrogation (CPA7075) est envoyé à l'utilisateur ou à l'opérateur système pour lui demander d'annuler l'opération ou de ne pas la prendre en compte. Dans ce dernier cas, le système tente d'exécuter l'opération. En cas d'annulation, l'opération s'arrête et aucun poste de journal n'est appliqué.

Si un objet est créé partir de modifications appliquées à un autre, le dernier point d'application du nouvel objet correspond au dernier point le plus important de tous les objets concernés.

Cette valeur n'est correcte que si *LASTSAVE est également spécifié pour le paramètre Numéro de séquence de début (FROMENT) ou pour le paramètre Premier num. séq. maxi (FROMENTLRG). *LASTRST est pris par défaut si aucun des paramètres suivants n'est indiqué :

Date et heure de fin (TOTIME),
Nom de travail qualifié (TOJOBO),
Nom de travail qualifié (TOJOBC).

*LAST

L'application des modifications journalisées s'effectue jusqu'au dernier poste de journal du dernier récepteur de la plage indiquée.

numéro-séquence-fin

Indique le numéro de séquence du dernier poste appliqué. La plage de valeurs admises s'étend de 1 à 18 446 744 073 709 551 600.

Remarque :Concernant les postes de niveau objet du journal, le paramètre TOENTLRG employé est le plus récent de n'importe quel membre de fichier de la liste de sélection existant lors du lancement de l'opération d'application.

Date et heure de fin (TOTIME)

Indique l'heure et la date de la dernière modification journalisée appliquée. Le premier poste rencontré correspondant à l'heure et à la date indiquées ou affecté d'une heure immédiatement postérieure marque la fin de cette opération.

Vous pouvez indiquer l'heure au format 24 heures avec ou sans séparateur :

Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes et ss = secondes.
Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres en insérant entre les heures, les minutes et les secondes le séparateur défini pour votre travail. Si vous entrez cette commande à partir de la ligne de commande, placez la chaîne entre apostrophes. Si vous utilisez un séparateur d'heure autre que celui qui a été défini pour votre travail, la commande n'aboutira pas.

Elément 1 : Date de fin

date: Indiquez une date de fin.

Elément 2 : Heure de fin

heure: Indiquez l'heure de fin.

Nom de travail qualifié (TOJOBO)

Indique l'identificateur du travail qui, en ouvrant un objet donné, met fin à l'application des modifications journalisées par cette commande. Le premier poste d'ouverture de travail identifié pour l'un des objets spécifiés constitue le point de fin de tous les objets spécifiés.

Le paramètre TOJOBO ne peut être utilisé si l'objet pour lequel des modifications sont mises en oeuvre n'étaient pas des postes d'ouverture et de fermeture d'enregistrement. Pour plus de détails, reportez-vous au paramètre OMTJRNE des commandes STRJRN, STRJRNPF, STRJRNLIB et CHGJRNOBJ.

identificateur-travail

Indiquez le nom du travail, le nom de l'utilisateur et le numéro du travail à utiliser. Vous pouvez également spécifier uniquement le nom du travail ou les noms du travail et de l'utilisateur.

nom-travail: Indiquez le nom du travail.
nom-utilisateur: Indiquez le nom de l'utilisateur du travail.
numéro-travail: Indiquez le numéro de travail attribué par le système.

Nom de travail qualifié (TOJOBC)

Indique l'identificateur du travail qui met fin à l'application des modifications journalisées par cette commande. Le premier poste de fermeture de travail identifié pour l'un des objets spécifiés constitue le point de fin de tous les objets spécifiés. Voici les causes possibles de l'interruption :

Le travail indiqué ferme un objet spécifié.
Le travail indiqué est interrompu.

Le paramètre TOJOBC ne peut être utilisé si l'objet pour lequel des modifications sont mises en oeuvre n'étaient pas des postes d'ouverture et de fermeture d'enregistrement. Pour plus de détails, reportez-vous au paramètre OMTJRNE des commandes STRJRN, STRJRNPF, STRJRNLIB et CHGJRNOBJ.

identificateur-travail

Indiquez le nom du travail, le nom de l'utilisateur et le numéro du travail à utiliser. Vous pouvez également spécifier uniquement le nom du travail ou les noms du travail et de l'utilisateur.

nom-travail: Indiquez le nom du travail.
nom-utilisateur: Indiquez le nom de l'utilisateur du travail.
numéro-travail: Indiquez le numéro de travail attribué par le système.

Frontière de validation (CMTBDY)

Indique si les frontières de validation sont respectées lorsque les postes de journal auxquels les modifications doivent être appliquées font partie d'une unité d'oeuvre logique de contrôle de validation (LUW). Pour plus d'informations sur le contrôle de validation, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Dans la description de ce paramètre, l'option TO sert à décrire le paramètre indiqué, à savoir TOENT, TOTENTLRG, TOTIME, TOJOBO ou TOJOBC.

*YES

Les modifications journalisées sont appliquées du poste indiqué au paramètre FROMENT ou FROMENTLRG au poste spécifié par l'option TO, en tenant compte des frontières de validation.

Si le poste de journal indiqué au paramètre FROMENT ou FROMENTLRG se trouve à l'intérieur de l'unité d'oeuvre logique dont il fait partie, un message d'erreur est émis et l'opération n'est pas effectuée.
Si le poste de journal indiqué par l'option TO se trouve à l'intérieur de l'unité d'oeuvre logique dont il fait partie, l'opération s'arrête à la frontière de validation précédant ce poste. Un message de diagnostic est envoyé à la fin de l'opération et enregistré dans tout fichier de sortie généré.

Remarque :Si un poste de journal provoque l'arrêt de l'opération avant que le poste indiqué par l'option TO ne soit traité, il se peut que les frontières de validation ne soient pas respectées. En outre, toute opération de niveau objet en attente est soit validée, soit annulée, en fonction du poste type CM ou RB code C inscrit dans le journal pour cette transaction. Il peut en résulter l'application d'une transaction partielle, et les frontières de validation risquent de ne pas être atteintes. Si un poste C/CM ou C/RB est introuvable dans le journal, les opérations de niveau objet sont annulées.

*NO

Les modifications journalisées sont appliquées du poste indiqué au paramètre FROMENT ou FROMENTLRG au poste spécifié par l'option TO, quelles que soient les frontières de validation. Par conséquent, l'opération est effectuée même si un poste de cette plage fait partie d'une unité d'oeuvre logique.

Remarque :Si CMTBDY(*NO) est indiqué alors qu'un objet appliqué a été restauré à partir d'une version sauvegardée contenant des transactions partielles, les modifications en attente pour celles-ci ne seront pas retirées si les transactions ne se réalisent pas dans la plage indiquée. Les modifications en attente d'origine ainsi que toute nouvelle modification pour la transaction partielle seront conservées dans l'objet à la fin de l'opération d'application. L'objet ne sera utilisable que si toutes les transactions en attente s'effectuent dans la plage indiquée.

Remarque :Même si CMTBDY(*NO) est indiqué, le contrôle de validation est employé lors de l'application des opérations de niveau objet. Ceci n'affecte en rien la plage de postes de journal sélectionnée. En outre, toute opération de niveau objet en attente est soit validée, soit annulée, en fonction du poste type C/CM ou C/RB pour cette transaction.

Option (OPTION)

Indique si l'application de modifications de journal doit être précédée d'un contrôle supplémentaire.

*NONE: Tous les contrôles de protection sont réalisés avant l'application de modifications de journal.
*IGNINQMSG: Le message d'interrogation est ignoré. Les messages d'interrogation CPA7050 et CPA7075 ne s'affichent pas même si l'objet en cours d'application n'est pas issu de la dernière sauvegarde ou de la dernière restauration de l'objet. L'opération d'application se poursuit.

Option erreur objet (OBJERROPT)

Indique comment les postes de journal doivent être traités en cas d'erreur.

*CONTINUE: Tout poste de journal d'un objet spécifique qui ne peut être traité entraîne l'arrêt du traitement des postes restants de cet objet. En revanche, le traitement des postes des autres objets se poursuit. Un message de diagnostic indique l'échec du traitement des modifications journalisées de cet objet. S'il y a lieu, la fin prématurée du traitement d'un objet est également ajoutée à tout enregistrement du fichier de sortie.
*END: Quand le traitement échoue pour un poste de journal, il s'arrête pour tous les objets restants.

Sortie (OUTPUT)

Indique si une liste d'informations sur les objets auxquels des modifications ont été appliquées est créée. Les informations peuvent être dirigées vers un fichiers base de données.

*NONE: Aucun fichier base de données n'est créé avec la sortie. L'historique des travaux reçoit les messages correspondant aux 512 premiers objets.
*OUTFILE: Les informations en sortie relative à l'opération d'application seront dirigées vers le fichier base de données indiqué dans le paramètre Fichier recevant la sortie (OUTFILE)
Remarque :Le nom du fichier base de données est obligatoire avec le paramètre Fichier recevant la sortie (OUTFILE) lorsque OUTPUT(*OUTFILE) est indiqué.

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données vers lequel les informations sont dirigées lorsque *OUTFILE est indiqué au paramètre Sortie (OUTPUT). Si le fichier n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée. Si un fichier est créé, le système utilise QAJRNCHG de QSYS avec le nom de format QJOAPYRM comme modèle.

Qualificatif 1 : Fichier recevant la sortie

nom-fichier-base-de-données: Indiquez le nom du fichier base de données devant recevoir la sortie de la commande. Si le fichier n'existe pas, il est créé dans la bibliothèque indiquée.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le système effectue la recherche dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base données vers lequel est dirigé la sortie lorsque *OUTFILE est précisé à l'invite Sortie (paramètre OUTPUT).

Elément 1 : Membre recevant la sortie

*FIRST: Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).
nom: Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si ce membre n'existe pas, il est créé par le système.
Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou le mettre à blanc, puis ajouter les enregistrements.

Elément 2 : Remplacement ou ajout enregs

*REPLACE: Les enregistrements existant dans le membre du fichier base de données indiqué sont remplacés par les nouveaux enregistrements.
*ADD: Les nouveaux enregistrements sont ajoutés aux données existant déjà dans le membre de fichier base de données indiqué.

Détail (DETAIL)

Indique le type des informations dirigées vers le fichier de sortie.

*ALL: Le fichier contiendra des informations relatives à la commande et un poste pour chaque objet ayant fait l'objet d'une application dans un journal selon qu'il existait au moment du lancement de la commande d'application ou qu'il a été créé pendant le processus d'application.
*ERR: Le fichier contiendra des informations sur la commande, un poste seulement pour chaque objet dont l'application a réussi. Si le processus d'application s'est terminé prématurément pour un objet, un poste correspondant sera ajouté dans le journal.

Numéro de séquence de début (FROMENT)

Indique le poste utilisé comme point de départ pour l'application des modifications journalisées.

Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de début (FROMENT) ou le paramètre Premier num. séq. maxi (FROMENTLRG), jamais pour les deux.

*LASTSAVE

*FIRST

L'application des modifications journalisées s'effectue à partir du premier poste de journal du premier récepteur défini pour cette commande.

numéro-séquence-début

Indiquez le numéro de séquence du premier poste de journal à appliquer. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Remarque :Lors de la saisie d'un numéro de séquence, évitez d'associer *LASTSAVE au paramètre Plage de récepteurs de journal (RCVRNG) et *LASTRST au paramètre Numéro de séquence de fin (TOENT).

Remarque :Concernant les postes de niveau objet du journal, le paramètre FROMENT employé est le plus ancien de n'importe quel membre de fichier de la liste de sélection existant lors du lancement de l'opération d'application.

Numéro de séquence de fin (TOENT)

Indique le poste utilisé comme point de fin pour l'application des modifications journalisées.

Vous pouvez indiquer une valeur pour le paramètre Numéro de séquence de fin (TOENT) ou le paramètre Dern. num. séq. maxi (TOENTLRG), jamais pour les deux.

*LASTRST

Si un objet est créé partir de modifications appliquées à un autre, le dernier point d'application du nouvel objet correspond au dernier point le plus important de tous les objets concernés.

Date et heure de fin (TOTIME),
Nom de travail qualifié (TOJOBO),
Nom de travail qualifié (TOJOBC).

*LAST

L'application des modifications journalisées s'effectue jusqu'au dernier poste de journal du dernier récepteur de la plage indiquée.

numéro-séquence-fin

Indique le numéro de séquence du dernier poste appliqué. La plage de valeurs admises s'étend de 1 à 9 999 999 999.

Remarque :Concernant les postes de niveau objet du journal, le paramètre TOENT employé est le plus récent de n'importe quel membre de fichier de la liste de sélection existant lors du lancement de l'opération d'application.

Exemples

Exemple :

 APYJRNCHGX   JRN(MYCOLL/QSQJRN)  FILE(MYCOLL/*ALL)

Cette commande ordonne au système d'appliquer toutes les modifications journalisées à tous les fichiers de la collection MYCOLL depuis la dernière sauvegarde. La plage de récepteurs est fixée par le système. Les modifications sont appliquées en commençant par la première modification journalisée sur la chaîne de récepteurs après la dernière mise à jour de chaque fichier, puis l'opération se poursuit avec tous les postes de journal applicables jusqu'au point de dernière restauration de ces fichiers.

L'opération inclut tous les postes de niveau objet (c'est-à-dire CREATE/DROP/ALTER TABLE) de la collection MYCOLL. En raison de l'utilisation de la valeur par défaut du paramètre CMTBDY, *YES, les frontières de contrôle de validation sont honorées.

Messages d'erreur

Messages *ESCAPE

CPFA0D4: Une erreur s'est produite dans le système de fichiers. Code erreur &1.
CPF69A9: Erreur interne détectée, code raison &2.
CPF69AA: Impossible de faire référence à l'objet &1 sauvegardé avec STG(*FREE).
CPF69AB: Valeurs du paramètre RCVRNG incorrects.
CPF70A4: Application de modifications journalisées non admise pour le récepteur indiqué.
CPF70A7: Certains postes n'ont pas été appliqués ou retirés pour au moins un objet.
CPF70A8: Le fichier &1 de la bibliothèque &2 n'est pas utilisable.
CPF70AA: FROMENT(*LASTSAVE) doit être indiqué.
CPF70AB: Récepteur de journal &1 de &2 non trouvé.
CPF70B7: Appliquez ou enlevez les modifications journalisées qui ne sont pas admises pour le récepteur indiqué.
CPF70CC: Impossible d'effectuer l'opération au-delà du poste &7.
CPF70CD: Impossible d'effectuer l'opération au-delà du poste &7.
CPF70CE: Impossible d'effectuer l'opération au-delà du poste &7.
CPF70EB: Erreur de contrainte référentielle sur le membre &3.
CPF70EC: Erreur de contrainte référentielle. Code raison &9.
CPF70EE: Nombre maximal de chemins d'accès à vecteur encodé pour le membre &3.
CPF7002: Le fichier &1 de la bibliothèque &2 n'est pas un fichier physique.
CPF7003: Poste non journalisé dans &1. Code raison &3.
CPF7006: Membre &3 non trouvé dans le fichier &1 de &2.
CPF7007: Impossible d'allouer membre &3 du fichier &1 de &2.
CPF701B: Le rétablissement par journal d'une opération interrompue a échoué.
CPF704A: Longueur d'enregistrement incorrecte pour le membre &3.
CPF704F: Paramètre TOJOBO ou TOJOBC incompatible avec la plage de valeurs du récepteur.
CPF7041: Poste non trouvé pour le travail &3/&2/&1.
CPF7042: Objet non journalisé ou journalisé dans un journal différent.
CPF7044: L'application ou le retrait de postes journalisés a échoué, code raison &7.
CPF7045: Récepteur de journal &1 de &2 partiellement endommagé.
CPF7046: Clé en double non admise pour le membre &3.
CPF7047: Le membre &3 du fichier &1 de &2 est plein.
CPF7048: Impossible d'effectuer modifications journalisées sur membre &3.
CPF7049: Impossible d'effectuer l'opération au-delà du poste &7.
CPF705A: Echec de l'opération car journal éloigné.
CPF7050: Date de LASTSAVE différente de celle de la version restaurée de l'objet *&4.
CPF7051: Poste de sauvegarde pour l'objet &6 non trouvé.
CPF7052: Erreur de sélection/omission dans fichier logique sur membre &3.
CPF7053: Valeurs du paramètre RCVRNG incorrectes. Code raison &1.
CPF7054: Valeurs des paramètres FROM et TO incorrectes.
CPF7057: *LIBL n'est pas admis avec *ALL, *ALLLIB ou un nom générique.
CPF7058: Application ou retrait de postes journalisés a échoué.
CPF7059: Poste pour &1 non trouvé dans RCVRNG.
CPF7063: Impossible d'utiliser le fichier &1 comme OUTFILE.
CPF7067: Option FROMENTLRG ou FROMENT incorrecte. Violation de la frontière de validation.
CPF7068: Poste nécessaire pour application ou enlèvement non trouvé.
CPF7069: Aucun poste du journal &1 appliqué ou enlevé.
CPF7075: Date de restauration de l'objet *&4 différente de celle indiquée dans le journal.
CPF7076: Poste de restauration de l'objet *&6 non trouvé dans RCVRNG.
CPF7077: Erreur de mappage de clé sur membre &3.
CPF7078: Impossible d'appliquer ou d'enlever les modifications pour membre &3.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9809: Accès à la bibliothèque &1 impossible.
CPF9810: Bibliothèque &1 non trouvée.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9822: Non autorisé au fichier &1 de &2.
CPF9825: Accès non autorisé à l'unité &1.
CPF9860: Erreur lors du traitement du fichier de sortie.