DSPDTAARA

Afficher une zone de données

En bref

La commande DSPDTAARA (Afficher une zone de données) permet à l'utilisateur d'afficher les attributs et la valeur de la zone de données indiquée.

DSPDTAARA se lit DSP (Afficher) + DTAARA. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DSPDTAARA DTAARA(…)

Paramètres

DTAARA Zone de données obligatoire
OUTPUT Sortie
OUTFMT Format de sortie
SYSTEM Système

Astuce : dans une session 5250, tapez DSPDTAARA 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 DSPDTAARA (Afficher une zone de données) permet à l'utilisateur d'afficher les attributs et la valeur de la zone de données indiquée. Les attributs suivants sont affichés : le type et la longueur de la zone de données, le nom de la bibliothèque contenant la zone de données (aucune bibliothèque n'est associée à une zone de données locale, de groupe ou de paramètre d'initialisation de programme), et le texte décrivant la zone de données. Restrictions :

Pour utiliser cette commande, vous devez disposer du droit d'utilisation (*USE) sur la zone de données et du droit d'exécution (*EXECUTE) sur la bibliothèque. Aucun droit spécifique n'est requis pour la zone de données locale, la zone de données de groupe ou la zone de données PIP.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
DTAARA	Zone de données	Valeurs uniques: LDA, GDA, PDA Autres valeurs: Nom d'objet qualifié*	Obligatoire, positionnel 1
	Qualificatif 1: Zone de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTPUT	Sortie	, PRINT	Facultatif, positionnel 2
OUTFMT	Format de sortie	CHAR, HEX	Facultatif
SYSTEM	Système	LCL, RMT	Facultatif

Zone de données (DTAARA)

Indique le nom et la bibliothèque de la zone de données dont les attributs et les valeurs doivent être affichés.

Ce paramètre est obligatoire.

Valeurs uniques

*LDA: Affiche la zone de données locale. La zone de données locale (*LDA) correspond à une zone de données de type caractère comportant 1024 octets. Elle est automatiquement associée à votre travail et aucun autre travail ne peut y avoir accès.
*GDA: S'il s'agit d'un travail de groupe, affiche la zone de données de groupe. Cette zone de données est automatiquement associée au groupe ; les travaux extérieurs à celui-ci ne peuvent pas y avoir accès. Cette zone de données de type caractère comporte 512 octets.
*PDA: Affiche la zone de données de paramètre d'initialisation de programme. Cette valeur n'est admise que si le travail est un travail à démarrage anticipé. La longueur de cette zone de données est de 2000 octets.

Qualificatif 1 : Zone de données

nom: Indiquez le nom de la zone de données.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom: Indiquez le nom de la bibliothèque contenant la zone de données.

Sortie (OUTPUT)

Indique si la sortie générée par la commande doit être affichée sur le poste de travail demandeur, ou imprimée avec la sortie spoule du travail.

*: La sortie est affichée pour les travaux interactifs ou imprimée avec la sortie spoule de travaux dans le cas des travaux non interactifs.

*PRINT: Le résultat est placé dans un fichier spoule de la file d'attente en sortie du travail.

Format de sortie (OUTFMT)

Indique le format d'affichage de la valeur de la zone de données. L'affichage des deux représentations (alphanumérique et hexadécimale) permet de connaître la valeur hexadécimale des caractères non affichables.

*CHAR: Les données en sortie sont affichées en format alphanumérique.
*HEX: Les données en sortie sont affichées en format hexadécimal et alphanumérique. Cette valeur est uniquement utilisée pour des zones de données alphanumériques.

Système (SYSTEM)

Indique si les informations fournies concernent la zone de données sur le système local (*LCL) ou le système éloigné (*RMT).

*LCL: Les données affichées concernent la zone de données locale du système local.
*RMT: Les données affichées proviennent de la zone de données éloignée indiquée au paramètre RMTDTAARA d'une commande CRTDTAARA (Créer une zone de données) qui a abouti. Pour visualiser ces données, spécifiez le nom de la zone de données créée par la commande CRTDTAARA, et non le nom de la zone de données éloignée.

Exemples

Exemple 1 : affichage d'une sortie en format hexadécimal et alphanumérique

DSPDTAARA   DTAARA(HEXDATA)  OUTPUT(*)  OUTFMT(*HEX)

La valeur et les attributs de la zone de données HEXDATA s'affichent si l'utilisateur dispose des droits appropriés. Les représentations en format hexadécimal et alphanumérique s'affichent toutes les deux.

Exemple 2 : affichage d'une sortie en format alphanumérique

DSPDTAARA   DTAARA(TIME)  OUTPUT(*)

La valeur et les attributs de la zone de données TIME s'affichent si l'utilisateur dispose des droits appropriés. La liste des bibliothèques est utilisée pour rechercher la zone de données.

Messages d'erreur

Messages *ESCAPE

CPF1015: Zone de données &1 non trouvée dans &2.
CPF1016: Non autorisé à utiliser la zone de données &1 de &2.
CPF1021: Bibliothèque &1 non trouvée pour zone de données &2.
CPF1022: Non autorisé à bibliothèque &1 pour zone de données &2.
CPF104A: SYSTEM(*RMT) non admis pour la zone de données &1 de &2.
CPF1046: DTAARA(*GDA) admis uniquement pour travaux de groupe.
CPF1048: OUTFMT(*HEX) incorrect pour zone de données &1 de &2.
CPF1063: Impossible d'allouer la zone de données &1 dans &2.
CPF1067: Impossible d'allouer la bibliothèque &1.
CPF1072: Paramètre DTAARA(*PDA) incorrect car il ne s'agit pas d'un travail anticipé.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.
CPF9847: Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9850: Substitution non admise pour fichier imprimante &1.
CPF9851: Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
CPF9871: Erreur lors du traitement.
CPF9899: Erreur lors du traitement de la commande.