DSPATR

La commande Afficher attributs (DSPATR) affiche les attributs d'un seul objet, de tous les objets correspondant à un masque donné ou de tous les objets d'une arborescence donnée.

Pour plus d'informations sur les commandes du système de fichiers intégré, reportez-vous aux Rubriques Système de fichiers intégré de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Remarque :Les droits requis pour cette commande sont complexes concernant les systèmes de fichiers, les types d'objet, les opérations demandées, etc. Pour toute information sur les droits requis pour cette commande, consultez le manuel IBM i Security Reference, SC41-5302

Paramètres

Objet (OBJ)

Indique le nom de chemin de l'objet ou un masque correspondant au nom des objets dont l'attribut sera affiché. 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, alors qu'un point d'interrogation (?) correspond à un caractère unique. Si le nom est qualifié ou contient un masque, il doit être placé entre apostrophes ('). Si plusieurs objets correspondent au masque indiqué et que la valeur du paramètre Sortie (OUTPUT) n'est pas *PRINT, l'utilisateur peut sélectionner l'objet voulu à partir d'une liste, dans le cadre d'un travail interactif. Dans le cadre d'un travail par lots, la commande n'aboutit pas et le message d'erreur CPFA08E "Plusieurs noms correspondent au masque." apparaît.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Ce paramètre est compatible Unicode. Pour plus d'informations, reportez-vous à la section sur la prise en charge Unicode dans CL, dans les Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

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.

Branche du répertoire (SUBTREE)

Indique si les attributs des objets figurant dans la sous-arborescence de répertoires doivent s'afficher lorsque l'objet indiqué au paramètre Objet (OBJ) est un répertoire.

*NONE

Permet d'afficher les attributs de l'objet désigné par OBJ. Si l'objet est un répertoire, ses attributs s'affichent, mais les attributs de son contenu ne s'affichent pas.

*ALL

Permet d'afficher les attributs de l'objet désigné par OBJ. Si l'objet est un répertoire, ses attributs s'affichent, ainsi que les attributs de son contenu, de ses sous-répertoires, et le contenu de tous ses sous-répertoires. Si cette valeur est indiquée, la valeur du paramètre Sortie (OUTPUT) doit être *PRINT.

Remarque :Le filtrage du paramètre OBJ ne s'applique qu'aux objets de premier niveau. Si l'objet de premier niveau est un répertoire, le filtrage ne s'applique pas à son contenu, ni au contenu de ses sous-répertoires.

Une fois que la commande a commencé à traiter une branche d'un répertoire spécifique, les objets localisés et traités peuvent être affectés par les opérations qui mettent à jour l'organisation des objets dans l'arborescence de répertoire spécifiée. Cela inclut, sans caractère limitatif, les éléments suivants :

• Ajout, suppression ou nouvelle dénomination des liens d'objet
• Montage ou démontage des systèmes de fichiers
• Mise à jour du répertoire racine effectif pour le processus qui appelle la commande
• Mise à jour du contenu d'un lien symbolique

Pour traiter la branche du répertoire, le code du système peut augmenter le nombre maximal de descripteurs de fichier, dans la portée du processus, qui peuvent être ouverts lors du traitement. Cette opération est effectuée afin que la commande ne soit pas susceptible d'échouer en raison d'un manque de descripteurs. Cette valeur maximale de portée de processus n'est pas réinitialisée à la fin de la commande.

Lien symbolique (SYMLNK)

Si le dernier élément du nom de chemin est un lien symbolique, indique si les attributs du lien symbolique ou de l'objet désigné par ce lien doivent être affichés.

*NO

Les attributs de l'objet lien symbolique ne s'affichent pas. Les attributs de l'objet désigné par ce lien s'affichent.

*YES

Si l'objet est un lien symbolique, les attributs de ce lien s'affichent. Les attributs de l'objet désigné par ce lien ne s'affichent pas.

Exemples

Exemple 1 : Affichage des attributs d'objet

DSPATR  OBJ('X/PAIE')

Cette commande affiche les attributs de l'objet PAIE situé dans le répertoire X dans le répertoire en cours.

Exemple 2 : Affichage des attributs d'objet pour une sous-arborescence de répertoires

DSPATR   OBJ('/MYDIR')  SUBTREE(*ALL)
         OUTPUT(*PRINT)

Cette commande affiche les attributs de l'objet MYDIR situé dans le répertoire principal (/), de tous les objets contenus dans le répertoire MYDIR et de tous les objets de ses sous-répertoires. Les attributs sont imprimés dans une sortie spoule. Remarquez que OUTPUT(*PRINT) est obligatoire lorsque SUBTREE(*ALL) est spécifié.

Messages d'erreur

*ESCAPE Messages

CPF9899

Erreur lors du traitement de la commande.

CPFA085

Répertoire initial de l'utilisateur &1 introuvable.

CPFA08E

Plusieurs noms correspondent au masque.

CPFA09C

Aucun droit sur l'objet. L'objet est &1.

CPFA0A7

Le nom de chemin est trop long.

CPFA0A9

Objet introuvable. L'objet est &1.

CPFA0EE

Attributs affichés pour &1 objets. &2 objets non affichés.