CRTDKTF

La commande CRTDKTF (Créer un fichier disquette) permet de créer un fichier unité de disquette.

Un fichier unité de disquette sert à lire et à écrire des enregistrements sur des disquettes initialisées dans le format d'échange standard, H ou I. Ce fichier identifie l'unité de disquette utilisée ainsi que les options de mise en file d'attente. Il ne contient pas de données.

Remarque :Cette commande ne permet pas de créer des fichiers unité à utiliser lors des opérations de sauvegarde/restauration. Les fichiers unité créés par l'utilisateur ne sont pas requis pour les opérations de sauvegarde/restauration.

Toutes les informations de la description de fichier disquette sont contenues dans la commande qui les a créées ; aucune spécification de description de données (DDS) n'existe pour les fichiers disquette. Un fichier disquette ne comporte qu'un seul format d'enregistrement pour les opérations d'entrée-sortie. Le format d'enregistrement est constitué d'une zone alphanumérique contenant les données en entrée extraites de l'unité ou les données en sortie écrites sur l'unité. Le programme utilisant le fichier unité doit décrire les zones du format d'enregistrement de sorte que le programme puisse organiser les données reçues de l'unité ou envoyées à celle-ci de la manière indiquée par la description du fichier disquette.

Paramètres

Fichier (FILE)

Indique le fichier à créer. Si ce fichier est utilisé par un programme écrit dans un langage évolué (HLL), son nom doit respecter les règles d'appellation en vigueur pour ce langage. Sinon, le fichier doit être rebaptisé

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier

nom

Indiquez le nom du fichier disquette à créer.

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 dans laquelle figure le fichier disquette.

Unité (DEV)

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

*NONE

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

nom

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

Identificateur de volume (VOL)

Indique un ou plusieurs identificateurs de volume utilisés par le fichier.

Valeurs uniques

*NONE

Les identificateurs de volume ne sont pas précisés pour ce fichier.

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

valeur-alphanumérique

Indiquez les identificateurs d'un ou de plusieurs volumes de disquette, dans l'ordre dans lequel ils sont placés sur l'unité de disquette et sont utilisés par le fichier unité. La longueur de chaque identificateur est de 6 caractères alphanumériques au maximum.

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.

*NONE

Le label de fichier de données n'est pas indiqué.

valeur-alphanumérique

Indiquez un identificateur, de 8 caractères au maximum, pour le fichier de données utilisé avec ce fichier unité de disquette.

Type de fichier (FILETYPE)

Indique si le fichier unité de disquette créé décrit des enregistrements de données ou des enregistrements source (instructions) pour un programme ou un autre fichier.

*DATA

Le fichier de disquette décrit des enregistrements de données.

*SRC

Le fichier de disquette décrit des enregistrements source.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

*NO

Considérations DBCS : non applicable.

*YES

Considérations DBCS : non applicable.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Entrez, entre apostrophes, un texte de 50 caractères au maximum.

Type échange fichier disquette (EXCHTYPE)

Indique, pour les fichiers en sortie sur disquette uniquement, le type d'échange utilisé par le fichier unité lorsque le système écrit les données sur disquette.

*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 effectuée par un travail utilisant ce fichier unité de disquette.

*EBCDIC

Le code EBCDIC est utilisé avec ce fichier unité.

*ASCII

Le code caractères ASCII est utilisé.

Date de création (CRTDATE)

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

*NONE

La date de création n'est pas indiquée.

date

Indiquez la date de création du fichier de données utilisé par ce fichier unité de disquette.

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.

*NONE

Aucune date de péremption n'est spécifiée pour ce fichier de données. Il est protégé pendant une journée seulement.

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

Données en spoule (SPOOL)

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

*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 directement écrites sur la disquette.

*YES

Les données sont placées en file d'attente.

File d'attente en sortie (OUTQ)

Indique l'objet de la file d'attente en sortie (*OUTQ).

Qualificatif 1 : File d'attente en sortie

QDKT

Les données spoule en sortie sont envoyées dans la file d'attente en sortie QDKT.

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 file d'attente en sortie est recherchée 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 contenant la file d'attente en sortie.

Nombre maxi enreg en sortie (MAXRCDS)

Indique le nombre maximal d'enregistrements de disquette que peut contenir un fichier spoule en sortie.

100000

Le nombre maximal est de 100000 enregistrements disquette.

*NOMAX

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

1 à 500000

Indiquez le nombre maximal d'enregistrements disquette contenus dans le fichier spoule en sortie.

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.

*FILEEND

Le fichier spoule en sortie est disponible pour l'éditeur dès sa fermeture.

*JOBEND

Le fichier spoule en sortie est disponible pour l'éditeur une fois le travail terminé.

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

Indique si le travail était suspendu quand il a été placé en file d'attente. Un travail demeure suspendu, jusqu'à ce qu'il soit libéré par la commande RSLJOB ( Libérer un travail) ou arrêté par la commande ENDJOB (Arrêter un travail) ou CLRJOBQ (Mettre à blanc une file d'attente de travaux).

*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, pour les fichiers spoule en sortie uniquement, s'ils sont sauvegardés (conservés dans la file d'attente en sortie) une fois la sortie effectuée.

*NO

Les données du fichier spoule ne sont pas sauvegardées dans la file d'attente en sortie.

*YES

Les données du fichier spoule sont sauvegardées dans la file d'attente en sortie jusqu'à la suppression du fichier spoule.

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.

*JOB

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

1-9

Indiquez un chiffre allant de 1 (priorité la plus élevée) à 9 (priorité la plus basse).

Référence utilisateur (USRDTA)

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

*BLANK

Une valeur de 10 blancs est utilisée.

valeur-alphanumérique

Indiquez jusqu'à 10 caractères de texte utilisateur.

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.

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.

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 est remplacé si la création du nouveau fichier unité de disquette de même nom et appartenant à la même bibliothèque a réussi.

*NO

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

Exemples

Exemple 1 : Création d'un fichier d'unité de disquette

CRTDKTF   FILE(DSPHST)

Cette commande permet de créer un fichier d'unité de disquette appelé DSPHST. Les valeurs par défaut sont utilisées pour tous les autres paramètres. Le nom d'unité, le volume de disquette, le label de fichier et la date de création du fichier de données sur disquette doivent être indiqués dans une autre commande CL ou dans chaque programme utilisant le fichier d'unité. Ce dernier décrit des fichiers de données sur disquette en code EBCDIC, qui sont placés en file d'attente pour les entrées et les sorties. Les sorties sont mises dans la file d'attente en sortie QDKT, puis sur disquette une fois le fichier fermé par le programme. Lorsqu'une sortie est générée à partir de la file d'attente en sortie, un seul exemplaire est généré.

Considérations DBCS : non applicables

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

Considérations DBCS : non applicables.

Messages d'erreur

*ESCAPE Messages

CPF7302

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