CHGDKTF

La commande CHGDKTF (Modifier un fichier disquette) permet de modifier les attributs du fichier unité de disquette indiqué.

Paramètres

Fichier (FILE)

Indique le fichier disquette à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier DDM

nom

Indiquez le nom du fichier.

Qualificatif 2: Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

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.

Unité (DEV)

Indique le nom de l'unité de disquette utilisée avec ce fichier disquette pour des opérations d'entrée/sortie. Le nom d'unité figurant dans la description fournie par IBM est QDKT qui se trouve dans la bibliothèque QGPL. Ce paramètre est ignoré si SPOOL(*YES) est indiqué pour le fichier lors de l'ouverture de celui-ci.

*SAME

Le nom d'unité n'est pas modifié.

*NONE

Aucun nom d'unité n'est spécifié. Le nom de l'unité de disquette devra être précisé plus tard dans une autre commande CHGDKTF (Modifier un fichier disquette) ou OVRDKTF (Substituer un fichier disquette), ou dans le programme en langage évolué qui ouvre le fichier.

nom

Indiquez le nom de l'unité de disquette à utiliser avec ce fichier unité de disquette.

Identificateur de volume (VOL)

Indique un ou plusieurs identificateurs de volume pour les disquettes utilisées par ce fichier unité de disquette.

Valeurs uniques

*SAME

Les identificateurs de volume ne sont pas modifiés.

*NONE

Aucun identificateur de volume n'est indiqué. Ils peuvent être fournis avant l'ouverture du fichier unité, soit dans la commande OVRDKTF (Substituer un fichier disquette), soit dans la commande CHGDKTF (Modifier un fichier disquette), ou dans le programme en langage évolué. Si aucun identificateur de volume n'est précisé, aucun contrôle d'identificateur de volume n'est effectué.

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

valeur-alphanumérique

Indiquez les identificateurs d'un ou de plusieurs volumes, dans l'ordre où ils sont placés sur l'unité et utilisés par ce fichier unité. Chaque identificateur peut comporter jusqu'à 6 caractères alphanumériques.

Label disquette (LABEL)

Indique le ou les identificateurs de fichiers de données de la disquette affichée. L'ID fichier de données est stocké sur la disquette dans la zone relative au label de volume et permet d'identifier le fichier correspondant contenu sur cette disquette.

*SAME

Le label de fichier de données ne change pas.

*NONE

Aucun label de fichier de données n'est indiqué. Il doit être fourni avant ouverture du fichier unité, soit dans la commande OVRDKTF (Substituer un fichier disquette), soit dans la commande CHGDKTF (Modifier un fichier disquette), ou dans le programme en langage évolué.

valeur-alphanumérique

Indiquez l'identificateur (8 caractères maximum) du fichier de données à utiliser avec ce fichier unité de disquette.

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.

Type échange fichier disquette (EXCHTYPE)

Indique, pour les fichiers en sortie sur disquette uniquement, le type d'échange utilisé par le fichier unité lors d'une opération d'écriture sur disquette.

*SAME

Le type d'échange n'est pas modifié.

*STD

Le format d'échange BASIC est utilisé pour une disquette de type 1 ou 2. Le format d'échange H est utilisé pour une disquette de type 2D .

*BASIC

le type d'échange BASIC est utilisé.

*H

Le type d'échange H est utilisé.

*I

Le type d'échange I est utilisé.

Code (CODE)

Indique le type de code caractères utilisé lors d'une opération de lecture ou écriture sur disquette.

*SAME

Le type de code caractères ne change pas.

*EBCDIC

Le code EBCDIC est utilisé.

*ASCII

Le code caractères ASCII est utilisé.

Date de création (CRTDATE)

Indique la date de création du fichier de données sur la disquette. Si cette date ne correspond pas à celle spécifiée pour le fichier unité lors de son ouverture, un message d'erreur est envoyé au programme utilisateur.

*SAME

La date de création du fichier disquette n'est pas modifiée.

*NONE

La date de création du fichier de données n'est pas vérifiée.

date

Indiquez la date de création du fichier disquette de données devant être utilisé par ce fichier unité. Elle devra être indiquée dans le format défini par les attributs du travail, DATFMT et DATSEP. Le label disquette est écrit sous la forme AAMMJJ.

Date d'expiration du fichier (EXPDATE)

Indique, pour les fichiers de données en sortie sur disquette uniquement, la date de péremption du fichier de données utilisé par ce fichier unité. Si une date est indiquée, le fichier sera protégé en écriture jusqu'au jour suivant la date de péremption mentionnée.

*SAME

La date de péremption du fichier de données n'est pas modifiée.

*NONE

Le fichier de données n'est protégé que le jour même de sa création sur la disquette.

*PERM

Le fichier de données est protégé de façon permanente. La date figurant sur la disquette est 999999.

date

Indiquez la date de péremption du fichier de données. Le label disquette sera sous la forme AAMMJJ.

Données en spoule (SPOOL)

Indique si les données en entrée ou en sortie du fichier disquette sont placées en file d'attente. Si *NO est précisé, les autres paramètres de cette commande, liés à la mise en file d'attente ne sont pas pris en compte.

*SAME

La valeur pour la mise en file d'attente des données ne change pas.

*NO

Les données ne sont pas placées en file d'attente. Si ce fichier est ouvert en entrée, les données sont lues directement sur la disquette. S'il s'agit d'un fichier en sortie, les données sont écrites directement sur la disquette.

*YES

Les données sont placées en file d'attente. Si ce fichier est ouvert pour l'entrée de données, un fichier spoule en entrée du nom indiqué est traité ; sinon, le fichier spoule en entrée suivant est traité. Pour plus de détails sur les fichiers spoule en entrée nommés et non nommés, reportez-vous au manuel Catégorie des fichiers et systèmes de fichiers de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. S'il s'agit d'un fichier en sortie, les données sont placées en file d'attente à des fins de traitement par une disquette ou par un éditeur d'impression.

File d'attente en sortie (OUTQ)

Indique le nom de la file d'attente en sortie utilisée pour les fichiers spoule indiquant OUTQ(*JOB). Ce paramètre s'applique uniquement aux fichiers d'imprimante pour lesquels la valeur *JOB a été précisée pour le paramètre OUTQ.

Valeurs uniques

*SAME

La file d'attente en sortie n'est pas modifiée.

Qualificatif 1 : File d'attente en sortie

nom

Indiquez le nom de la file d'attente en sortie.

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.

Nombre maxi enreg en sortie (MAXRCDS)

Indique, pour une sortie spoule uniquement, le nombre maximal d'enregistrements pouvant être contenus dans le fichier spoule en sortie correspondant à ce fichier unité de disquette.

*SAME

Le nombre maximal d'enregistrements n'est pas modifié.

*NOMAX

Le nombre d'enregistrements est le nombre maximal admis par le système (500000).

1 à 500000

Indiquez un nombre maximal d'enregistrements.

Prévision de sortie spoule (SCHEDULE)

Indique, pour les fichiers spoule en sortie uniquement, le moment où le fichier est mis à la disposition d'un éditeur de disquette.

*SAME

Le moment où démarre la sortie spoule ne change pas.

*JOBEND

Le fichier spoule en sortie est disponible une fois le travail terminé.

*FILEEND

Le fichier spoule en sortie est disponible à la fermeture du fichier par le programme.

*IMMED

Le fichier spoule en sortie est mis à la disposition de l'éditeur de spoule dès son ouverture par le programme.

Suspendre fichier spoule (HOLD)

Pour un fichier spoule en sortie uniquement, indique si ce fichier est suspendu ou non. Dans l'affirmative, il peut être libéré à l'aide de la commande RLSSPLF (Libérer un fichier spoule).

*SAME

L'état du fichier spoule n'est pas modifié.

*NO

Le fichier spoule en sortie n'est pas suspendu dans la file d'attente en sortie.

*YES

Le fichier spoule en sortie est suspendu jusqu'à ce qu'il soit libéré via la commande RLSSPLF.

Conserver fichier spoule (SAVE)

Indique si le fichier spoule est sauvegardé (conservé dans la file d'attente en sortie) une fois la sortie produite. Ce paramètre ne concerne que les fichiers spoule en sortie.

*SAME

L'état du fichier spoule n'est pas modifié.

*NO

Le fichier spoule n'est pas conservé dans la file d'attente en sortie.

*YES

Le fichier spoule est conservé dans la file d'attente en sortie jusqu'à sa suppression.

Priorité de sortie (en OUTQ) (OUTPTY)

Indique la priorité de sortie pour les fichiers spoule en sortie produits par ce travail. Le niveau de priorité le plus élevé est 1, et le niveau le plus bas est 9.

*SAME

La priorité de sortie n'est pas modifiée.

*JOB

La priorité de sortie du travail qui a créé le fichier spoule est utilisée.

1-9

Indiquez le niveau de priorité en sortie à l'aide d'un chiffre, de 1 (le plus élevé) à 9 (le plus bas).

Référence utilisateur (USRDTA)

Pour les sorties spoule, indique la référence définie par l'utilisateur pour identifier le fichier.

*SAME

La référence n'est pas modifiée.

*BLANK

Une valeur de 10 blancs est utilisée.

valeur-alphanumérique

Entrez un texte d'une longueur maximale de 10 caractères.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

*SAME

La valeur reste inchangée.

*NO

Considérations DBCS : non applicable.

*YES

Considérations DBCS : non applicable.

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.

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

L'option de partage de chemin d'ouverture n'est pas modifié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 : Les données ne sont pas placées en file d'attente

CHGDKTF   FILE(ACCREC/PRNTRPT)  SPOOL(*NO)

Cette commande permet de modifier le fichier d'unité disquette PRNTRPT stocké dans la bibliothèque ACCREC. Grâce au fichier d'unité, toutes les opérations d'entrée-sortie entre le programme et la disquette sont directes (sans mise en file d'attente). Les autres valeurs de la description de fichier ne sont pas modifiées.

Considérations DBCS : non applicables

CHGDKTF   FILE(IGCLIB/IGCDKT)  IGCDTA(*YES)

Considérations DBCS : non applicables.

Messages d'erreur

*ESCAPE Messages

CPF7304

Fichier &1 de &2 non modifié.