CHGDSPF

La commande CHGDSPF (Modifier un fichier écran) permet de modifier les attributs du fichier écran spécifié.

Seules les informations spécifiées dans cette commande peuvent être modifiées. Si les spécifications de description de données (DDS) utilisées pour le créer sont modifiées, le fichier écran devra être recréé pour que les modifications deviennent effectives.

Paramètres

Fichier (FILE)

Indique le fichier écran à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

*ALL

Tous les fichiers écran figurant dans les bibliothèques indiquées sont modifiés.

nom-générique

Indiquez le nom générique des fichiers écran à modifier. Un nom générique est une chaîne d'un ou de plusieurs caractères suivis d'un astérisque (*).

nom

Entrez le nom du fichier écran à modifier.

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.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom

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

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. Le nom d'unité indiqué dans le fichier écran fourni par IBM est *REQUESTER.

Valeurs uniques

*SAME

Les nom d'unité écran ne sont pas modifiés.

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

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. Cependant, si un programme CL est écrit pour l'accès à plusieurs postes de travail via le même fichier (grâce à une seule exécution du programme), ce paramètre doit indiquer une valeur supérieure à 1.

Les noms des unités sont indiqués au paramètre DEV de cette commande, d'une commande CHGDSPF ou OVRDSPF ultérieure ou du programme HLL qui ouvre le fichier.

*SAME

Le nombre maximum d'unités écrans pouvant être connectées au fichier écran n'est pas modifié.

1 à 256

Indiquez le nombre maximal d'unités écran pouvant être connectées simultanément au fichier écran.

Vérification niveau de format (LVLCHK)

Indique si les identificateurs de niveau des formats d'enregistrement de ce fichier unité sont vérifiés lors de l'ouverture du fichier par un programme. Si tel est le cas, les identificateurs des formats d'enregistrement du programme doivent concorder avec ceux du fichier unité. Un même nom de format d'enregistrement pouvant exister dans plusieurs fichiers, chaque format reçoit, lors de sa création, un identificateur unique interne au système.

*SAME

La valeur reste inchangée.

*YES

Les identificateurs de niveau sont vérifiés lors de l'ouverture du fichier. Si les identificateurs de niveau 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.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME

Le texte, s'il existe, ne change pas.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

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

Fonctions 5250 étendues (ENHDSP)

Indique si les fonctions 5250 étendues disponibles sur le clavier-écran sont utilisées pour ce fichier écran.

*SAME

La valeur reste inchangée.

*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 sur une unité écran par ce fichier écran sont sauvegardées lorsque ce fichier est suspendu (temporairement inactif) de sorte qu'un autre fichier écran puisse être utilisé pour afficher d'autres données sur la même unité. Si oui, elles seront restaurées à l'écran une fois le fichier libéré.

*SAME

La valeur reste inchangée.

*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 lorsque le fichier est suspendu sont sauvegardées pour pouvoir être restaurées à l'écran lorsque le fichier est de nouveau utilisé.

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. Cela peut donner lieu à des performances améliorées.

*SAME

La valeur indiquée dans le fichier unité n'est pas modifiée.

*NO

Après une opération d'écriture, le programme utilisateur ne reprend le contrôle qu'une fois l'opération d'entrée/sortie terminée.

*YES

Lorsque le programme émet une demande d'écriture, le contrôle lui est rendu après traitement de la mémoire tampon. Les données ne s'affichent peut-être pas immédiatement ; elles peuvent s'afficher ultérieurement lors d'une opération de lecture ou d'une opération de lecture/écriture combinée. La mémoire tampon est ensuite disponible pour l'opération suivante de lecture ou de lecture/écriture combiné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

*SAME

La valeur reste inchangée.

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

*SAME

La valeur de format décimal reste inchangée.

*FILE

Utilisation de la valeur de format décimal stockée avec le fichier lors de sa création.

*JOB

Utilisation de la valeur de format décimal extraite de l'attribut de travail DECFMT lors de l'ouverture du fichier.

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.

*SAME

La valeur de texte SFLEND reste inchangée.

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

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

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

Pour les fichiers décrits par programme For program-described files

*SAME

La valeur reste inchangée.

*NO

Le fichier ne traite pas les données du jeu de caractères double octet (DBCS). The file does not process double-byte character set (DBCS) data.

*YES

Le fichier traite les données du jeu de caractères double octet. The file processes double-byte character set data.

Pour les fichiers décrits en externe For externally-described files

*SAME

La valeur reste inchangée.

*NO

Les attributs DBCS du fichier sont définis dans les spécifications de description de données (DDS). The DBCS attributes of the file are defined in the data description specifications (DDS).

*YES

Les attributs DBCS, en plus de ceux définis dans les DDS, comprennent (1) la prise en compte du mot clé DDS IGCALTTYP et (2) l'identification des attributs DBCS des zones ou des messages dans les DDS. DBCS attributes, in addition to those defined in the DDS, include (1) putting the DDS keyword IGCALTTYP into effect, and (2) identifying DBCS attributes of fields or messages in the DDS.

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.

*SAME

La valeur reste inchangée.

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

Temps d'attente maxi fichier (WAITFILE)

Indique le nombre de secondes pendant lesquelles le programme attend l'allocation des ressources système lors de l'ouverture du fichier. Si les ressources ne peuvent être allouées dans le temps imparti, un message d'erreur est envoyé au programme.

*SAME

Le délai d'attente n'est pas modifié.

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

*SAME

Le temps d'attente n'est pas modifié.

*NOMAX

Aucun temps d'attente maximum du programme n'est spécifié pour l'exécution d'une opération de lecture sur les unités sollicitées.

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

1 à 32767

Spécifiez, en secondes, le temps d'attente maximal nécessaire à la réalisation d'une opération de lecture sur les unités invitées.

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

*SAME

Le nom de la file d'attente de données ne change pas.

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

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.

*SAME

La valeur reste inchangée.

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

Exemples

Exemple 1 : Spécification de plusieurs unités écran

CHGDSPF   FILE(ORDENT)  DEV(WS1 WS2 WS3)  MAXDEV(3)

Cette commande permet de modifier la description du fichier écran ORDENT. Le fichier est recherché dans la liste de bibliothèques. Les unités utilisées avec ce fichier sont les postes de travail WS1, WS2 et WS3. Toutes les trois unités peuvent être utilisées simultanément avec ce fichier écran.

Exemple 2 : Retard de l'écriture de données

CHGDSPF   FILE(ACCREC/*ALL)  DFRWRT(*YES)

Cette commande permet de modifier la description de tous les fichiers écran de la bibliothèque ACCREC de manière à différer l'écriture des données tant qu'une demande de lecture n'est pas effectuée.

Considérations DBCS : non applicables

CHGDSPF   FILE(IGCLIB/IGCDSP)  IGCDTA(*YES)

Considérations DBCS : non applicables.

Messages d'erreur

*ESCAPE Messages

CPF7304

Fichier &1 de &2 non modifié.

CPF7308

&5 fichier(s) non modifié(s) pour &1 de &2. &4 modifié(s).