DATA

La commande DATA (Données) doit être utilisée dans un flot de travaux en entrée pour indiquer le début d'un fichier spoule en entrée. Ce flot est lu par un lecteur de spoule. La commande DATA détermine également le séparateur à utiliser pour indiquer la fin du fichier de données. Les fichiers spoule en entrée n'existent que pendant la durée du travail et sont détruits lorsque celui-ci est terminé. Les fichiers ne portant pas de nom ne peuvent être utilisés qu'une seule fois dans un même travail.

Restrictions

1. La commande DATA ne peut pas être exécutée à partir d'un poste de travail.
2. La commande DATA doit comporter deux barres obliques (//) dans les positions 1 et 2 de l'enregistrement.
3. Les barres obliques peuvent être séparées du nom de la commande par des blancs (//DATA).

Paramètres

Fichier d'entrée (FILE)

Indique le nom du fichier spoule en entrée. Ce nom est également précisé dans le programme traitant le fichier.

QINLINE

Le nom du fichier spoule en entrée est QINLINE. Le fichier est traité comme un fichier spoule en entrée non nommé. Un fichier non nommé est traité si QINLINE est indiqué dans le programme comme nom de fichier, ou si le fichier unité pour lequel *YES est indiqué au paramètre SPOOL (Données en spoule) est ouvert en lecture. Les fichiers spoule en entrée non nommés ne peuvent être utilisés qu'une seule fois par le travail.

nom

Indiquez le nom du fichier spoule en entrée utilisé par un ou plusieurs programmes du travail. Le fichier est associé au programme quand ce dernier ouvre le fichier en indiquant son nom. Le travail peut accéder plusieurs fois aux fichiers spoule en entrée nommés.

Type de fichier (FILETYPE)

Indique si les données du fichier spoule en entrée suivant la commande sont entrées au format standard de fichier source ou au format de fichier de données. Le format standard de fichier source est un numéro de séquence (numéro source de 6 caractères), suivi d'une date système de 6 caractères précédant les données.

*DATA

Les données du fichier spoule en entrée ne sont pas au format standard de fichier source. Le fichier de données est transmis au programme qui l'utilise au format de fichier de données.

*SRC

Les données sont numérotées séquentiellement ; elles constituent un fichier source pouvant être utilisé pour créer un autre fichier ou un autre programme.

Caractères de fin de données (ENDCHAR)

Indique la chaîne de caractères utilisée pour délimiter la fin d'un fichier spoule en entrée. La chaîne ne sera reconnue que si elle commence à la position 1 de l'enregistrement. Si vous entrez comme séparateur une chaîne de caractères différente de // (valeur par défaut), tous les enregistrements seront traités comme des données jusqu'à l'enregistrement de fin de fichier (celui qui contient la chaîne de caractères indiquée à la position appropriée). Ceci vous permet d'imbriquer des commandes de lecteur dans le flot de données. L'enregistrement de fin de fichier pour les valeurs ENDCHAR (qui ne sont pas les valeurs par défaut) n'est pas placé dans le fichier de données et aucun contrôle n'est effectué pour vérifier qu'il s'agit d'une commande de lecteur admise. Cet enregistrement est utilisé uniquement pour déterminer la fin du flot de données, puis il est supprimé.

'//'

La valeur par défaut est deux barres obliques. Il est possible de coder les deux barres dans le paramètre ou de conserver la valeur par défaut de ce dernier, mais, dans les deux cas, l'effet de la commande est identique. Si la valeur par défaut est utilisée, les barres obliques placées en position 1 et 2 d'un enregistrement (soit dans un fichier de données, soit dans un fichier source) désignent le premier enregistrement n'appartenant pas au fichier.

valeur-caractère

Il est possible d'entrer une chaîne de caractères (au maximum 25 caractères entre apostrophes) pour indiquer le dernier enregistrement du fichier. Cette chaîne peut contenir des caractères alphanumériques et des caractères spéciaux. Si la combinaison de caractères indiquée au paramètre ENDCHAR (Caractères de fin de données) est différente de '//', vous pouvez imbriquer des commandes de lecteur dans les données. Lorsque le lecteur recherche la chaîne indiquée, il ignore toutes les autres données, y compris les commandes de lecteur.

User specified DBCS data (IGCDTA)

Indique si les données en ligne qui suivent cette commande peuvent contenir des données DBCS.

*NO

Ce fichier en ligne ne contient pas de données DBCS.

*YES

Le fichier en entrée peut contenir des données DBCS.

Exemples

Exemple 1 : Fichier spoule en entrée au format de fichier de données

 //DATA   FILE(FILE1)

Cette commande permet d'attribuer le nom FILE1 aux données qui lui font suite, jusqu'à détection d'une condition de fin des données en entrée (deux barres obliques aux positions 1 et 2).

Exemple 2 : Définition d'une chaîne de caractères de fin

 //DATA   FILE(FILE2)  ENDCHAR('STOPIT')

Cette commande permet d'attribuer le nom FILE2 aux données qui lui font suite ; le traitement du fichier se poursuit jusqu'à détection d'un enregistrement contenant les caractères STOPIT aux positions 1 à 6. Ce délimiteur permet d'imbriquer dans un fichier en entrée les commandes //BCHJOB, //ENDBCHJOB et //DATA et les enregistrements avec // aux positions 1 et 2.

Exemple 3 : Définition d'un fichier contenant des données DBCS

 //DATA   FILE(FILE3)  IGCDTA(*YES)

Cette commande permet d'attribuer le nom FILE3 aux données qui lui font suite. Ce fichier peut contenir des données DBCS.

Messages d'erreur

Messages *ESCAPE

CPF1753

Commande non exécutable.