DSPMOD

Afficher un module

En bref

La commande DSPMOD (Afficher un module) permet d'afficher des informations sur un module, c'est-à-dire les informations concernant le compilateur, le source à partir duquel le module a été créé, les attributs de traitement du module et la taille du module.

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

Syntaxe minimale

DSPMOD MODULE(…)

Paramètres

MODULE Module obligatoire
DETAIL Détail
OUTPUT Sortie
OUTFILE Fichier recevant la sortie
OUTMBR Options pour membre de sortie

Astuce : dans une session 5250, tapez DSPMOD 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

Restrictions :

Vous devez disposer du droit d'utilisation (*USE) sur le module affiché et du droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle le module est stocké.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MODULE	Module	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Module	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
DETAIL	Détail	Valeurs uniques: ALL Autres valeurs (jusqu'à 7 répétitions): BASIC, SIZE, EXPORT, IMPORT, PROCLIST, REFSYSOBJ, COPYRIGHT	Facultatif, positionnel 2
OUTPUT	Sortie	, PRINT, *OUTFILE	Facultatif, positionnel 3
OUTFILE	Fichier recevant la sortie	Nom d'objet qualifié	Facultatif
	Qualificatif 1: Fichier recevant la sortie	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
OUTMBR	Options pour membre de sortie	Liste d'éléments	Facultatif
	Élément 1: Membre recevant la sortie	Nom, *FIRST
	Élément 2: Remplacement ou ajout enregs	REPLACE, ADD

Module (MODULE)

Indique le module pour lequel des informations doivent être affichées.

Ce paramètre est obligatoire.

Qualificatif 1 : Module

nom: Indiquez le nom du module pour lequel les informations sont affichées.

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 recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Détail (DETAIL)

Indique quel ensemble d'informations est affiché pour le module.

Valeurs particulières

*ALL: Toutes les informations applicables au module indiqué sont affichées ou imprimées.
Remarque :DETAIL(*ALL) est admis uniquement lorsque des informations sont affichées ou imprimées. Il n'est pas admis si *OUTFILE est indiqué à l'invite Sortie (paramètre OUTPUT).

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

*BASIC: Les informations de base sur le module, celles concernant la compatibilité du module et les informations SQL sont affichées.
*SIZE: La taille et les limites de taille pour ce module sont affichées.
*EXPORT: Les symboles définis dans ce module et exportés vers d'autres modules sont affichés.
*IMPORT: Les symboles définis à l'extérieur de ce module sont affichés.
*PROCLIST: Une liste des noms de procédure avec leur type et leur priorité est affichée.
*REFSYSOBJ: La liste affichée contient les objets système auquel ce module fait référence lorsqu'il est lié dans un programme ou un programme de service lié.
*COPYRIGHT: Les informations de copyright pour ce module sont affichées.

Sortie (OUTPUT)

Indique si la sortie de cette commande est affichée, imprimée ou dirigée vers un fichier base de données.

*

La sortie demandée par un travail interactif s'affiche à l'écran. La sortie demandée par un travail par lots est imprimée avec la sortie spoule du travail.

*PRINT

La sortie est imprimée avec la sortie spoule du travail.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE).

Remarque :Si un nom de procédure de plus de 256 caractères est trouvé et que la valeur *OUTFILE est indiquée, les 253 derniers caractères du nom de procédure sont placés dans la file d'attente en sortie et sont précédés de trois signes inférieur (<<<). Ces signes inférieur (<<<) indiquent qu'il s'agit uniquement d'une partie d'un nom. Le message de diagnostic CPD5D12, indiquant que toutes les informations disponibles ne sont pas renvoyées, est placé dans l'historique du travail. Ce message est également envoyé comme message d'état au programme ayant appelé le programme de traitement de commande (CPP) qui peut être contrôlé. Pour visualiser le nom complet de la procédure, utilisez les API QBNRMODI et QBNLMODI.

Remarque :DETAIL(*ALL) n'est pas admis lorsque OUTPUT(*OUTFILE) est indiqué.

Fichier recevant la sortie (OUTFILE)

Indique le fichier base de données vers lequel la sortie de cette commande est dirigée. Si le fichier de sortie n'existe pas, cette commande le crée dans la bibliothèque indiquée. Si le fichier est créé, le texte "Sortie de DSPMOD" apparaît. Les droits publics du fichier sont les mêmes que les droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Le fichier de sortie a le même format d'enregistrement que le fichier base de données fourni par IBM.

Les fichiers base de données fournis par IBM et leur format d'enregistrement sont détaillés ci-après :

Détail :   Fichier :  Format enreg :
*BASIC     QABNDMBA   QBNDMBAS
*SIZE      QABNDMSI   QBNDMSIZ
*EXPORT    QABNDMEX   QBNDMEXP
*IMPORT    QABNDMIM   QBNDMIMP
*PROCLIST  QABNDMPR   QBNDMPRO
*REFSYSOBJ QABNDMRE   QBNDMREF
*COPYRIGHT QABNDMCO   QBNDMCOP

Qualificatif 1 : Fichier recevant la sortie

nom: Indiquez le nom du fichier base de données qui reçoit la sortie de cette commande.

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 recherche porte sur la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.
nom: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données vers lequel la sortie est dirigée. Si un membre existe déjà, le système utilise le second élément de ce paramètre pour déterminer si le membre est effacé avant que les nouveaux enregistrements ne soient ajoutés. Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système crée un membre et lui affecte le nom du fichier de sortie indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si un membre de fichier de sortie indiqué n'existe pas, le système le crée.

Elément 1 : Membre recevant la sortie

*FIRST: Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et qu'un membre n'existe pas, le système crée un membre portant le nom du fichier indiqué au paramètre OUTFILE.
nom: Indiquez le nom du membre du fichier qui reçoit la sortie. Si le membre n'existe pas, 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

DSPMOD   MODULE(MYMOD)

Cette commande affiche l'objet module MYMOD figurant dans la liste des bibliothèques.

Messages d'erreur

Messages *ESCAPE

CPF5CE7: Erreur lors de l'extraction des données *MODULE
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9807: Une ou plusieurs bibliothèques de la liste ont été supprimées.
CPF9808: Allocation impossible pour une ou plusieurs bibliothèques de la liste.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9830: Allocation de la bibliothèque &1 impossible.
CPF9871: Erreur lors du traitement.

Messages *STATUS

CPD5D12: Valeurs incomplètes dans un ou plusieurs enregistrements.