CRTLF

La commande CRTLF (Créer un fichier logique) permet de créer un fichier logique à partir des informations fournies et des spécifications de description de données (DDS) contenues dans un fichier source.

Un fichier logique est un fichier base de données qui décrit comment les enregistrements contenus dans un ou plusieurs fichiers physiques sont présentés à un programme. Il ne contient pas d'enregistrements de données. Ceux-ci sont contenus dans les fichiers physiques qui lui sont associés.

Les enregistrements de données contenus dans les fichiers physiques sont regroupés dans des membres. Le fichier logique accède aux enregistrements via un ou plusieurs membres de fichiers logiques. Chaque membre décrit les données contenues dans un ou plusieurs membres de fichiers physiques et possède son propre chemin d'accès aux données. Généralement, 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.

Restrictions :

• Pour pouvoir créer un fichier logique à clés sur un ou plusieurs fichiers physiques, vous devez disposer des droits d'exécution (*OBJOPR) et de gestion (*OBJMGT) ou du droit de modification (*OBJALTER) sur chaque fichier indiqué pour les mots clés DDS PFILE ou JFILE.

  Si le fichier logique créé n'est pas à clés, seul le droit *OBJOPR est requis.

• 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 utilisant une base de données relationnelle de type *SNA.

Paramètres

Fichier (FILE)

Indique le fichier logique à créer.

Si le fichier est utilisé par un programme en langage évolué, son nom doit être conforme aux règles d'appellation de ce langage. Sinon, le fichier devra être rebaptisé dans le programme même.

Ce paramètre est requis.

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier logique.

Qualificateur 2 : Biblio

*CURLIB

Le fichier 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

Indiquez la bibliothèque contenant le fichier.

Remarque :Si un fichier logique et le fichier physique dont il dépend résident dans des bibliothèques différentes, et si le fichier logique ou physique n'existe pas au moment de sa restauration (par exemple en cas de reprise après un incident grave ou en cas de suppression), le chemin d'accès n'est pas restauré, mais reconstruit. Pour que vous puissiez restaurer et non reconstruire des chemins d'accès, les fichiers logiques et les fichiers physiques associés doivent se trouver dans la même bibliothèque. Pour plus d'informations sur la restauration des chemins d'accès sauvegardés, consultez le manuel Reprise du système, SC41-5304.

Fichier source (SRCFILE)

Indique le fichier source qui contient les DDS utilisées pour la création du fichier logique.

Qualificatif 1 : Fichier source

QDDSSRC

Le fichier source DDS appelé QDDSSRC contient les descriptions source servant à créer le fichier logique.

nom

Indiquez le nom du fichier source qui contient les DDS utilisées pour la création du fichier logique.

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 fichier source 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

Entrez le nom de la bibliothèque contenant le fichier source.

Membre source (SRCMBR)

Indique le nom du membre source qui contient les DDS correspondant au fichier logique à créer.

*FILE

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

nom

Indiquez le nom du membre dans le fichier source.

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

Indique le niveau de gravité des messages DDS empêchant la création du fichier. Ce paramètre ne concerne que les messages créés lors du traitement des fichiers source DDS.

20

Si, dans le traitement du fichier source des 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 logique en cours de création contient des enregistrements de données ou des enregistrements source destinés à un programme ou à un autre fichier.

*DATA

Le fichier logique contient des enregistrements de données.

*SRC

Le fichier logique contient des enregistrements source. Cette valeur ne peut être indiquée pour des fichiers logiques joints.

Membre de fichier logique (MBR)

Indique le membre de fichier logique à ajouter lors de la création du fichier.

*FILE

Le nom du membre à ajouter est identique au nom indiqué pour le paramètre Fichier (FILE).

*NONE

Aucun membre n'est ajouté lorsque le fichier est créé.

nom

Entrez le nom du membre de fichier logique à ajouter.

Membres données de fich phys (DTAMBRS)

Indique les fichiers physiques et les membres qui contiennent les données associées au membre de fichier logique à ajouter par cette commande. Un membre de fichier logique peut être basé sur tous (*ALL) les fichiers physiques et les membres sur lesquels le fichier logique proprement dit est basé, ou bien le membre peut être basé sur un sous-ensemble des fichiers et des membres.

Remarque :Lors de l'ajout d'un membre dans un fichier logique de type DDM, le fichier physique, s'il est spécifié, doit également être un fichier DDM et ses bibliothèque et membre(s) doivent être précisés explicitement. Le paramètre *CURRENT n'est pas pris en charge avec un fichier logique de type DDM.

Lors de la création d'un fichier logique, les fichiers physiques indiqués pour le mot clé DDS PFILE ou JFILE sont utilisés pour créer le fichier logique. Si aucun nom de bibliothèque n'est indiqué pour les fichiers physiques du mot clé PFILE ou JFILE, la liste des bibliothèques (*LIBL) existant lors de la création du fichier permet de rechercher les fichiers physiques ; les fichiers physiques de la liste des bibliothèques permettent de créer le fichier logique. Les fichiers physiques qualifiés du mot clé PFILE ou JFILE (indépendamment du fait qu'un nom de bibliothèque a été indiqué ou si la liste des bibliothèques a permis de rechercher les fichiers) sont les fichiers physiques associés au fichier logique. Les noms des fichiers physiques associés au fichier logique sont sauvegardés dans la description du fichier logique. Lors de l'ajout d'un membre dans le fichier logique, le paramètre DTAMBRS permet d'indiquer les membres de fichier physique associés au membre du fichier logique. Chaque nom de fichier physique indiqué au paramètre DTAMBRS doit correspondre au nom d'un fichier physique associé au fichier logique (sauvegardé dans la description du fichier logique).

Valeurs uniques

*ALL

Le membre de fichier logique à ajouter est basé sur tous les fichiers physiques et membres (qui existent lors de l'entrée de cette commande CRTLF) utilisés par le fichier logique. Au moins un membre doit exister dans au moins un des fichiers physiques. Les noms de fichier physique sont indiqués pour le paramètre PFILE ou JFILE des DDS.

Elément 1 : Fichier physique

Qualificatif 1 : Fichier physique

nom

Indiquez les noms des fichiers physiques qui contiennent les données accessibles au membre de fichier logique à ajouter.

Les noms de fichier physique doivent correspondre à un nom figurant dans les mots clés PFILE ou JFILE des DDS et ne peuvent pas être indiqués plus souvent au paramètre DTAMBRS que sur les mots clés PFILE ou JFILE des DDS. En ce qui concerne les fichiers logiques joints, tous les fichiers physiques du mot clé JFILE doivent être indiqués pour le paramètre DTAMBRS et chaque fichier physique doit comporter un seul membre. Si aucun nom n'est indiqué pour un fichier physique figurant sur un mot clé PFILE ou JFILE des DDS, le membre de fichier logique n'est basé sur aucun membre du fichier physique.

Qualificatif 2 : Biblio

*CURRENT

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

Si aucun nom de bibliothèque n'est indiqué, le nom de bibliothèque en cours (*CURRENT) de la description du fichier logique est utilisé. Si le nom de bibliothèque est indiqué, le fichier physique doit correspondre à un fichier physique associé au fichier logique. Si ce dernier est associé à plusieurs fichiers physiques du même nom, le nom de bibliothèque doit être indiqué.

nom

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

Elément 2 : Membre

Valeurs uniques

*NONE

Aucun nom de membre n'est indiqué.

Autres valeurs (jusqu'à 32 répétitions)

nom

Indiquez les noms des membres de fichiers physiques qui contiennent les données accessibles au membre de fichier logique à ajouter.

Lorsque le paramètre FILE indique un fichier logique joint ou un fichier logique d'accès par ordre d'arrivée, un seul membre de données doit être indiqué dans le paramètre DTAMBRS pour chaque fichier physique qui a été spécifié pour le mot clé PFILE ou JFILE des DDS. *ALL ne s'applique que si chaque fichier physique sous-jacent ne comporte qu'un seul membre. Si l'un des fichiers physiques comporte plusieurs membres, le membre spécifique doit être indiqué pour le paramètre DTAMBRS.

Un même nom de fichier physique peut être indiqué plusieurs fois pour le mot clé JFILE. Dans ce cas, chaque occurrence du nom de fichier est traitée comme un autre fichier physique sous-jacent et doit être indiquée pour le paramètre DTAMBRS.

Jusqu'à 32 noms de fichier physique qualifiés et noms de membre de fichier physique peuvent être indiqués. Le nombre total des noms de membre ne peut pas être supérieur à 32. Par exemple, un fichier peut spécifier 32 membres, deux fichiers peuvent comporter 16 membres par fichier, ou bien un membre peut être indiqué pour chacun des 32 fichiers.

Pour le fichier DDM :

• Les noms de fichier indiqués au paramètre DTAMBRS doivent correspondre aux noms des fichiers DDM qui représentent les fichiers physiques sous-jacents éloignés. Si un nom de membre a été indiqué dans le cadre du nom de fichier éloigné dans le fichier DDM, seul ce nom de membre peut être indiqué pour le paramètre DTAMBRS. Les noms de membre doivent correspondre aux noms réels des membres de fichier éloigné.
• Les fichiers physiques sous-jacents doivent figurer sur le même lieu système que le fichier logique auquel le membre est ajouté.
• Lorsqu'aucun nom de membre n'est indiqué pour le nom de fichier éloigné dans le fichier DDM, tous les membres sont accessibles. Lorsqu'un seul nom de membre est indiqué, seul ce membre est accessible via le fichier DDM.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SRCMBRTXT

Si le fichier source est un fichier base de données, le texte provient du membre source utilisé pour la création du fichier. Aucun texte n'est indiqué si le fichier source est un fichier spoule en entrée ou un fichier unité.

*BLANK

Aucun texte n'est indiqué.

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 de message de deuxième niveau

*NOSECLVL

La section messages de la sortie imprimée des DDS ne contient pas les informations d'aide en ligne pour les messages produits 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 logique est créé.

*LCL

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

*RMT

Le fichier logique 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 logique 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 logique est créé sur le système local. Dans le cas contraire, le fichier précité doit être un fichier DDM, et le fichier logique est créé sur un système éloigné. Le fichier DDM identifie le système éloigné et le nom du fichier logique en cours de création.

Nombre maximal de membres (MAXMBRS)

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

1

Un membre seulement peut être contenu dans le fichier.

*NOMAX

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

entier

Indiquez le nombre maximal de membres pouvant être contenus dans le fichier. Les valeurs possibles sont comprises entre 1 et 32767 secondes.

Taille du chemin d'accès (ACCPTHSIZ)

Indique la quantité maximale de mémoire secondaire que peuvent occuper les chemins d'accès associés aux fichiers logiques joints ou aux fichiers ayant des chemins d'accès par clé.

Remarque :Pour un fichier logique joint, ce paramètre s'applique à tous les chemins d'accès secondaires joints, même lorsque le fichier logique joint n'est pas un fichier à clé.

*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 contenant des zones clés ou pour les fichiers logiques joints, le type de maintenance du chemin d'accès pour tous les membres du fichier logique.

*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 entièrement reconstruit chaque fois qu'un membre fichier est ouvert. 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'à l'ouverture du membre de fichier logique. Le chemin d'accès est ensuite modifié uniquement pour les enregistrements qui ont été ajoutés, supprimés ou modifiés depuis la dernière ouverture du fichier. Lorsque le fichier est ouvert, toutes les modifications apportées aux membres de fichiers sous-jacents sont immédiatement reflétées dans les chemins d'accès des propres membres du fichier ouvert, quelle que soit la valeur de ce paramètre. Pour éviter un long délai de reconstruction lors de l'ouverture du fichier, *DLY doit être indiqué uniquement lorsque le nombre des modifications apportées au chemin d'accès entre les opérations d'ouverture successives est faible, c'est-à-dire lors de l'ouverture fréquente du fichier ou lors des modifications peu fréquentes apportées aux zones clés des enregistrements de ce chemin d'accès. Vous ne pouvez pas indiquer *DLY pour un chemin d'accès à clé unique.

Si le nombre de modifications entre une opération de fermeture et l'opération d'ouverture suivante atteint environ 10 pour-cent de la taille du chemin d'accès, le système arrête la sauvegarde des modifications et le chemin d'accès est entièrement rétabli lors de la prochaine ouverture du fichier. Le chemin d'accès est mis à jour lors de l'ouverture du membre à l'aide des enregistrements qui ont été ajoutés, supprimés ou modifiés dans le membre depuis la dernière ouverture de celui-ci.

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

Indique, pour les fichiers dont les chemins d'accès font l'objet d'une maintenance immédiate ou différée, le moment de traitement du rétablissement du fichier après un incident système lors de la modification du chemin d'accès. Ce paramètre ne s'applique qu'aux fichiers logiques joints ou aux fichiers comportant un chemin d'accès sur clé.

Si *IMMED ou *DLY est indiqué pour le paramètre Maintenance chemin d'accès (MAINT), le chemin d'accès peut être rétabli lors de l'IPL (avant qu'un utilisateur puisse exécuter un travail), à la fin de l'IPL (lors de l'exécution de travaux simultanés) 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.

Au cours de l'IPL, un écran REVISION RECONSTRUCTION DES CHEMINS D'ACCES répertorie les chemins qui doivent être rétablis et la valeur du paramètre RECOVER pour chaque chemin d'accès. L'utilisateur peut substituer la valeur du paramètre RECOVER sur cet écran. Pour plus de détails, reportez-vous au manuel Reprise du système, SC41-5304.

Si *REBLD est indiqué pour le paramètre MAINT, le chemin d'accès est reconstruit lors de la prochaine ouverture du fichier.

*NO

Le chemin d'accès du fichier est reconstruit lors de l'ouverture du fichier. *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 après l'IPL. Cette option permet à d'autres travaux qui n'utilisent pas ce fichier de démarrer immédiatement le traitement à la fin de l'IPL. Si un travail tente d'allouer le fichier lors de la reconstruction du chemin d'accès de ce fichier, une erreur d'ouverture de fichier se produit. *AFTIPL est la valeur par défaut des fichiers qui requièrent des clés uniques.

*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 ou pour un fichier logique joint, 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. FRCACCPTH(*YES) minimise (mais n'élimine pas) la possibilité de dommage causé par une fin de travail anormale au chemin d'accès nécessitant une reconstruction.

Remarque :Pour un fichier logique joint, cette valeur de paramètre s'applique à tous les fichiers secondaires joints si le fichier joint n'est pas un fichier avec clé.

*NO

Le chemin d'accès et les enregistrements associés ne sont pas é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 é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. En cas de modification fréquente du chemin d'accès, les performances globales du système sont affectées quelque peu.

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.

Pgm de sélection de format (FMTSLR)

Indique le programme de sélection de formats d'enregistrement, appelé lorsqu'un membre de fichier logique comporte plusieurs formats d'enregistrements logiques.

Le programme de sélection écrit par l'utilisateur est appelé lorsqu'un enregistrement est écrit dans le fichier base de données, à défaut de nom de format inclus dans le programme en langage évolué. Le programme de sélection reçoit l'enregistrement en entrée, détermine le format utilisé, et le renvoie à la base de données.

Ce paramètre ne concerne pas les fichiers logiques n'ayant qu'un seul format d'enregistrement.

Valeurs uniques

*NONE

Il n'existe pas de programme de sélection pour ce fichier logique.

Qualificatif 1 : Pgm de sélection de format

QDDSSRC

Le nom du programme de sélection de format est QDDSSRC.

nom

Indiquez le nom du programme de sélection de format à appeler. Un programme désigné comme tel ne peut être créé avec *OWNER spécifié pour le paramètre Profil utilisateur (USRPRF)

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 nom du programme est recherché dans la bibliothèque en cours. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez la bibliothèque contenant le programme.

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.

Le taux de forçage d'écriture indiqué pour un fichier logique ne peut pas être inférieur ou égal au taux de forçage d'écriture minimum des fichiers sous-jacents. Si un taux plus élevé est indiqué, celui-ci est ignoré et un message d'information est envoyé à l'utilisateur.

Par exemple, si les taux de forçage de trois fichiers physiques sont 2, 6 et 8, le taux de forçage du fichier logique qui est fonction de ces trois fichiers physiques doit être aussi restrictif que le taux le plus faible, c'est-à-dire 2 dans ce cas. Cette valeur est utilisée même si le paramètre FRCRATIO n'est pas indiqué. Ainsi, chaque fois qu'un programme insère, met à jour ou supprime deux enregistrements dans le fichier logique (quels que soient les fichiers physiques sous-jacents concernés), ces enregistrements sont forcés en mémoire permanente.

Si un fichier physique associé à ce fichier logique est journalisé, un taux de forçage d'écriture élevé ou *NONE est indiqué. Pour plus de détails sur la gestion des journaux, reportez-vous au manuel Reprise du système, SC41-5304.

*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, en secondes, le laps de temps maximal pendant lequel le programme attend un enregistrement à modifier ou supprimer. 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 un enregistrement à modifier ou supprimer.

*IMMED

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

*NOMAX

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

entier

Précisez, en secondes, le temps d'attente maximal du programme pour un enregistrement à modifier ou supprimer. Les valeurs admises sont comprises entre 1 et 32767.

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 doit pas être utilisé si *NONE est indiqué pour le paramètre Membre de fichier logique (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.

*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.

Séquence de tri (SRTSEQ)

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

Valeurs uniques

*SRC

La table utilisée est celle qui est indiquée dans les spécifications de description de données (DDS) du mot clé ALTSEQ. Si ALTSEQ n'est pas utilisé dans les DDS, utilisez la valeur attribuée à *JOB pour ce paramètre.

*JOB

La valeur utilisée pour la séquence de tri provient du travail émettant cette commande pour la création du fichier logique.

*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 chaque caractère 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 porte sur la bibliothèque en cours du 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é pour le paramètre Séquence de tri (SRTSEQ). L'identificateur de langue est utilisé avec le paramètre STRSEQ 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).

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement situés dans le fichier logique 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'il n'y a pas correspondance exacte, un message d'erreur est envoyé au programme qui a demandé l'opération d'ouverture.

*NO

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

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 logique ne contenant pas de membres

CRTLF   FILE(INVEN/STOCKCTL)  SRCFILE(SRCLIB/STKLFSRC)
        MBR(*NONE)

Cette commande permet de créer un fichier logique appelé STOCKCTL dans la bibliothèque INVEN. Les descriptions source figurant dans le fichier source STKLFSRC de la bibliothèque SRCLIB sont utilisées pour créer ce fichier logique. Le fichier est créé sans aucun membre (la valeur *NONE a été indiquée) et un seul membre peut être ajouté ultérieurement (car la valeur par défaut du paramètre MAXMBRS est un membre). Le fichier logique accède aux données contenues dans les fichiers physiques indiqués dans le fichier source DDS servant à créer ce fichier logique. Pour que la commande CRTLF aboutisse, vous devez disposer de droits d'opération sur l'objet pour tous les fichiers physiques indiqués dans les DDS. Si le fichier logique est un fichier avec clé, le droit de gestion de l'objet est également requis.

Exemple 2 : Création d'un fichier logique contenant des membres

CRTLF   FILE(PAYLIB/PAYCODESEQ)  SRCFILE(PAYLIB/PAYTXSRC)
        DTAMBRS(PAYTRANS FIRSTQTR)  AUT(*EXCLUDE)
        TEXT('Paiement d'impôts en séquence de code')

Cette commande permet de créer dans la bibliothèque PAYLIB un fichier logique et un membre de fichier logique, tous les deux appelés PAYCODESEQ. Le fichier et son membre sont créés à partir du fichier source PAYTXSRC qui figure dans la même bibliothèque. Le membre de fichier logique accède aux données contenues dans le membre FIRSTQTR du fichier physique PAYTRANS. Le fichier logique est sécurisé pour l'utilisation personnelle du propriétaire. Ce dernier doit disposer de droits d'opération sur l'objet pour le fichier PAYTRANS, afin de créer le membre. Si le fichier logique est un fichier avec clé, le droit de gestion de l'objet est également requis.

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.