CRTPF

La commande CRTPF (Créer un fichier physique) crée un fichier physique à partir des informations fournies et (éventuellement) des spécifications de description de données (DDS) contenues dans un fichier source.

Un fichier physique est un fichier base de données qui contient des enregistrements de données. Ceux-ci sont regroupés dans des membres, chaque membre possédant son propre chemin d'accès aux données. En règle générale, les fichiers base de données n'ont qu'un seul membre qui, par défaut, est ajouté au fichier lors de sa création. Aucun fichier source DDS n'est requis si le fichier physique concerné contient un format d'enregistrement comportant une seule zone caractère dans la séquence d'arrivée ou s'il s'agit d'un fichier source. Pour substituer les attributs du fichier une fois celui-ci créé, utilisez avant de l'ouvrir la commande OVRDBF (Substituer un fichier BD). Pour modifier les attributs du fichier une fois celui-ci créé, utilisez la commande CHGPF (Modifier un fichier physique).

Restrictions :

• Cette commande est à unités d'exécution protégées sous certaines conditions. Dans le cas de travaux à unités d'exécution multiples, cette commande n'admet pas l'utilisation d'unités d'exécution multiples pour les fichiers répartis. Elle échoue dans le cas de fichiers répartis utilisant une base de données relationnelle de type *SNA.

Paramètres

Fichier (FILE)

Indique le fichier physique à créer.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier physique à créer.

Qualificateur 2: Biblio

*CURLIB

Le fichier est recherché dans la bibliothèque en cours pour le travail. Si aucune bibliothèque n'est identifiée en tant que bibliothèque en cours pour le travail, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le fichier.

Fichier source (SRCFILE)

Indique le fichier source qui contient les DDS décrivant le format d'enregistrement et ses zones, ainsi que le chemin d'accès du fichier et des membres. Les manuels Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ et Rubriques DDS de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ décrivent les spécifications indiquées dans les DDS.

Remarque :Si une valeur est indiquée pour ce paramètre, une valeur doit également être précisée pour le paramètre Longueur d'enregistrement (RCDLEN).

Qualificatif 1 : Fichier source

QDDSSRC

Le fichier source DDS appelé QDDSSRC contient les descriptions source utilisées pour la création du fichier physique.

nom

Indiquez le nom du fichier source contenant les DDS utilisées pour créer le fichier physique.

Qualificateur 2: Biblio

*CURLIB

Le fichier est recherché dans la bibliothèque en cours pour le travail. Si aucune bibliothèque n'est identifiée en tant que bibliothèque en cours pour le travail, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le fichier.

Membre source (SRCMBR)

Indique le nom du membre du fichier source contenant les DDS source du fichier physique à créer. Ce membre se trouve dans le fichier source indiqué au paramètre SCRCFILE (ou sa valeur par défaut, QDDSSRC). Si SRCMBR est précisé, RCDLEN ne peut pas l'être.

*FILE

Le nom du membre du fichier source est identique à celui du fichier physique indiqué pour le paramètre Fichier (FILE).

nom

Indiquez le nom du membre dans le fichier source.

Longueur d'enregistrement (RCDLEN)

Indique (en octets) la longueur des enregistrements contenus dans le fichier physique. Si RCDLEN et FILETYPE(*DATA) sont spécifiés, ce dernier est créé avec un format d'enregistrement ne contenant qu'une zone. Le fichier est dans ce cas limité à un chemin d'accès en ordre d'arrivée. Le nom du fichier (défini au paramètre FILE) est attribué au format d'enregistrement et à la zone. Les valeurs de longueur d'enregistrement admises sont comprises entre 1 et 32766 octets.

Si RCDLEN et FILETYPE(*SRC) sont indiqués, le format d'enregistrement contient trois zones : numéro de séquence source, date et instruction source. Le paramètre RCDLEN doit définir six positions pour le numéro de séquence source, six positions pour la zone de date et une position pour le début du source (obligatoires pour chaque enregistrement). Ces zones sont définies à l'aide d'attributs et de noms fixes. Tout enregistrement copié dans le fichier à l'aide de la commande CPYF est tronqué à droite si sa longueur est supérieure à celle spécifiée.

Si RCDLEN est indiqué, SRCFILE et SRCMBR ne peuvent pas l'être. RCDLEN permet de spécifier une longueur fixe pour le format d'enregistrement lorsqu'aucun fichier source n'est requis (soit parce que chaque enregistrement ne contient qu'une zone, soit parce que le fichier créé est un fichier source). Les zones contenues dans l'enregistrement doivent être décrites dans le programme de langage évolué qui traite le fichier.

Considérations DBCS

Si IGCDTA(*NO) est indiqué, la zone reçoit le type de données caractère, dont la longueur est identique à la longueur d'enregistrement indiquée. Une valeur comprise entre 1 et 32766 octets peut être indiquée pour la longueur d'enregistrement. Si IGCDTA(*YES) est indiqué, la zone reçoit le type de données DBCS ouvert et une valeur comprise entre 4 et 32766 peut être indiquée. If IGCDTA(*NO) is specified, the field is assigned the data type of character whose length is the same as the record length specified. A value ranging from 1 to 32766 bytes can be specified for the record length. If IGCDTA(*YES) is specified, the field is assigned the data type of DBCS-open and a value ranging from 4 to 32766 can be specified.

Le paramètre RCDLEN doit fournir six positions pour le numéro de séquence source, six positions pour la zone de date et quatre positions pour le début du source lorsque FILETYPE(*SRC) est spécifié.

entier

Indiquez le nombre d'octets dans chaque enregistrement.

Niveau gravité pour génération (GENLVL)

Indique le niveau de gravité à partir duquel l'opération de création échoue. Si des erreurs de niveau de gravité équivalent ou supérieur se produisent, l'opération s'arrête.

Ce paramètre ne concerne que les messages créés lors du traitement des fichiers source DDS.

20

Si, lors du traitement du fichier source DDS, des erreurs d'un niveau de gravité supérieur ou égal à 20 se produisent, le fichier n'est pas créé.

0-30

Indiquez le niveau de gravité désiré. Si 0 est indiqué, le fichier n'est pas créé. La valeur indiquée doit être supérieure ou égale à celle précisée pour le paramètre Niveau gravité pour marquage (FLAG).

Niveau gravité pour marquage (FLAG)

Indique le niveau de gravité minimal des messages à lister.

0

Tous les messages sont listés.

0-30

Indiquez un chiffre donnant la gravité minimale des messages à lister. La valeur indiquée doit être supérieure ou égale à celle précisée pour le paramètre Niveau gravité pour génération (GENLVL).

Type de fichier (FILETYPE)

Indique si chaque membre du fichier physique à créer contient des enregistrements de type données ou source (instructions), pour un programme ou un autre fichier. Le fichier peut contenir, par exemple, des instructions source RPG pour un programme RPG ou des instructions source DDS pour un autre fichier physique, logique ou d'unité.

*DATA

Le fichier physique contient des enregistrements de données.

*SRC

Le fichier physique contient des enregistrements source.

Membre (MBR)

Indique le nom du membre ajouté lors de la création du fichier physique.

*FILE

Le nom du membre est identique à celui du fichier physique à créer.

*NONE

Aucun membre de fichier physique n'est ajouté lors de la création du fichier.

nom

Entrez le nom du membre de fichier physique à ajouter dans le nouveau fichier.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

\nRemarque : Ce paramètre n'a aucune signification pour les fichiers physiques créés à l'aide de DDS, car l'utilisation de données DBCS est indiquée dans les DDS. Remarque :This parameter has no meaning for physical files created using DDS, because the use of DBCS data is specified in the DDS.

*NO

Le fichier ne contient pas de données de jeu de caractères sur deux octets (DBCS). The file does not contain double-byte character set (DBCS) data.

*YES

Le fichier contient des données DBCS. The file contains DBCS data.

Considérations DBCS

Si l'utilisateur crée un fichier physique et indique le paramètre RCDLEN, le système crée un format d'enregistrement par défaut. If the user creates a physical file and specifies the RCDLEN parameter, the system creates a default record format.

• Si IGCDTA(*YES) est indiqué, le format d'enregistrement par défaut peut contenir des données DBCS (comme si l'enregistrement était indiqué avec le type de données DBCS ouvert (O en colonne 35 de la spécification DDS)). If IGCDTA(*YES) is specified, the default record format can contain DBCS data (as if the record were specified with the DBCS-open (O in column 35 of DDS specification) data type).
• Si IGCDTA(*NO) est indiqué, le format d'enregistrement par défaut ne peut pas contenir de données DBCS (comme si l'enregistrement était indiqué avec le type de données caractère (A ou blanc en colonne 35 de la spécification DDS)). If IGCDTA(*NO) is specified, the default record format cannot contain DBCS data (as if the record were specified with the character (A or blank in column 35 of DDS specification) data type).

Le système ignore la valeur du paramètre IGCDTA si aucune valeur n'est indiquée pour le paramètre RCDLEN. The system ignores the IGCDTA parameter value if a value for the RCDLEN parameter is not specified.

L'utilisateur ne peut pas remplacer temporairement la valeur IGCDTA d'un fichier physique. The user cannot override the IGCDTA value for a physical file.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SRCMBRTXT

Le texte provient du membre source utilisé pour la création du fichier physique. Si le fichier source est un fichier base de données, le texte provient du membre source. Il est possible d'ajouter ou de modifier du texte pour un membre source base de données à l'aide de l'utilitaire SEU (Source Entry Utility) ou en exécutant soit la commande ADDPFM, soit la commande CHGPFM. Si le fichier source est un fichier spoule en entrée ou un fichier unité, le texte est à blanc.

*BLANK

Aucun texte n'est spécifié.

valeur-alphanumérique

Tapez un texte d'au plus 50 caractères, entre apostrophes.

Options pour liste source (OPTION)

Indique le type de sortie généré lors de la création du fichier. Pour ce paramètre, quatre valeurs au maximum, parmi celles décrites ci-après, peuvent être indiquées, dans n'importe quel ordre. Pour une option, si aucune des deux valeurs n'est précisée ou si les deux sont indiquées, la première valeur listée est utilisée.

Remarque :Les premières valeurs de chaque option sont semblables à des valeurs par défaut, mais comme elles n'en sont pas vraiment, elles ne peuvent pas être modifiées à l'aide de la commande CHGCMDDFT (Modifier une valeur par défaut de commande).

Option de liste source

*SRC ou *SOURCE

Impression des instructions source et des erreurs éventuelles.

*NOSRC ou *NOSOURCE

Pas d'impression des instructions source, sauf si des erreurs sont détectées. Dans ce cas, elles sont imprimées en même temps que le mot clé ou le format d'enregistrement qui a causé l'erreur.

Option de liste de programme

*LIST

Impression d'une liste source détaillée des spécifications du fichier et des références à d'autres descriptions de fichier.

*NOLIST

L'impression du source étendu n'est pas créée.

Option Texte de message de deuxième niveau

*NOSECLVL

La section messages de la sortie imprimée des DDS (Spécifications de description de données) ne contient pas les informations d'aide en ligne pour les messages générés pendant le traitement des DDS.

*SECLVL

Les informations d'aide en ligne figurent dans la sortie imprimée des DDS.

Option de création de fichier événements

*NOEVENTF

Le compilateur ne crée pas de fichier événements pour le produit Environnement développement coopératif (CODE).

*EVENTF

Le compilateur crée un fichier événements utilisable par le produit CODE. Ce fichier est créé en tant que membre du fichier EVFEVENT de votre bibliothèque objet. CODE a recours à ce dernier pour offrir la fonction de suivi des erreurs intégrée à son éditeur. Cette valeur est normalement indiquée par CODE pour votre compte.

Système (SYSTEM)

Indique le système (local ou éloigné) sur lequel le fichier physique est créé.

*LCL

Le fichier physique est créé sur le système local.

*RMT

Le fichier physique est créé sur un système éloigné. Le fichier indiqué pour le paramètre Fichier (FILE) doit être le nom d'un fichier DDM qui identifie le système éloigné et le nom du fichier physique en cours de création.

*FILETYPE

Si le fichier spécifié pour le paramètre FILE n'existe pas sur le système, le fichier physique est créé sur le système local. Dans le cas contraire, le fichier doit être un fichier DDM, et le fichier physique est créé sur un système éloigné. Le fichier DDM identifie le système éloigné et le nom du fichier physique à créer.

Date d'expiration du membre (EXPDATE)

Indique la date de péremption des membres du fichier physique.

*NONE

Aucune date d'expiration n'est spécifiée.

date

Indiquez la date après laquelle le membre de fichier ne pourra plus être utilisé. Cette date doit être indiquée entre apostrophes si des caractères de séparateur de date sont utilisées dans la valeur.

Nombre maximal de membres (MAXMBRS)

Indique le nombre maximal de membres que le fichier physique peut contenir.

1

Le fichier physique ne peut contenir qu'un seul membre.

*NOMAX

Le nombre de membres pouvant être contenus dans le fichier est le nombre maximal admis par le système (32767).

1 à 32767

Indiquez le nombre maximal de membres pouvant être contenus dans le fichier physique.

Taille du chemin d'accès (ACCPTHSIZ)

Indique la taille maximale de la mémoire secondaire pouvant être occupée par les types de chemins d'accès suivants :

• Chemins d'accès associés à un fichier physique comportant une séquence de chemin d'accès par clé.
• Chemins d'accès créés pour les contraintes référentielles ou uniques.

Ce paramètre ne s'applique pas aux chemins d'accès créés pour des fichiers logiques ou pour des requêtes liées aux données d'un fichier physique.

*MAX1TB

Les chemins d'accès associés à ce fichier peuvent occuper un maximum de seize téraoctets (17 000 000 000 000 bytes) de mémoire secondaire.

*MAX4GB

Les chemins d'accès associés à ce fichier peuvent occuper un maximum de quatre gigaoctets (4 294 967 296 octets) de mémoire secondaire.

Taille page logique chem accès (PAGESIZE)

Indique la taille de page logique de chemin d'accès utilisée lors de la création du chemin d'accès.

La taille de page logique de chemin d'accès est utilisée par le système pour déterminer la taille de chaque page de l'index. La taille de page logique est le nombre d'octets du chemin d'accès pouvant être placés dans le pool de stockage du travail depuis la mémoire secondaire pour un défaut de page.

*KEYLEN

La taille de page logique de chemin d'accès sera déterminée par la longueur totale de la clé ou des clés. La taille de page logique minimum est de 32 ko.

8

Cette valeur n'est plus prise en charge et sera interprétée comme 32 ko. Elle est strictement conservée pour des raisons de compatibilité syntaxique.

16

Cette valeur n'est plus prise en charge et sera interprétée comme 32 ko. Elle est strictement conservée pour des raisons de compatibilité syntaxique.

32

La taille de page logique est de 32 ko.

64

La taille de page logique est de 64 ko.

128

La taille de page logique est de 128 ko.

256

La taille de page logique est de 256 ko.

512

La taille de page logique est de 512 ko.

Maintenance chemin d'accès (MAINT)

Indique, pour les fichiers comportant des zones clés, le type de maintenance de chemin d'accès utilisé pour tous les membres du fichier physique.

*IMMED

Le chemin d'accès est mis à jour chaque fois qu'un enregistrement est modifié, ajouté, ou supprimé d'un membre. *IMMED doit être spécifié pour les fichiers qui n'acceptent que les clés uniques.

*REBLD

Le chemin d'accès est complètement reconstruit chaque fois qu'un membre est ouvert et il est maintenu jusqu'à ce que le membre soit refermé. Le chemin d'accès est alors supprimé. *REBLD ne peut être spécifié pour les fichiers qui n'acceptent que les clés uniques.

*DLY

La maintenance du chemin d'accès est différée jusqu'à la prochaine ouverture du membre. Le chemin d'accès est alors modifié pour les seuls enregistrements ajoutés, supprimés ou modifiés depuis dernière ouverture du fichier. Pendant que le fichier est ouvert, toute modification apportée à un membre sous-jacent est immédiatement reportée dans le chemin d'accès par clé du membre, quelle que soit la valeur indiquée pour le paramètre MAINT. Pour éviter que la reconstruction dure trop longtemps, n'indiquez *DLY que si le nombre de modifications apportées au chemin d'accès est peu élevé entre une opération de fermeture et l'opération d'ouverture suivante. *DLY n'est pas admis pour les chemins d'accès requérant des valeurs de clé unique.

Si le nombre des modifications apportées entre une opération de fermeture et l'opération d'ouverture suivante atteint environ 10% de la taille du chemin d'accès, le système cesse de sauvegarder les modifications et le chemin d'accès est entièrement reconstruit lors de l'ouverture suivante du fichier.

Rétablissement chemin d'accès (RECOVER)

Indique à quel moment doit être exécuté le rétablissement du fichier, suite à un incident système survenu en cours de modification du chemin d'accès. Ce paramètre ne concerne que les fichiers dont la maintenance du chemin d'accès est immédiate ou différée. Ce paramètre ne concerne que les fichiers à chemin d'accès par clé.

Si le paramètre Maintenance chemin d'accès (MAINT) a pour valeur *IMMED, le chemin d'accès peut être reconstruit pendant l'IPL (avant qu'aucun travail ne soit exécuté par un utilisateur), après l'IPL (simultanément à l'exécution de travaux) ou lors de l'ouverture suivante du fichier. Le fichier ne peut pas être utilisé par un travail lors du rétablissement du chemin d'accès.

Pendant l'IPL, l'écran REVISION RECONSTRUCTION DES CHEMINS D'ACCES s'affiche. Il contient la liste des chemins d'accès qui doivent faire l'objet d'un rétablissement et, pour chacun d'entre eux, la valeur à indiquer pour le paramètre RECOVER. A partir de cet écran, vous pouvez substituer la valeur du paramètre RECOVER. Le manuel Reprise du système, SC41-5304 fournit plus de détails sur les chemins d'accès.

Si le paramètre MAINT a pour valeur *REBLD, le chemin d'accès est reconstruit lors de l'ouverture suivante du fichier.

*NO

Le chemin d'accès du fichier est reconstruit à l'ouverture du fichier. *NO est la valeur par défaut pour tous les fichiers qui ne requièrent pas de clés uniques. Si le chemin d'accès du fichier est incorrect, il est reconstruit lors de l'ouverture suivante du fichier.

Remarque :*NO est la valeur par défaut pour tous les fichiers qui ne requièrent pas de clés uniques.

*AFTIPL

Le chemin d'accès du fichier est reconstruit une fois l'IPL terminé. Cette option permet aux autres travaux (n'utilisant pas ce fichier) de démarrer immédiatement après la fin de l'IPL. Si un travail tente d'allouer le fichier pendant la reconstruction de son chemin d'accès, une erreur d'ouverture de fichier se produit.

Remarque :*AFTIPL est la valeur par défaut pour chaque fichier requérant une clé unique.

*IPL

Le chemin d'accès du fichier est reconstruit au cours de l'IPL. Ainsi, la reconstruction est terminée dès la première tentative d'utilisation du chemin d'accès par un programme utilisateur. Cependant, aucun travail ne peut démarrer tant que les chemins d'accès de tous les fichiers indiquant RECOVER(*IPL) n'ont pas été reconstruits.

Forcer chemin d'accès sur clé (FRCACCPTH)

Indique, pour les fichiers comportant des zones clés, si les modifications du chemin d'accès sont forcées en mémoire secondaire en même temps que les enregistrements associés du fichier. La valeur FRCACCPTH(*YES) permet de réduire (mais non d'éviter complètement) les risques d'endommagement d'un chemin d'accès dont la reconstruction est requise pour un travail suite à une fin anormale de celui-ci.

*NO

Le chemin d'accès et les enregistrements associés ne sont pas obligatoirement écrits en mémoire secondaire chaque fois que le chemin d'accès est modifié.

*YES

Le chemin d'accès et les enregistrements associés sont obligatoirement écrits en mémoire secondaire chaque fois que le chemin d'accès est modifié. La valeur *YES ne peut être utilisée ici si *REBLD est également spécifié pour le paramètre Maintenance chemin d'accès (MAINT).

FRCACCPTH(*YES) ralentit le temps de réponse du système si le chemin d'accès est modifié dans un travail interactif. S'il est fréquemment modifié, les performances globales du système sont affectées.

Taille du membre (SIZE)

Indique le nombre d'enregistrements initial dans chaque membre du fichier, le nombre d'enregistrements de chaque incrément ajouté au membre, et le nombre d'incrémentations automatiques. Le nombre d'enregistrements indiqué pour chaque membre du fichier représente le nombre d'enregistrements que le membre peut contenir (y compris, le cas échéant, ceux qui sont supprimés).

Lorsque le nombre maximal d'enregistrements est atteint, un message informant que le membre est plein est envoyé à l'opérateur système, qui choisit alors soit de mettre fin à la demande, soit d'augmenter le nombre d'enregistrements du membre. Lorsque l'opérateur choisit d'agrandir le membre, le nombre maximal d'enregistrements de ce membre sera augmenté du nombre d'incrémentations des enregistrements multiplié par le nombre d'incrémentations indiqué. Toutefois, cette augmentation du nombre maximal d'enregistrements n'aura pas toujours le même effet sur la taille du membre actuelle (en octets).

Valeurs uniques

*NOMAX

Le nombre d'enregistrements pouvant être ajoutés à chaque membre n'est pas limité par l'utilisateur. Le nombre maximal d'enregistrements de chaque membre est déterminé par le système. Si *NOMAX est spécifié, *NO doit être entré pour le paramètre Allocation mémoire secondaire (ALLOCATE).

Elément 1 : Nombre initial d'enreg

Indiquez le nombre initial d'enregistrements contenus dans chaque membre.

10000

Initialement, 10 000 enregistrements peuvent être écrits dans chaque membre du fichier.

1 à 2147483646

Indiquez le nombre d'enregistrements pouvant être écrits dans chaque membre du fichier avant que la taille du membre ne soit automatiquement augmentée.

Elément 2 : Valeur d'incrément

Indiquez le nombre d'enregistrements supplémentaires ajoutés au membre lorsque le nombre d'enregistrements qu'il contient dépasse le nombre initial d'enregistrements ou le nombre d'enregistrements de l'incrément actuel.

1000

Le nombre maximal d'enregistrements est augmenté de 1 000 enregistrements.

entier

Indiquez le nombre d'enregistrements supplémentaires qui doivent être ajoutés au membre.

Si 0 est indiqué pour le nombre d'incréments de la valeur d'enregistrements, le membre n'est pas automatiquement agrandi. Cette valeur doit être 0 si la valeur du nombre maximal d'incréments est égale à 0.

Elément 3 : Nombre maximal d'incréments

Indiquez le nombre maximal d'incréments pouvant être ajoutés automatiquement au membre.

3

3 incréments au maximum seront ajoutés automatiquement aux membres.

entier

Indiquez le nombre maximum d'incréments pouvant être ajoutés automatiquement au membre. Ce nombre doit être compris entre 0 et 32767. Si 0 est indiqué, le membre n'est pas agrandi automatiquement.

Allocation mémoire secondaire (ALLOCATE)

Indique si un espace mémoire initial doit être alloué pour chaque membre de fichier physique ajouté au fichier. Cette allocation fournit un espace suffisant pour le nombre d'enregistrements indiqué dans le paramètre Taille du membre (SIZE). Les allocations qui se produisent lorsqu'un membre ne peut pas être ajouté à un membre sans dépasser sa capacité sont déterminées par le système et par les valeurs du paramètre SIZE.

*NO

Le système détermine la quantité d'espace mémoire à allouer à chaque membre ajouté au fichier.

*YES

La quantité d'espace mémoire spécifiée dans la première valeur du paramètre SIZE est allouée chaque fois qu'un nouveau membre est ajouté. Si *YES est indiqué, *NOMAX ne peut être spécifié pour le paramètre SIZE.

Mémoire secondaire contiguë (CONTIG)

Indique, pour chaque membre de fichier physique ajouté au fichier, si les enregistrements contenus dans l'espace alloué initialement sont stockés de façon contiguë.

*NO

Le stockage des enregistrements ne doit pas nécessairement être contigu.

*YES

L'espace contenant les enregistrements permet le stockage contigu des enregistrements. Si ceux-ci doivent être séparés, le membre est ajouté et un message est envoyé à l'utilisateur pour lui signifier que le stockage contigu des enregistrements n'est pas disponible.

Choix unité stockage second (UNIT)

Indique le support de stockage préférentiel pour le fichier.

*ANY

Pas de support de stockage préférentiel. La mémoire est allouée à partir de n'importe quel support de stockage disponible.

*SSD

Un support de stockage de type disque électronique est à utiliser préférentiellement. La mémoire peut être allouée à partir d'un support de ce type, si disponible.

entier

Toute valeur comprise entre 1 et 254 équivaut à indiquer *ANY. La valeur 255 équivaut à indiquer *SSD.

Nb enreg forcés en écriture (FRCRATIO)

Indique le nombre d'enregistrements insérés ou mis à jour qui sont traités avant d'être forcés en mémoire secondaire. Si ce fichier physique est en cours de journalisation, un nombre élevé ou la valeur *NONE doit être indiqué. L'indication de *NONE risque d'augmenter la durée de synchronisation du journal et des fichiers physiques.

*NONE

Il n'y a pas de taux de forçage indiqué. C'est le système qui détermine quand les enregistrements sont écrits en mémoire secondaire.

entier

Indiquez le nombre d'enregistrements insérés ou mis à jour qui sont traités avant d'être écrits en mémoire secondaire.

Temps d'attente maxi fichier (WAITFILE)

Indique le délai d'attente (en secondes) par le programme pour l'allocation des ressources fichier lors de l'ouverture du fichier, ou pour l'allocation des ressources unité ou session lors de l'exécution d'une opération d'acquisition sur le fichier. Si les ressources fichier ne peuvent pas être allouées dans le délai spécifié, le système envoie un message d'erreur au programme.

30

Le programme attend 30 secondes pour l'allocation des ressources du fichier.

*IMMED

Le programme n'attend pas. Une allocation immédiate des ressources est requise.

*CLS

Le délai d'attente par défaut du travail est utilisé pour l'allocation des ressources du fichier.

1 à 32767

Indiquez, en secondes, le délai d'attente possible pour l'allocation des ressources du fichier.

Temps d'attente maxi enreg (WAITRCD)

Indique le temps, en secondes, pendant lequel le programme attend pour modifier ou supprimer un enregistrement. Si l'enregistrement ne peut être alloué dans le temps imparti, un message d'erreur est envoyé au programme.

60

Le programme attend pendant 60 secondes la modification ou la suppression d'un enregistrement.

*IMMED

Aucun délai d'attente n'est prévu pour le programme ; lorsqu'un enregistrement est verrouillé, son allocation doit être immédiate.

*NOMAX

Le délai d'attente est le délai maximal admis par le système (32767 secondes).

1 à 32767

Précisez, en secondes, le temps d'attente maximal du programme pour la modification ou la suppression d'un enregistrement.

Partage chemin d'ouverture (SHARE)

Indique si le chemin d'ouverture (ODP) est partagé avec d'autres programmes dans la même phase d'activation. Dans l'affirmative, les programmes accédant au fichier partagent des fonctions telles que l'état du fichier et la mémoire tampon.

Remarque :Ce paramètre ne peut pas être spécifié lorsque *NONE l'a été pour le paramètre Membre (MBR).

*NO

Le chemin d'ouverture (ODP) n'est pas partagé avec d'autres programmes au cours de cette phase d'activation. Un nouvel ODP est créé pour le fichier et utilisé chaque fois qu'un programme ouvre ce fichier.

Un nouveau chemin d'ouverture (ODP) est créé et utilisé chaque fois qu'un programme ouvre le fichier pour lequel la valeur *NO est indiquée à ce paramètre.

*YES

Le même chemin d'ouverture est partagé par tous les programmes du travail pour lequel *YES a été également indiqué lors de l'ouverture du fichier.

% maxi d'enreg supprimés admis (DLTPCT)

Indique le pourcentage maximum d'enregistrements supprimés pour chaque membre du fichier physique. Ce pourcentage est vérifié lors de la fermeture du membre. S'il dépasse la valeur spécifiée dans ce paramètre, un message est envoyé à l'historique du système (QHST) pour vous en informer.

*NONE

Le pourcentage d'enregistrements supprimés du fichier n'est pas vérifié.

1 à 100

Indiquez le pourcentage maximum admis d'enregistrements supprimés pour chaque membre du fichier.

Réutilisation enreg supprimés (REUSEDLT)

Indique si l'espace libéré par des entrées supprimées peut être récupéré par des demandes d'insertion ultérieures.

Remarques :

• Si *YES est indiqué dans ce paramètre, l'attribut de séquence de clé pour le fichier physique dans le source DDS (Spécifications de description de données) ne peut pas être de type "FIFO" ou "LIFO".
• Si ce paramètre a pour valeur *YES, l'ordre d'arrivée cesse d'être significatif pour un fichier qui ré-utilise l'espace d'enregistrements supprimés. Les enregistrements peuvent ne plus être ajoutés à la fin du fichier.

*NO

Le fichier ne récupère pas l'espace libéré par les enregistrements supprimés.

*YES

Le fichier récupère l'espace libéré par les enregistrements supprimés.

Séquence de tri (SRTSEQ)

Indique la séquence de tri utilisée pour ce fichier. Elle est employée avec les paramètres LANGID et CCSID afin de déterminer la table de séquence de tri correspondante.

Valeurs uniques

*SRC

La table indiquée au mot clé ALTSEQ dans la spécification de description de données (DDS) est utilisée. Si ALTSEQ n'est pas utilisé dans les DDS, utilisez la valeur précisée pour *JOB dans ce paramètre.

*JOB

La séquence de tri utilisée est la même que celle du travail ayant émis la commande de création du fichier physique.

*LANGIDSHR

La table de séquence de tri peut contenir le même poids pour plusieurs caractères. Il s'agit de la table à poids partagés associée à la langue indiquée au paramètre LANGID.

*LANGIDUNQ

La table de séquence de tri doit contenir un poids unique pour chacun des caractères de la page de codes.

*HEX

Aucune table de séquence de tri n'est utilisée. Les valeurs hexadécimales des caractères servent à définir la séquence de tri.

Qualificatif 1 : Séquence de tri

nom

Indiquez le nom de la table de séquence de tri.

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

La recherche s'effectue dans la bibliothèque en cours pour le travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

nom

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

Identificateur de langue (LANGID)

Indique l'identificateur de langue utilisé lorsque *LANGIDSHR ou *LANGIDUNQ est précisé au paramètre SRTSEQ. L'identificateur de langue est utilisé avec les paramètres SRTSEQ et CCSID pour déterminer la table de séquence de tri utilisée par le fichier.

*JOB

L'identificateur de langue indiqué pour le travail est utilisé.

valeur-alphanumérique

Indiquez un identificateur de langue. Pour afficher la liste complète des identificateurs à l'invite de la commande, placez le curseur sur la zone de ce paramètre et appuyez sur F4 (Invite).

ID codé de jeu de caractères (CCSID)

Indique le CCSID utilisé pour décrire les données alphanumériques des zones du fichier.

Ce paramètre n'est applicable que si aucune valeur n'est indiquée pour le paramètre Fichier source (SRCFILE) et si une valeur est précisée pour le paramètre Longueur d'enregistrement (RCDLEN). Si vous indiquez une valeur autre que celle qui apparaît par défaut (*JOB) pour ce paramètre, le paramètre SRCFILE n'est pas utilisé et une valeur doit être définie pour le paramètre RCDLEN.

Remarque :Un fichier créé sans DDS et pour lequel FILETYPE(*DATA) est indiqué, a un CCSID de 65535, quelle que soit la valeur de CCSID du travail.

*JOB

Le CCSID par défaut du travail en cours est utilisé.

*HEX

Le CCSID 65535 est utilisé, ce qui signifie que les données alphanumériques des zones sont traitées comme des données binaires et ne sont pas converties.

entier

Indiquez le CCSID à utiliser. Le manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/ fournit plus de détails sur les CCSID.

Opération mise à jour admise (ALWUPD)

Indique si les enregistrements de ce fichier physique peuvent être mis à jour.

*YES

Les enregistrements du fichier physique peuvent être mis à jour.

*NO

Les enregistrements de ce fichier physique, ou de tout fichier logique qui y accède, ne peuvent pas être mis à jour.

Opération suppression admise (ALWDLT)

Indique si les enregistrements de ce fichier physique peuvent être supprimés. Dans un fichier logique, ils ne peuvent l'être que s'ils le sont également dans le fichier physique sous-jacent au fichier logique.

*YES

Les enregistrements de ce fichier physique peuvent être supprimés.

*NO

Les enregistrements de ce fichier physique, ou de n'importe quel fichier logique qui y accède, ne peuvent être supprimés.

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement du fichier physique sont vérifiés lors de l'ouverture du fichier par un programme.

*YES

Les identificateurs de niveau des formats d'enregistrement sont vérifiés. S'ils ne correspondent pas tous, un message d'erreur est envoyé au programme qui a demandé l'ouverture.

*NO

Les identificateurs de niveau ne sont pas vérifiés lors de l'ouverture du fichier.

Groupe de noeuds (NODGRP)

Indique un groupe de noeuds sur lequel le fichier doit être réparti.

Valeurs uniques

*NONE

Le fichier n'est pas réparti et les données associées se trouvent sur le système local.

Qualificatif 1 : Groupe de noeuds

nom

Indiquez le nom du groupe de noeuds associé à ce fichier.

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

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.

nom

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

Clé de partitionnement (PTNKEY)

Indique la zone ou l'ensemble de zones servant de clé de partitionnement pour la répartition des données. Vous pouvez indiquer jusqu'à 300 noms de zone.

Remarque :Ce paramètre ne doit pas être utilisé si *NONE est indiqué pour le paramètre Groupe de noeuds (NODGRP). Si un nom de groupe de noeuds est précisé pour le paramètre NODGRP, un ou plusieurs noms de zone doivent être indiqués.

nom

Indiquez le nom de la zone à inclure dans la clé de partitionnement.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

Exemple 1 : Création d'un fichier physique

CRTPF   FILE(PAYLIB/PAYTXS)  SRCFILE(SRCLIB/PAYTXS)
        MBR(*NONE)  MAXMBRS(5)

Cette commande permet de créer un fichier physique appelé PAYTXS dans la bibliothèque PAYLIB. Celui-ci est créé à l'aide des descriptions source figurant dans le membre PAYTXS de la bibliothèque SRCLIB. Il est créé sans aucun membre (la valeur *NONE a été indiquée) ; aucune donnée ne peut donc être placée dans le fichier tant qu'un membre n'a pas été ajouté ultérieurement. Le fichier peut contenir jusqu'à cinq membres.

Par défaut, chaque membre de fichier ajouté ultérieurement contient des enregistrements de données. Le chemin d'accès de chaque membre est géré en continu. Chaque membre peut posséder jusqu'à 10 000 enregistrements avant que des extensions automatiques (trois incréments maximum) ajoutent 1000 enregistrements à la capacité du membre. L'espace de stockage de chaque membre est alloué uniquement selon les besoins. Il peut être contigu ou non. Aucune mémoire initiale n'est allouée. Le public dispose de droits d'opération, de lecture, d'ajout, de suppression et de mise à jour sur le fichier.

Exemple 2 : Création d'un fichier physique et d'un membre

CRTPF   FILE(ORDERCTL/ORDERS)  SRCFILE(ORDERCTL/ORDERSRC)
        SRCMBR(MFGORD)  MAXMBRS(50)  SIZE(1000 100 5)
        ALLOCATE(*YES)

Cette commande permet de créer dans la bibliothèque ORDERCTL un fichier physique et un membre de fichier physique, tous les deux appelés ORDERCTL. Le fichier et son membre sont créés à partir du membre source MFGORD du fichier source ORDERSRC qui figure dans la même bibliothèque. Il n'est pas nécessaire que l'espace de stockage des enregistrements placés dans le fichier soit contigu. Le fichier peut contenir jusqu'à cinquante membres. L'allocation initiale de mémoire assure jusqu'à 1000 enregistrements et jusqu'à cinq incréments d'espace supplémentaire pour 100 enregistrements, chacun pouvant être ajouté automatiquement. Ces valeurs d'allocation s'appliquent également à chaque membre de ce fichier physique qui est ajouté ultérieurement.

Messages d'erreur

*ESCAPE Messages

CPF3204

Objet nécessaire au traitement du fichier &1 de &2 introuvable.

CPF323C

Impossible d'allouer la bibliothèque QRECOVERY.

CPF5702

Ce fichier n'est pas un fichier DDM ou est introuvable.

CPF7302

Fichier &1 non créé dans la bibliothèque &2.