DSPPGM

La commande DSPPGM (Afficher un programme) permet d'afficher des informations relatives à un programme. L'affichage obtenu fournit des informations sur le compilateur, le source du programme, certains attributs d'exécution du programme, la taille de ce dernier, ainsi que le nombre de paramètres devant être passés au programme lorsque celui-ci est appelé.

Les vues QSYS2.BOUND_MODULE_INFO, QSYS2.BOUND_SRVPGM_INFO, QSYS2.PROGRAM_EXPORT_IMPORT_INFO et QSYS2.PROGRAM_INFO renvoient des informations similaires.

Restrictions :

• Vous devez disposer du droit *READ (Lecture) sur le programme et du droit *EXECUTE (Exécution) sur la bibliothèque pour pouvoir utiliser cette commande.
• Vous devez disposer des droits d'utilisation *USE sur le programme si DETAIL(*MODULE) est spécifié.

Paramètres

Programme (PGM)

Indique le programme pour lequel les informations doivent être affichées.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

nom

Indiquez le nom du programme.

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

Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque contenant le programme.

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 (s'il s'agit d'un travail interactif) ou imprimée avec la sortie spoule du travail (s'il s'agit d'un travail par lots).

*PRINT

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

Détail (DETAIL)

Indique le type d'informations affichées pour le programme de service. Vous pouvez préciser une liste de valeurs. Cependant, *ALL ne doit être indiquée que comme valeur unique.

Remarque :DETAIL(*ALL) et DETAIL(*BASIC) sont les seules valeurs admises pour les programmes OPM (Original Program Model). Toute valeur autre que *ALL ou *BASIC est ignorée.

*ALL

Affichage de tous les types d'information DETAIL (*BASIC, *SIZE, *MODULE, *SRVPGM, *ACTGRPEXP, *ACTGRPIMP et *COPYRIGHT). Si l'utilisateur a choisi l'affichage des informations, il peut faire défiler les informations concernant chaque détail, mais doit faire ENTREE (ou F12) pour passer d'un détail à l'autre.

*BASIC

Affichage des informations générales sur le programme.

*SIZE

Affichage de la taille et des limites de taille du programme.

*MODULE

Affichage de la liste des objets module liés par ce programme. Pour chaque module, la bibliothèque affichée est celle qui contenait le module lors de la création du programme. Si le module a été remplacé par un autre module, provenant d'une autre bibliothèque, le nom de celle-ci reste comme étant celui de la bibliothèque qui contenait le module lorsque le programme de service a été créé. Pour déterminer le source à partir duquel le module a été créé, utilisez l'option 5 (Description) pour afficher les noms du fichier source, de la bibliothèque et du membre.

*SRVPGM

Affichage de la liste des programmes de service liés par ce programme.

*ACTGRPEXP

Affichage de la liste des éléments d'information exportés dans le groupe d'activation précisé dans la zone d'exportation de données dans les spécifications de liage.

*ACTGRPIMP

Affichage de la liste des importations résolues par des exportations faibles effectuées dans le répertoire du groupe d'activation.

*COPYRIGHT

Affichage de la liste des droits d'auteur sur ce programme de service.

Remarque :Les valeurs *SIZE, *MODULE, *SRVPGM et *COPYRIGHT de paramètre DETAIL ne sont admise que pour les programmes ILE (Integrated Language Environment). Si vous en indiquez une pour un programme OPM (Original Program Model), les informations *BASIC s'affichent.

Exemples

Exemple 1 : Affichage des informations d'un programme

DSPPGM   PGM(LIB01/PAYROLL)

Cette commande affiche les informations sur le programme nommé PAYROLL situé dans la bibliothèque LIB01. L'affichage intervient sur le clavier-écran à l'invite d'un travail interactif, ou est imprimé à l'invite d'un travail par lot.

Exemple 2 : Impression des informations d'un programme

DSPPGM   PGM(CUSINQ)  OUTPUT(*PRINT)

Cette commande permet d'afficher des informations sur un programme nommé CUSINQ. La liste des bibliothèques est utilisée pour rechercher le programme et les informations sont imprimées.

Messages d'erreur

Messages *ESCAPE

CPF2150

Erreur dans la fonction d'informations sur objet.

CPF2151

Erreur de l'opération sur &2 de &1 type *&3.

CPF8122

Dommage &8 sur bibliothèque &4.

CPF8123

L'information objet de la bibliothèque &4 est endommagée.

CPF8129

Programme &4 de &9 endommagé.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9806

Impossible d'exécuter fonction pour objet &2 de &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.

CPF9811

Programme &1 non trouvé dans la bibliothèque &2.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9821

Non autorisé au programme &1 de &2.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9871

Erreur lors du traitement.