Commande CL IBM i (AS/400)
CRTDSPF
Créer un fichier écran
En bref
La commande CRTDSPF permet de créer un fichier écran.
CRTDSPF se lit CRT
(Créer) + DSPF.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTDSPF FILE(…)
Paramètres
-
FILEFichier obligatoire -
SRCFILEFichier source -
SRCMBRMembre source -
GENLVLNiveau gravité pour génération -
FLAGNiveau gravité pour marquage -
DEVUnité écran -
IGCDTAUser specified DBCS data -
IGCEXNCHRDBCS extension characters -
TEXTTexte 'descriptif' -
OPTIONOptions pour liste source -
MAXDEVNombre maximal d'unités -
ENHDSPFonctions 5250 étendues -
RSTDSPRéaffichage -
DFRWRTEcriture différée -
CHRIDIdentificateur de caractères -
DECFMTFormat décimal -
SFLENDTXTTexte SFLEND -
WAITFILETemps d'attente maxi fichier -
WAITRCDTemps d'attente maxi enreg -
DTAQFile d'attente de données -
SHAREPartage chemin d'ouverture -
SRTSEQSéquence de tri -
LANGIDIdentificateur de langue -
LVLCHKVérification niveau de format -
AUTDroits -
REPLACERemplacer fichier
Astuce : dans une session 5250, tapez CRTDSPF puis F4 pour
l'invite de saisie, et F1 sur un paramètre pour son aide.
Aide IBM i de la commande
Texte du F1, IBM i 7.5 en français
(bibliothèque QSYS)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande CRTDSPF permet de créer un fichier écran. Celui-ci contient la description de fichier qui identifie l'unité utilisée et, le cas échéant, les formats d'enregistrement utilisés par l'unité (s'ils sont indiqués dans les spécifications de description de données (DDS)) ; le fichier unité ne contient pas de données. Le fichier écran permet d'envoyer des enregistrements à une ou plusieurs unités écran associées au fichier unité et de recevoir des enregistrements des unités écran.
La description de fichier écran contient des informations indiquées à deux endroits : (1) dans le fichier source qui contient les DDS (si utilisé) ; et (2) dans la commande CRTDSPF. Les DDS contiennent les spécifications relatives à chaque format d'enregistrement du fichier unité et aux zones de chaque format d'enregistrement.
La commande CHGDSPF ou OVRDSPF est utilisée dans un programme pour modifier ou substituer les valeurs de paramètre indiquées dans la description de fichier écran ; la commande de substitution doit être exécutée avant l'ouverture du fichier écran par le programme. Les valeurs substituées ne sont modifiées que pour l'exécution du programme. A la fin du programme, les valeurs de paramètre initiales indiquées pour le fichier écran sont utilisées.
Remarque :Si un programme d'application tente d'acquérir un poste de travail sur une ligne commutée et que la connexion a été perdue ou n'a jamais été établie, le programme d'application attend indéfiniment jusqu'à l'établissement de la connexion.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| FILE | Fichier | Nom d'objet qualifié | Obligatoire, positionnel 1 |
| Qualificatif 1: Fichier | Nom | ||
| Qualificatif 2: Biblio | Nom, *CURLIB | ||
| SRCFILE | Fichier source | Valeurs uniques: *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif, positionnel 2 |
| Qualificatif 1: Fichier source | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| SRCMBR | Membre source | Nom, *FILE | Facultatif, positionnel 3 |
| GENLVL | Niveau gravité pour génération | 0-30, 20 | Facultatif |
| FLAG | Niveau gravité pour marquage | 0-30, 0 | Facultatif |
| DEV | Unité écran | Valeurs uniques: *NONE Autres valeurs (jusqu'à 50 répétitions): Nom, *REQUESTER |
Facultatif |
| IGCDTA | User specified DBCS data | *NO, *YES | Facultatif |
| IGCEXNCHR | DBCS extension characters | *YES, *NO | Facultatif |
| TEXT | Texte 'descriptif' | Valeur caractère, *SRCMBRTXT, *BLANK | Facultatif |
| OPTION | Options pour liste source | Values (jusqu'à 4 répétitions): *SRC, *NOSRC, *SOURCE, *NOSOURCE, *LIST, *NOLIST, *SECLVL, *NOSECLVL, *EVENTF, *NOEVENTF | Facultatif, positionnel 4 |
| MAXDEV | Nombre maximal d'unités | 1-256, 1 | Facultatif |
| ENHDSP | Fonctions 5250 étendues | *YES, *NO | Facultatif |
| RSTDSP | Réaffichage | *NO, *YES | Facultatif |
| DFRWRT | Ecriture différée | *YES, *NO | Facultatif |
| CHRID | Identificateur de caractères | Valeurs uniques: *DEVD, *SYSVAL, *JOBCCSID, *CHRIDCTL Autres valeurs: Liste d'éléments |
Facultatif |
| Élément 1: Jeu de caractères graphiques | Entier | ||
| Élément 2: Page de codes | Entier | ||
| DECFMT | Format décimal | *FILE, *JOB | Facultatif |
| SFLENDTXT | Texte SFLEND | *FILE, *MSG | Facultatif |
| WAITFILE | Temps d'attente maxi fichier | Entier, *IMMED, *CLS | Facultatif |
| WAITRCD | Temps d'attente maxi enreg | Entier, *NOMAX, *IMMED | Facultatif |
| DTAQ | File d'attente de données | Valeurs uniques: *NONE Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File d'attente de données | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| SHARE | Partage chemin d'ouverture | *NO, *YES | Facultatif |
| SRTSEQ | Séquence de tri | Valeurs uniques: *JOB, *LANGIDSHR, *LANGIDUNQ, *HEX Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: Séquence de tri | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| LANGID | Identificateur de langue | Valeur caractère, *JOB | Facultatif |
| LVLCHK | Vérification niveau de format | *YES, *NO | Facultatif |
| AUT | Droits | Nom, *LIBCRTAUT, *ALL, *CHANGE, *EXCLUDE, *USE | Facultatif |
| REPLACE | Remplacer fichier | *YES, *NO | Facultatif |
Fichier (FILE)
Indique le fichier écran à créer.
Si le fichier écran 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
- nom
- Entrez le nom du fichier écran à créer.
Qualificateur 2 : Biblio
- *CURLIB
- Le fichier 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
- Indiquez la bibliothèque dans laquelle le fichier écran est créé.
Fichier source (SRCFILE)
Indique (le cas échéant) le fichier source contenant les DDS utilisées pour créer le fichier écran.
Valeurs uniques
- *NONE
- Il n'existe pas de DDS source pour ce fichier écran.
Qualificatif 1 : Fichier source
- nom
- Indiquez le nom du fichier source qui contient les DDS utilisées pour créer le fichier écran.
Qualificateur 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 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
- Indique la bibliothèque contenant le fichier.
Membre source (SRCMBR)
Indique le membre du fichier source qui contient les DDS correspondant au fichier écran à 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 doivent être listés.
- 0 à 30
- Indiquez un chiffre précisant la gravité minimale des messages à répertorier. La valeur indiquée doit être inférieure ou égale à celle précisée pour le paramètre Niveau gravité pour génération (GENLVL).
Unité écran (DEV)
Indique le nom d'une ou de plusieurs unités écrans utilisées avec ce fichier écran pour passer les enregistrements de données entre les utilisateurs de ces écrans et leurs travaux.
Valeurs uniques
- *NONE
- Aucun nom d'unité écran n'est spécifié. Il devra être indiqué plus tard dans une commande CHGDSPF (Modifier un fichier écran) ou OVRDSPF (Substituer un fichier écran), ou dans le programme en langage évolué qui ouvre le fichier.
Autres valeurs (jusqu'à 50 répétitions)
- *REQUESTER
- L'unité écran qui a appelé le programme est celle assignée au fichier lors de son ouverture.
- nom
- Indiquez les noms d'une ou de plusieurs unités écran. *REQUESTER peut également être spécifié. Vous pouvez préciser 50 noms d'unités au maximum (y compris *REQUESTER). Toutefois, le nombre total ne peut dépasser la valeur indiquée pour le paramètre Nombre maximal d'unités (MAXDEV) lorsque le fichier est ouvert.
User specified DBCS data (IGCDTA)
Considérations DBCS : non applicable.
Pour les fichiers décrits par programme For program-described files
- *NO
- Considérations DBCS : non applicable.
- *YES
- Considérations DBCS : non applicable.
Pour les fichiers décrits en externe For externally-described files
- *NO
- Les seuls attributs de jeu de caractères sur deux octets (DBCS) du fichier sont ceux indiqués dans les spécifications de description de données (DDS). The only double-byte character set (DBCS) attributes of the file are those specified in the data description specifications (DDS).
- *YES
- Les attributs DBCS, en plus de ceux indiqués dans les DDS, comprennent : (1) la prise en compte du mot clé DDS de type de données de remplacement (IGCALTTYP) et (2) l'identification des attributs DBCS des zones, des valeurs ou des messages. DBCS attributes, in addition to those specified in the DDS, include: (1) putting the DDS keyword for alternative data type (IGCALTTYP) into effect and (2) identifying DBCS attributes of fields, values, or messages.
DBCS extension characters (IGCEXNCHR)
Indique si le système traite les caractères étendus du jeu de caractères double octet (DBCS). Lors du traitement des caractères étendus DBCS, l'unité a besoin de l'aide du système. Le système doit indiquer à l'unité l'aspect du caractère avant que celle-ci puisse l'afficher ou l'imprimer. Les caractères étendus sont stockés dans une table de polices DBCS, et non dans l'unité DBCS. Le traitement des caractères étendus est une fonction du système d'exploitation nécessaire pour mettre à la disposition d'une unité DBCS les caractères stockés dans une table de polices DBCS. Specifies whether the system processes double-byte character set (DBCS) extended characters. When processing DBCS extended characters, the device requires the assistance of the system. The system must tell the device what the character looks like before the device can display or print the character. Extended characters are stored in a DBCS font table, not in the DBCS device. Extended character processing is a function of the operating system that is required to make characters stored in a DBCS font table available to a DBCS device.
- *YES
- Le système traite les caractères étendus DBCS. The system processes DBCS extended characters.
- *NO
- Le système ne traite pas les caractères étendus DBCS ; il les affiche sous la forme du caractère non défini. The system does not process DBCS extended characters; it displays extended characters as the undefined character.
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.
Nombre maximal d'unités (MAXDEV)
Indique le nombre maximal d'unités écran pouvant être connectées simultanément au fichier écran pendant l'ouverture du fichier.
- 1
- Un seul nom d'unité ou *REQUESTER peut être indiqué pour ce fichier écran.
- 1 à 256
- Indiquez le nombre maximal d'unités pouvant être connectées simultanément au fichier écran.
Fonctions 5250 étendues (ENHDSP)
Indique si les fonctions 5250 étendues disponibles sur le clavier-écran sont utilisées pour ce fichier écran.
- *YES
- Toutes les fonctions 5250 étendues disponibles sur le clavier-écran sont utilisées pour les données du fichier, notamment les mnémoniques, le curseur de sélection et les cadres de fenêtre graphiques.
- *NO
- Les données de ce fichier écran sont affichées comme sur un poste de travail 5250. Aucune des fonctions 5250 étendues disponibles sur le clavier-écran (par exemple, les mnémoniques, le curseur de sélection ou les cadres de fenêtre graphiques) n'est utilisée. Cette valeur est normalement utilisée pour conserver l'interaction basée sur les caractères sur tous les claviers-écrans.
Réaffichage (RSTDSP)
Indique si les données affichées par ce fichier écran sont sauvegardées ou non lorsque celui-ci est suspendu (temporairement inactif) pour laisser un autre fichier écran afficher d'autres données. Si oui, elles seront restaurées à l'écran une fois le fichier libéré.
- *NO
- Les données affichées par ce fichier ne sont pas sauvegardées lorsque celui-ci est suspendu.
- *YES
- Les données affichées sont sauvegardées et restaurées sur l'unité écran une fois le fichier libéré.
Ecriture différée (DFRWRT)
Indique que l'écriture des données est retardée de manière à pouvoir être combinée avec une autre opération d'écriture lors d'une demande de lecture. Le contrôle est rendu au programme immédiatement après la réception des données.
- *YES
- Lorsque le programme émet une demande d'écriture, le contrôle lui est rendu après traitement du contenu de la mémoire tampon. Cela peut donner lieu à des performances améliorées.
- *NO
- Après une opération d'écriture, le contrôle n'est rendu au programme utilisateur qu'une fois l'opération d'entrée/sortie terminée.
Identificateur de caractères (CHRID)
Indique le type de conversions alphanumériques qui peuvent être appliquées au fichier écran. Si nécessaire, le système convertit les données alphanumériques émises ou reçues au niveau de l'unité. Cela permet d'assurer un envoi et un retour correct des valeurs d'octets hexadécimales entre l'unité et le programme d'application.
Valeurs uniques
- *DEVD
- Indique que l'identificateur de caractères (CHRID) de l'unité représente le CCSID des données de chacune des zones baptisées à l'aide du mot clé CHRID DDS. Aucune conversion n'est effectuée car le CCSID des données de chaque zone est toujours identique au CHRID de l'unité.
- *SYSVAL
- Indique que la valeur système QCHRID représente le CCSID des données de chacune des zones baptisées à l'aide du mot clé CHRID DDS. Une conversion n'est effectuée que pour les zones dont le CCSID des données est différent du CHRID de l'unité.
- *JOBCCSID
- Indique qu'une conversion alphanumérique est effectuée lorsqu'il existe une différence entre les valeurs de CHRID de l'unité, du CCSID du travail ou les valeurs de CCSID des fichiers écran. En entrée, les données alphanumériques sont converties du CHRID d'unité en CCSID du travail si nécessaire. En sortie, les données alphanumériques sont converties du CCSID du travail en CHRID de l'unité si nécessaire. De même, les données alphanumériques de constantes du fichier écran sont converties du CCSID du fichier écran en CHRID de l'unité si nécessaire.
Remarque :La valeur spéciale *JOBCCSID, indiquée directement au paramètre de commande CHRID ou dans l'attribut de travail CHRIDCTL alors que la valeur spéciale *CHRIDCTL est spécifiée pour le paramètre de commande CHRID, n'est pas admise si le fichier a été créé sur un système disposant d'une version antérieure à V2R3M0. En effet, un fichier créé dans une version antérieure à la V2R3M0 n'est pas associé à un CCSID et ne peut donc pas être utilisé conjointement avec la valeur *JOBCCSID.
- *CHRIDCTL
- Indique que le système vérifie l'attribut de travail CHRIDCTL afin de déterminer la valeur spéciale (*JOBCCSID ou *DEVD) à indiquer au paramètre de commande CHRID de ce fichier écran.
Elément 1 : Jeu de caractères graphiques
- entier
- Indique le numéro du jeu de caractères graphiques à utiliser. Les valeurs possibles sont comprises entre 1 et 32767 secondes.
Elément 2 : Page de codes
- entier
- Indique le numéro de la page de codes à utiliser. Les valeurs possibles sont comprises entre 1 et 32767 secondes.
Remarque :Le jeu de caractères graphiques et la page de codes indiquent la valeur représentant le CCSID des données de chacune des zones baptisées à l'aide du mot clé CHRID DDS. Une conversion n'est effectuée que pour les zones dont le CCSID des données est différent du CHRID de l'unité.
Format décimal (DECFMT)
Indique la valeur de format décimal utilisée lors de l'édition de zones numériques avec le mot clé DDS EDTCDE. La valeur de format décimal détermine l'utilisation de virgules et de points pour la position décimale et de séparateurs à position fixe composés de trois chiffres sur les zones éditées.
- *JOB
- Utilisation de la valeur de format décimal extraite de l'attribut de travail DECFMT lors de l'ouverture du fichier.
- *FILE
- Utilisation de la valeur de format décimal stockée avec le fichier lors de sa création.
Texte SFLEND (SFLENDTXT)
Indique la source d'extraction des textes "A suivre..." et "Fin" lors de l'affichage d'un sous-fichier. Le texte A suivre... et Fin s'affiche dans un sous-fichier quand le mot clé SFLEND(*MORE) DDS est indiqué dans l'enregistrement de contrôle du sous-fichier.
- *MSG
- Permet d'utiliser les textes "A suivre..." et "Fin" à partir des messages CPX6AB1 et CPX6AB2 existant dans la langue qui est active lors de l'ouverture du fichier.
- *FILE
- Permet d'utiliser les textes "A suivre..." et "Fin" stockés dans le fichier lors de sa création. Ces textes sont extraits des messages CPX6AB1 et CPX6AB2 existant dans la langue qui était active lors de la création du fichier.
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.
Séquence de tri (SRTSEQ)
Indique la séquence de tri utilisée pour ce profil utilisateur. Elle est employée avec le paramètre LANGID afin de déterminer la table de séquence de tri à utiliser.
Valeurs uniques
- *JOB
- La valeur SRTSEQ indiquée dans l'attribut du travail est utilisée.
- *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 à 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 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 du fichier écran 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.
Remplacer fichier (REPLACE)
Indique si un fichier existant, autre qu'un fichier sauvegarde ou base de données, est remplacé.
Remarque :Le fichier existant ne peut pas être remplacé s'il est en cours d'utilisation par ce travail ou par un autre travail.
Remarque :Les droits sur le fichier sont déterminés par le profil utilisateur. Dans le cas d'un remplacement, les droits sur le nouveau fichier sont identiques à ceux détenus sur le fichier remplacé.
- *YES
- Un fichier existant est remplacé si la création du nouveau fichier d'unité écran de même nom et appartenant à la même bibliothèque a réussi.
- *NO
- La création d'un nouveau fichier d'unité écran n'est pas permise si un fichier existant porte le même nom et appartient à la même bibliothèque.
Exemples
Exemple 1 : Spécification des paramètres facultatifs par défaut
CRTDSPF FILE(DSPHIST) SRCFILE(PRSNNL/JOBHIST)
Cette commande permet de créer un fichier d'unité écran appelé DSPHIST stocké dans la bibliothèque en cours et utilisant le fichier source JOBHIST qui se trouve dans la bibliothèque PRSNNL. Les valeurs par défaut de tous les autres paramètres sont utilisées. Seule l'unité demandant le programme qui utilise ce fichier d'unité (c'est-à-dire, *REQUESTER) est affectée au fichier d'unité. Les identificateurs de niveau des formats d'enregistrement sont vérifiés. Le public ne dispose que de droits d'opération sur les objets pour le fichier d'unité.
Considérations DBCS : non applicables
CRTDSPF FILE(IGCDSP) SRCFILE(IGCLIB/IGCSRC) IGCDTA(*YES)
Considérations DBCS : non applicables. Considérations DBCS : non applicable.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.