CRTICFF

La commande CRTICFF (Créer un fichier ICF) permet de créer un fichier ICF à partir des informations spécifiées dans cette commande et des spécifications de description de données (DDS) contenues dans un fichier source.

Un fichier ICF permet d'effectuer des opérations d'entrée/sortie avec des unités de communications.

Paramètres

Fichier (FILE)

Indique le fichier ICF à 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 ce programme.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier ICF

nom

Indiquez le nom du fichier ICF.

Qualificateur 2 : Biblio

*CURLIB

Le fichier ICF est recherché dans la bibliothèque en cours pour le travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indique le nom de la bibliothèque dans laquelle figure le fichier ICF.

Fichier source (SRCFILE)

Indique le fichier source contenant les DDS utilisés pour la création du fichier ICF.

Qualificatif 1 : Fichier source

QDDSSRC

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

nom

Indiquez le nom du fichier source.

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 pour le travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indique la bibliothèque dans laquelle est situé le fichier source.

Membre source (SRCMBR)

Indique le membre du fichier source qui contient les DDS du fichier ICF à créer.

*FILE

Le nom du membre source est le même que le nom du fichier ICF spécifié pour le paramètre Fichier ICF (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 précisant la gravité minimale des messages à répertorier. 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).

Unité programme à acquérir (ACQPGMDEV)

Indique l'unité programme acquise pour être utilisée avec le fichier lors de son ouverture.

*NONE

Le fichier est ouvert sans qu'aucune unité programme ne soit acquise. Toutes les unités programme utilisées avec ce fichier doivent être explicitement acquises avant de pouvoir participer à des opérations d'entrée/sortie.

valeur-alphanumérique

Indiquez le nom de la première unité programme acquise lors de l'ouverture du fichier. Celle-ci doit être ajoutée au fichier avant l'ouverture.

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 du fichier 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 d'impression produite lorsque le fichier est créé. Pour ce paramètre, trois des valeurs suivantes, au maximum, 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 création de programme

*SRC ou *SOURCE

Impression des instructions source utilisées pour créer le fichier 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 format d'enregistrement qui les contient.

Option de liste source

*LIST

Une impression source étendue est créée ; elle présente une liste détaillée des spécifications de fichier résultant des instructions source 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 comporte pas le texte du message de deuxième niveau pour les erreurs détectées pendant le traitement des DDS.

*SECLVL

Le texte du message de deuxième niveau est inclus dans la liste source.

Nombre maximal d'unités pgm (MAXPGMDEV)

Indique le nombre maximum d'unités programme pouvant être ajoutées au fichier ICF à l'aide de la commande ADDICFDEVE (Ajouter un poste unité à un fichier ICF).

1

Une seule unité programme ou *REQUESTER peut être ajoutée à ce fichier ICF.

1 à 256

Indiquez le nombre maximal d'unités programme définies pour ce fichier ICF ou pouvant lui être ajoutées.

Longueur maximale d'enreg (MAXRCDLEN)

Indique la longueur maximale d'enregistrement utilisée lors de l'ouverture du fichier.

*CALC

La longueur calculée pour le plus long enregistrement du fichier est utilisée lors de l'ouverture de ce dernier.

1 à 32767

Indiquez la longueur d'enregistrement maximale. Si la longueur d'un enregistrement est inférieure à celle calculée pour l'enregistrement le plus long, c'est cette dernière valeur qui est utilisée.

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.

*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 délai d'attente (en secondes) par le programme pour la réalisation d'une opération de lecture sur les unités invitées d'un fichier contenu dans un programme en langage évolué. Pour savoir dans quels cas un fichier est traité en tant que fichier à unités multiples, reportez-vous au manuel de référence relatif au langage évolué. Le programme exécutant l'opération de lecture attend les données d'entrée de toutes les unités invitées accédant au fichier. Si aucun enregistrement n'est renvoyé depuis l'une de ces unités dans le délai indiqué, le système envoie un message d'avertissement au programme. Ce paramètre n'a aucune incidence sur une opération d'entrée dirigée sur une unité unique.

*NOMAX

Le temps pendant lequel le système attend l'aboutissement de l'opération est illimité.

*IMMED

Le programme n'attend pas. Si aucun enregistrement n'est disponible lors de l'opération de lecture sur les unités invitées, un message d'avertissement est envoyé au programme.

entier

Indiquez, en secondes, le temps d'attente maximal du programme. Les valeurs admises sont comprises entre 1 et 32767.

File d'attente de données (DTAQ)

Indique la file d'attente de données dans laquelle sont placés les postes. Le nom doit comporter au moins 80 caractères. Il n'est pas nécessaire que la file d'attente existe lors de la création du fichier écran puisque le nom indiqué par ce paramètre est examiné uniquement lorsque le fichier est utilisé.

Remarque :Les files d'attente de données par clé ne sont pas prises en charge pour ce paramètre. Si vous indiquez une file d'attente de ce type, une erreur se produira lors de l'exécution, mais ceci ne vous est pas signalé, car il n'est pas nécessaire qu'une file d'attente existe lors du lancement de la commande.

Valeurs uniques

*NONE

Aucune file d'attente de données n'est indiquée.

Qualificatif 1 : File d'attente de données

nom

Indiquez le nom de la file d'attente de données à utiliser.

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 file d'attente est recherchée 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 la file d'attente de données.

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.

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

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement du fichier unité ICF 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 essayé d'ouvrir le fichier.

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

Remplacer fichier (REPLACE)

Indique si un fichier existant, autre qu'un fichier sauvegarde ou base de données, est remplacé.

*YES

Un fichier existant de même nom et appartenant à la même bibliothèque est remplacé si la création du nouveau fichier ICF a réussi.

*NO

La création d'un nouveau fichier ICF n'est pas permise si un fichier existant porte le même nom et appartient à la même bibliothèque.

Exemples

CRTICFF   FILE(QGPL/ICFTEST)  SRCFILE(QGPL/QDDSSRC)
          MAXPGMDEV(5)  ACQPGMDEV(DENVER)

Cette commande permet de créer le fichier ICFTEST dans la bibliothèque QGPL. Le fichier source contenant les DDS, qui sert à créer le fichier, figure dans le membre ICFTEST du fichier QDDSSRC de la bibliothèque QGPL. Jusqu'à cinq unités programme peuvent être utilisées avec le fichier. L'unité programme DENVER est acquise à l'ouverture du fichier.

Messages d'erreur

*ESCAPE Messages

CPF7302

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