RGZPFM

La commande RGZPFM (Réorganiser un membre de fichier physique) enlève les enregistrements supprimés d'un membre de fichier physique base de données et le réorganise éventuellement.

Si un fichier avec clé est indiqué au paramètre Fichier avec clé (KEYFILE), le système reconnaît le membre en modifiant la séquence physique des enregistrements dans la mémoire de telle sorte qu'elle corresponde soit à la séquence par clé du chemin d'accès du membre de fichier physique, soit au chemin d'accès d'un membre de fichier logique défini dans le fichier physique. La réorganisation peut réduire le temps de traitement de fichiers lorsqu'un programme procède à une lecture séquentielle sur un fichier physique ou logique avec clé.

Lorsqu'un membre est réorganisé et que KEYFILE(*NONE) n'est pas indiqué, la séquence réelle du stockage des enregistrements est modifiée et les enregistrements supprimés sont enlevés du fichier. Si KEYFILE(*NONE) est indiqué ou utilisé par défaut, cette séquence ne change pas, mais les enregistrements supprimés sont enlevés du membre. Facultativement, de nouveaux numéros de séquence et des zones de date zéro sont placés dans les zones source des enregistrements. Ces zones sont modifiées une fois le membre comprimé ou réorganisé.

Remarques :

• Si cette commande est annulée, le système reconstruit tous les chemins d'accès qui ne sont pas gérés lors de la réorganisation. Si ALWCANCEL(*NO) est indiqué, toutes les mises à jour de membre de fichier physique dont le chemin d'accès est unique sont interdites tant que le chemin d'accès n'est pas complètement rétabli.
• Si cette commande est annulée et que ALWCANCEL(*YES) est indiqué, la réorganisation s'exécute partiellement. Par la suite, une autre réorganisation comportant les mêmes paramètres peut continuer au stade où la dernière réorganisation a pris fin.
• La commande RGZPFM ignore toute substitution de fichier en cours pour le travail. Les noms de fichiers indiqués aux paramètres FILE et KEYFILE identifient les fichiers réellement concernés par la réorganisation, quelles que soient les substitutions éventuelles demandées pour ces fichiers.

Restrictions :

• Durant la réorganisation du membre physique, le fichier réorganisé fait l'objet d'un verrouillage. Le paramètre Etat de verrouillage (LOCK) peut être précisé pour déterminer le niveau d'accès simultané au membre de fichier physique devant être admis.
• Vous devez disposer du droit d'opération, de gestion ou de modification de l'objet et de tous les droits sur les données pour le fichier physique contenant le membre à réorganiser, et du droit d'exécution sur la bibliothèque. Vous devez également disposer du droit d'opération sur le fichier indiqué au paramètre KEYFILE, et du droit d'exécution sur la bibliothèque qui le contient.
• Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution protégées pour les fichiers répartis. Elle échoue dans le cas de fichiers répartis utilisant une base de données relationnelle de type *SNA. C'est également le cas pour les fichiers DDM (Gestion de fichiers éloignés) de type *SNA.

Paramètres

Fichier base de données (FILE)

Indique le fichier physique dont le membre doit être réorganisé.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier base de données

nom

Indiquez le nom du fichier physique.

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

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours, la bibliothèque QGPL est utilisée.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Membre (MBR)

Indique le membre à réorganiser.

*FIRST

Réorganise le premier ou l'unique membre du fichier.

*LAST

Réorganise le dernier ou l'unique membre du fichier.

nom

Entrez le nom du membre à réorganiser.

Fichier avec clé (KEYFILE)

Indique si la séquence par clé est substituée à l'ordre d'arrivée des enregistrements du membre de fichier physique, si ce membre est réorganisé suivant la séquence par clé d'un membre de fichier logique correspondant ou s'il n'est pas réorganisé. Si ce paramètre indique un membre de fichier logique comportant plusieurs formats, vous devez aussi définir le paramètre Format d'enregistrement (RCDFMT).

Remarque :Vous ne pouvez pas indiquer un fichier logique joint ou un index SQL avec une clause WHERE en tant que fichier comportant un chemin d'accès par clé. Un fichier logique spécifié par ce paramètre ne peut pas comporter un chemin d'accès de sélection/omission.

Valeurs uniques

*NONE

Le membre n'est pas réorganisé ; il est uniquement comprimé, les enregistrements supprimés étant enlevés.

*RPLDLTRCD

Le membre est réorganisé via le remplacement des enregistrements supprimés du début du fichier par des enregistrements corrects de la fin du fichier. Si les enregistrements doivent correspondre exactement à l'ordre d'arrivée en cours, n'utilisez pas *RPLDLTRCD.

*FILE

Dans le cas d'un membre de fichier physique comportant un chemin d'accès par clé, la séquence par clé se substitue à l'ordre d'arrivée des enregistrements du membre.

Elément 1 : Fichier logique

Indiquez le nom et la bibliothèque du fichier logique associé au membre du fichier physique.

Qualificatif 1 : Fichier logique

nom-fichier

Entrez le nom du fichier logique à utiliser comme fichier avec clé.

Qualificatif 2 : Biblio

*LIBL

La recherche s'effectue dans toutes les bibliothèques de la liste des bibliothèques du travail, jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Elément 2 : Membre

nom

Indiquez le membre du fichier logique dont la séquence est utilisée pour réorganiser le membre du fichier physique.

Reconstruire chemins accès (RBDACCPTH)

Indique si les chemins d'accès corrects (autres qu'un chemin d'accès indiqué comme chemin d'accès KEYFILE ou MAINT(*REBLD)) doivent être rétablis ou maintenus sur le membre.

*YES

Les chemins d'accès sont rétablis de façon synchrone à la fin de l'opération de réorganisation.

*OPTIMIZE

Les chemins d'accès sont soit rétablis de façon asynchrone à la fin de l'opération de réorganisation, soit maintenus au cours de la réorganisation, en fonction de la méthode de rétablissement la plus rapide des chemins d'accès.

*NO

Les chemins d'accès sont maintenus lors de la réorganisation.

Si *NO est indiqué, ALWCANCEL(*YES) doit également être indiqué.

Autoriser annulation (ALWCANCEL)

Indique si l'annulation de la réorganisation doit être admise.

*NO

La réorganisation ne peut pas être annulée. Si le travail prend fin et que la réorganisation des données n'est pas terminée, toutes les modifications apportées avant l'incident sont ignorées.

Si *NO est indiqué, KEYFILE(*RPLDLTRCD) et RDBACCPTH(*NO) ne doivent pas être précisés et LOCK(*EXCL) doit également être indiqué.

*YES

La réorganisation peut être annulée. Si une réorganisation est annulée avant qu'elle soit terminée, une réorganisation ultérieure comportant les mêmes paramètres continue généralement l'opération au stade où celle-ci avait pris fin. Si le nombre de modifications apportées depuis l'annulation de la réorganisation est trop élevé, la réorganisation risque de redémarrer et non de continuer.

Etat de verrouillage (LOCK)

Indique le verrou à acquérir sur le membre de fichier physique. L'état du verrou détermine le niveau d'accès simultané admis par d'autres travaux lors de la réorganisation.

*EXCL

Un verrou exclusif est acquis. Aucun accès simultané au membre de fichier physique n'est admis à partir d'un autre travail.

*EXCLRD

Un verrou exclusif en lecture est acquis. L'accès simultané en lecture au membre de fichier physique est admis à partir d'un autre travail.

Si *EXCLRD est indiqué, ALWCANCEL(*YES) doit également être indiqué.

*SHRUPD

Un verrou partagé en mise à jour est acquis. L'accès simultané en mise à jour, en suppression et en insertion au membre de fichier physique est admis à partir d'un autre travail.

Si *SHRUPD est choisi, l'ordre résultant des enregistrements risque de ne pas correspondre exactement à ce qui a été demandé avec le mot clé KEYFILE. Les enregistrements vont être réorganisés de manière à correspondre de près à l'ordre indiqué ; cependant, du fait des opérations de mise à jour, de suppression et d'insertion simultanées, certains enregistrements ne seront pas réorganisés. Si les enregistrements doivent correspondre exactement à l'ordre d'arrivée (*NONE) ou à une séquence de fichier avec clé, n'utilisez pas *SHRUPD.

A la fin de la réorganisation, une opération est tentée afin de retirer les enregistrements supprimés à la fin du fichier et de renvoyer le stockage au système. Si *SHRUPD est spécifié, il se peut qu'une insertion simultanée se produise juste avant le retrait des enregistrements supprimés et empêche l'exécution de cette opération pour l'ensemble ou une partie des enregistrements supprimés à la fin du fichier. Dans ce cas, le mot clé FROMRCD peut être utilisé sur une réorganisation suivante afin de tenter de retirer les enregistrements supprimés sans réorganiser la totalité du fichier.

Si *SHRUPD est indiqué, ALWCANCEL(*YES) doit également être indiqué.

Remarque :Pour plus de détails sur les états de verrouillage, reportez-vous au manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

A partir de l'enregistrement (FROMRCD)

Indique les enregistrements du fichier à réorganiser. Seuls les enregistrements de l'enregistrement spécifié à la fin du fichier seront réorganisés.

*START

Tous les enregistrements du fichier seront réorganisés.

*PRVRGZ

Si la précédente opération de réorganisation de ce fichier n'a pas pu retirer certains ou l'ensemble des enregistrements supprimés, la réorganisation commence à partir de l'enregistrement qui aurait été le dernier enregistrement du fichier si le retrait des enregistrements supprimés n'avait pas été empêché par une insertion simultanée.

Si la précédente opération de réorganisation s'est terminée normalement et que tous les enregistrements supprimés ont été retirés, la réorganisation commence à partir du premier enregistrement contenu dans le fichier.

*PRVRGZ n'est pas pris en compte si l'opération de réorganisation se poursuit à partir d'une opération de réorganisation qui a été annulée.

Si *PRVRGZ est indiqué, ALWCANCEL(*YES) doit également être spécifié, ainsi que KEYFILE(*RPLDLTRCD) ou KEYFILE(*NONE).

1 à 4294967288

Indique le numéro du premier enregistrement à réorganiser.

Si un numéro d'enregistrement supérieur à 1 est spécifié, ALWCANCEL(*YES) doit être indiqué, ainsi que KEYFILE(*RPLDLTRCD) ou KEYFILE(*NONE).

Options de mise à jour source (SRCOPT)

Dans le cas de fichiers physiques source, indique si de nouveaux numéros doivent être placés dans la zone numéro de séquence, si des zéros doivent figurer dans la zone date, ou s'il faut modifier ces deux zones. Ces modifications interviennent après que les enregistrements aient été comprimés ou réorganisés.

Valeurs uniques

*SAME

Les zones Numéro de séquence et Date des enregistrements ne changent pas.

Autres valeurs

*SEQNBR

Un nouveau numéro est placé dans la zone de numéro de séquence des enregistrements. Une valeur de début et un incrément sont indiqués pour le paramètre SRCSEQ.

*DATE

Une chaîne de zéros (000000) est placée dans la zone Date de chaque enregistrement.

Numérotation du source (SRCSEQ)

Indique, uniquement si *SEQNBR est également précisé pour le paramètre SRCOPT, le numéro de séquence attribué au premier enregistrement du membre du fichier source et la valeur d'incrément utilisée pour renuméroter tous les autres enregistrements du membre. Si le membre est renuméroté sans que ce paramètre ait été défini, la valeur par défaut du numéro de séquence et de l'incrément est 1.00.

Elément 1 : Numéro de séquence de début

1.00

Le numéro de séquence du premier enregistrement du membre source est 0001.00.

0.01 à 9999.99

Indiquez le numéro de séquence du premier enregistrement du membre source. Vous pouvez entrer un nombre entier de 4 chiffres au plus ou un nombre décimal ne comportant pas plus de deux positions décimales. Dans ce dernier cas, un symbole décimal doit être utilisé.

Elément 2 : Incrément

1.00

Les enregistrements source sont numérotés de nouveau, dans le membre, avec des nombres entiers incrémentés de 1 (par exemple, 1.00, 2.00, 3.00...).

0.01 à 9999.99

Indiquez la valeur d'incrément utilisée pour renuméroter tous les enregistrements du membre source à partir du premier enregistrement. Vous pouvez indiquer un nombre entier de quatre chiffres au plus ou un nombre décimal ne comportant pas plus de deux positions décimales. Dans ce dernier cas, vous devez utiliser un symbole décimal.

Par exemple, si SRCSEQ(5000 10) est indiqué, le premier enregistrement du membre réorganisé porte le numéro 5000.00, le deuxième 5010.00, le troisième 5020.00, et ainsi de suite. Si vous spécifiez SRCSEQ(*N .25), les enregistrements sont numérotés 1.00, 1.25, 1.50, 1.75, 2.00, et ainsi de suite. Si vous indiquez la valeur de début .01 et l'incrément .01, il existe 999999 numéros de séquence uniques possibles. Si le numéro de séquence le plus élevé, 9999.99, est atteint, tous les enregistrements restants portent ce même numéro.

Format d'enregistrement (RCDFMT)

Indique le nom du format d'enregistrement lorsque le membre du fichier physique est réorganisé suivant la séquence d'un fichier logique à formats multiples.

*ONLY

Le fichier logique indiqué par le paramètre Fichier avec clé (KEYFILE) ne comporte qu'un seul format d'enregistrement. Ce format est utilisé pour réorganiser le membre du fichier physique.

nom

Indiquez le nom du format d'enregistrement du fichier logique à formats multiples, utilisé pour réorganiser le membre du fichier physique.

Exemples

Exemple 1 : Réorganisation via la suppression d'enregistrements

RGZPFM   FILE(PAYROLL)  MBR(MBR1)

Cette commande comprime le membre MBR1 du fichier PAYROLL en en retirant les enregistrements supprimés.

Exemple 2 : Réorganisation via le remplacement des enregistrements supprimés

RGZPFM   FILE(PAYROLL)  MBR(MBR1)  KEYFILE(*RPLDLTRCD)
         ALWCANCEL(*YES)  LOCK(*EXCLRD)

Cette commande comprime le membre MBR1 eu fichier PAYROLL en remplaçant les enregistrements supprimés du début du fichier par des enregistrements corrects de la fin du fichier. La commande peut être annulée et d'autres travaux sont autorisés à lire des données du fichier PAYROLL lorsque la réorganisation est en cours.

Exemple 3 : Réorganisation d'une séquence par clé

RGZPFM   FILE(QCLSRC)  MBR(CLMBR2)  SRCOPT(*SEQNBR *DATE)
         KEYFILE(*FILE)  SRCSEQ(1.00 .25)

Cette commande permet de réorganiser le membre CLMBR2 du fichier source CL QCLSRC en séquence par clé, avec la zone de numéro de séquence utilisée comme clé. Le membre réorganisé comporte de nouveaux numéros de séquence (commençant par 1.00 et augmentant par incrément de 0.25) et une chaîne de zéros (000000) est placée dans tous les enregistrements lorsque le membre d'origine est réorganisé.

Messages d'erreur

Messages *ESCAPE

CPF2981

Membre &3 du fichier &1 de &2 non réorganisé.

CPF3135

Chemin d'accès au membre &2 en cours d'utilisation.

CPF32B8

Erreur de fichier réparti. Code raison &3.

CPF32CF

Erreur de fichier réparti. Code raison &3.

CPF32C3

Erreur au niveau du fichier réparti, identificateur de niveau de fichier non concordant

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9809

Accès à la bibliothèque &1 impossible.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

Messages *NOTIFY

CPF2985

Numéros de séquence de source supérieurs au maximum admis. (G C)