DSPOPT

La commande DSPOPT permet d'afficher des attributs de volume, de répertoire ou de fichier, en fonction de la valeur indiquée pour le paramètre DATA. Ces informations peuvent être imprimées, affichées ou écrites dans un fichier de sortie. Si la sortie est dirigée vers un fichier, ce dernier sera doté de l'un des formats d'enregistrement suivants :

• Lorsque le paramètre DATA(*VOLATR) est spécifié, le fichier base de données est doté d'un format d'enregistrement nommé QAMODVA. Les zones de la base de données sont identiques à celles du format QAMODVA fourni par IBM dans le fichier QAMODVAF qui se trouve dans la bibliothèque QSYS.
• Lorsque le paramètre DATA(*DIRATR) est spécifié, le fichier base de données est doté d'un format d'enregistrement nommé QAMODPA. Les zones de la base de données sont identiques à celles du format QAMODPA fourni par IBM dans le fichier QAMODPAF qui se trouve dans la bibliothèque QSYS.
• Lorsque le paramètre DATA(*FILATR) est spécifié, le fichier base de données est doté d'un format d'enregistrement nommé QAMODFA. Les zones de la base de données sont identiques à celles du format QAMODFA fourni par IBM dans le fichier QAMODFAF qui se trouve dans la bibliothèque QSYS.

Si la sortie est dirigée vers un espace utilisateur, les 140 premiers octets de celui-ci seront des données d'en-tête, suivies des données d'attribut demandées dans le même format que celui du fichier de sortie équivalent.

• Les 8 octets à partir du décalage 72 (48 hex) dans les données d'en-tête indiquent le type des données d'attribut dans l'espace utilisateur, au format alphanumérique.
  • QMODVA indique les données d'attribut de volume.
  • QMODPA indique les données d'attribut de répertoire.
  • QMODFA indique les données d'attribut de fichier.
• Les 4 octets à partir du décalage 128 (80 hex) dans les données d'en-tête indiquent la taille totale des données d'attribut, au format binaire.
• Les 4 octets à partir du décalage 132 (84 hex) dans les données d'en-tête indiquent le nombre de postes d'attribut, au format binaire.
• Les 4 octets à partir du décalage 136 (88 hex) dans les données d'en-tête indiquent la taille du poste d'attribut, au format binaire.

Restriction : Pour utiliser cette commande, vous devez disposer du droit *USE sur la liste d'autorisation applicable aux volumes en cours d'affichage.

Paramètres

Identificateur de volume (VOL)

Indique l'identificateur du volume optique qui contient les informations en cours d'affichage.

*ALL

Les informations s'affichent pour tous les volumes de l'unité optique indiquée qui est connectée directement (paramètre DEV).

*MOUNTED

Les informations s'affichent pour le volume monté sur l'unité indiquée (paramètre DEV).

Remarque :Cette valeur n'est admise que pour les unités optiques connectées directement et non pour les unités de bandothèque.

Identificateur-de-volume

Indiquez l'identificateur d'un volume optique.

identificateur-volume-générique*

Indiquez le nom générique de l'identificateur de volume. Un nom générique est une chaîne composée de un ou plusieurs caractères suivis d'un astérisque (*) (par exemple, ABC*). L'astérisque se substitue à n'importe quel caractère admis. Un nom générique entraîne l'affichage de tous les volumes des unités optiques connectées directement dont le nom commence par le préfixe générique et sur lesquels l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom d'objet complet.

Lecteur de disque optique (DEV)

Indique le nom de l'unité optique connectée directement contenant le volume optique dont les informations sont affichées.

Remarque :Ce paramètre n'est pas pris en compte lorsqu'un nom de volume précis est indiqué au paramètre VOL.

*ALL

Les attributs de volume s'affichent pour les volumes optiques de toutes les unités optiques connectées directement.

Remarque :Cette valeur n'est admise que lorsque VOL(*ALL) ou VOL(générique*) est indiqué.

unité-optique

Indique le nom d'une unité optique connectée directement.

Type de données (DATA)

Indique le type d'informations affiché pour le paramètre PATH. Si DATA(*SAVRST) est indiqué, les informations comportent une description de chaque objet sauvegardé dans le fichier optique ainsi que des informations récapitulatives sur les objets sauvegardés. Pour déterminer si le volume affiché contient des données au format de fichier STREAM de base ou au format de sauvegarde et de restauration, vous pouvez indiquer DATA(*FILATR) et vérifier les identificateurs de fichier de données répertoriés.

*VOLATR

Les attributs du ou des volumes indiqués sont affichés.

*DIRATR

Les attributs du ou des répertoires indiqués sont affichés.

*FILATR

Les attributs du ou des fichiers indiqués sont affichés.

*SAVRST

Les fichiers indiqués contiennent des données de sauvegarde et de restauration. Des informations récapitulatives sont affichées pour la commande et pour chaque objet sauvegardé.

Sortie (OUTPUT)

Indique si la sortie générée par la commande est affichée sur le poste de travail demandeur, imprimée avec la sortie spoule du travail, ajoutée à un fichier base de données ou dirigée vers un espace utilisateur.

*

La sortie demandée par un travail interactif s'affiche à l'écran. Si la commande est exécutée dans un travail par lots, la sortie est imprimée avec la sortie spoule du travail.

*PRINT

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

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué au paramètre OUTFILE.

*USRSPC

La sortie est ajoutée à l'espace utilisateur indiqué au paramètre USRSPC.

Chemin (PATH)

Indique le chemin du répertoire ou du fichier figurant sur le volume en cours d'affichage. Le paramètre DATA indique si les attributs de répertoire ou de fichier s'affichent. Il peut s'agir d'un nom simple ou d'un nom qualifié indiquant le nom du répertoire contenant l'objet. Vous pouvez indiquer un masque pour la dernière partie du nom. Un astérisque (*) correspond à un nombre quelconque de caractères. Si le nom est qualifié ou contient un masque, il doit être placé entre apostrophes (').

Remarque :Ce paramètre n'est pas pris en compte si DATA(*VOLATR) est indiqué.

*ALL

La valeur *ALL dépend de la manière dont le paramètre DATA a été défini. Vous trouverez ci-après la liste des différentes significations de cette valeur.

• DATA(*VOLATR) et PATH(*ALL), le paramètre PATH est ignoré.
• DATA(*SAVRST) et PATH(*ALL), tous les fichiers de sauvegarde et de restauration de tous les répertoires du volume sont répertoriés.
• DATA(*SAVRST) et PATH(/répertoire1/*ALL), tous les fichiers de sauvegarde et de restauration du chemin /répertoire1 sont répertoriés.
• DATA(*DIRATR) et PATH(*ALL), tous les attributs de tous les répertoires sont répertoriés.
• DATA(*DIRATR) et PATH(/répertoire1/*ALL), tous les attributs de tous les répertoires du chemin /répertoire1 sont répertoriés.
• DATA(*FILATR) et PATH(*ALL), tous les attributs de tous les fichiers du répertoire principal (/) du volume sont répertoriés.
• DATA(*FILATR) et PATH(/répertoire1/*ALL), tous les attributs de tous les fichiers du /répertoire1 du volume sont répertoriés.

nom-chemin

Indiquez le nom qualifié complet du répertoire ou du fichier dont les attributs sont à répertorier.

nom-chemin-générique*

Indiquez le nom générique de l'identificateur de chemin. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) ; par exemple, /directory1/file*. L'astérisque remplace tout caractère admis. Un nom générique entraîne l'affichage de tous les attributs de répertoires ou fichiers dont le nom commence par un caractère générique et sur lesquels l'utilisateur dispose de droits. Si le nom (préfixe) générique ne comporte pas d'astérisque, le système considère qu'il s'agit du nom d'objet complet.

User space (USRSPC)

Indique l'espace utilisateur auquel la sortie d'écran est ajoutée.

Remarque :Ce paramètre n'est admis que si OUTPUT(*USRSPC) est indiqué.

Qualificatif 1 : User space

nom-espace-utilisateur

Indiquez le nom de l'espace utilisateur recevant la sortie.

Qualificateur 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Remplacer l'espace utilisateur (REPLACE)

Indique si un espace utilisateur existant doit être remplacé ou non.

Remarque :Ce paramètre n'est admis que si OUTPUT(*USRSPC) est indiqué. Il n'est pas pris en compte si l'espace utilisateur est introuvable dans la bibliothèque indiquée.

*YES

L'espace utilisateur est remplacé s'il est trouvé. Les droits existants de l'espace utilisateur d'origine sont conservés, mais le contenu de ce dernier est remplacé.

*NO

L'espace utilisateur n'est pas remplacé s'il est trouvé. La demande s'arrête et un message est envoyé à l'historique du travail pour indiquer que l'espace utilisateur existe déjà dans la bibliothèque et qu'il ne peut pas être créé.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie générée par la commande est dirigée. Si ce fichier n'existe pas, la commande en crée un dans la bibliothèque précisée. S'il existe déjà, les droits publics sur le fichier sont les mêmes que le droit de création de la pour la bibliothèque contenant le fichier. Pour afficher ce droit, utilisez la commande DSPLIBD (Afficher une description de bibliothèque).

Qualificatif 1 : Fichier recevant la sortie

nom

Indiquez le nom du fichier de base de données vers lequel la sortie générée de la commande est dirigée.

Qualificateur 2: Biblio

*LIBL

Le fichier est recherché dans la liste des bibliothèques. Si le système ne le trouve pas, il en crée un dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL.

*CURLIB

Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

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

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : Affichage des attributs de tous les volumes optiques

DSPOPT   VOL(*ALL)  DEV(*ALL)

Cette commande affiche les attributs des tous les volumes de toutes les unités et bibliothèques optiques locales.

Exemple 2 : Affichage des attributs à l'aide d'une recherche générique

DSPOPT   VOL(PAY*)  DATA(*DIRATR)  PATH('/*')

Cette commande affiche les attributs de tous les répertoires de la racine de tous les volumes optiques dont le nom commence par la chaîne de caractères PAY.

Exemple 3 : Affichage des attributs d'un répertoire donné

DSPOPT   VOL(VOL01)  DEV(OPT01)  DATA(*FILATR)
         PATH('/DIR1/DIR2/*')

Cette commande affiche les attributs de tous les fichiers du répertoire /DIR1/DIR2 du volume optique VOL01.

Exemple 4 : Affichage des données de sauvegarde et de restauration

DSPOPT   VOL(*MOUNTED)  DEV(OPT01)  DATA(*SAVRST)
         PATH('*ALL')

Cette commande affiche les données de sauvegarde et de restauration de tous les fichiers se trouvant sur le volume optique monté dans l'unité OPT01.

Messages d'erreur

*ESCAPE Messages

CPF1247

Sous-système &1 ne peut pas démarrer travail anticipé &2.

CPF384C

Erreur lors de la conversion du CCSID.

CPF3864

&2 &1 de &3 non restauré.

CPF386A

Fichier non trouvé.

CPF5729

Allocation de l'objet &1 impossible.

CPF9810

Bibliothèque &1 non trouvée.

CPF9815

Membre &5 du fichier &2 dans &3 non trouvé.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9860

Erreur lors du traitement du fichier de sortie.

OPT1115

Fichier non trouvé.

OPT1125

Fichier en cours d'utilisation.

OPT1135

Echec de la demande : nombre maximal de fichiers ouverts atteint.

OPT1140

Erreur inattendue lors du traitement du fichier.

OPT1185

Impossible d'accéder au fichier optique suspendu.

OPT1205

Répertoire non trouvé.

OPT1212

Répertoire en cours d'utilisation.

OPT1224

Longueur du nom de chemin supérieure à 256 octets.

OPT1247

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

OPT1255

Fichier altéré.

OPT1317

Nom de répertoire trop long.

OPT1320

Volume optique &1 en cours d'utilisation.

OPT1325

Format de volume optique non reconnu.

OPT1330

Volume optique non trouvé ou inutilisable.

OPT1331

Volume optique &1 non trouvé.

OPT1340

Volume optique &1 non initialisé.

OPT1346

Opération non admise pour un volume situé sur un lecteur de disque optique éloigné.

OPT1360

Répertoire de support endommagé sur le volume optique &1.

OPT1427

Nom de volume générique ou valeur *ALL non admis avec la valeur de DATA.

OPT1460

Le volume optique &1 ne se trouve pas dans un lecteur de disque optique.

OPT1463

Opération non exécutée : le volume optique n'est pas un volume principal.

OPT1489

Paramètre de volume non admis pour l'unité &1.

OPT1530

&1 n'est pas un lecteur de disque optique correct.

OPT1555

Lecteur de disque optique &1 en cours d'utilisation.

OPT1605

Erreur de support ou d'unité.

OPT1640

Erreur lors de la lecture de fichiers ou de répertoires.

OPT1790

Opération non admise ou incompatible avec une autre demande.

OPT1805

Erreur lors de l'accès au fichier d'index des volumes optiques.

OPT1810

Erreur lors de l'accès au fichier d'index des répertoires optiques.

OPT1813

Une erreur inattendue s'est produite.

OPT1815

Erreur de programme interne.

OPT1820

Une erreur interne s'est produite sur le lecteur de disque optique &1.

OPT1821

Une erreur s'est produite sur le lecteur de disque optique &1.

OPT1825

Index optiques incorrects pour le lecteur de disque optique &1.

OPT1860

L'opération sur le lecteur de disque optique &1 n'a pas abouti.

OPT1861

Aucune description d'unité n'est configurée pour la ressource &1.

OPT1862

Aucune description d'unité active ne correspond à la ressource &1.

OPT1863

Les bibliothèques optiques doivent être récupérées.

OPT1872

Dépassement de délai ou annulation suite à une demande sur un lecteur de disque optique.

OPT2040

Erreur lors de l'accès au fichier de contrôle de sauvegarde.

OPT2301

Objet système interne en cours d'utilisation.

OPT2420

Accès au volume optique &2 refusé.

OPT2422

Non autorisé sur ce fichier ou ce répertoire.

OPT6713

L'affichage des informations détaillées sur le volume a échoué.

OPT7740

Utilisateur non autorisé pour l'objet &2, bibliothèque &3, de type &4.