PRTTRGPGM

La commande PRTTRGPGM permet d'imprimer la liste des programmes de déclenchement associés aux fichiers de la bibliothèque spécifiée.

Cette commande génère deux rapports par bibliothèque. Le premier (rapport intégral) contient tous les programmes de déclenchement associés à des fichiers de la bibliothèque spécifiée. Le second (rapport des modifications) contient les programmes de déclenchement qui apparaissent maintenant dans la bibliothèque indiquée et qui ne s'y trouvaient pas lors de la dernière exécution de la commande PRTTRGPGM pour la bibliothèque. Si cette commande n'a pas été exécutée précédemment, aucun rapport des modifications n'est généré. Si la commande a été exécutée pour la bibliothèque mais qu'aucun programme de déclenchement supplémentaire ne figure dans la bibliothèque spécifiée, le rapport des modifications sera imprimé, mais aucun objet ne sera inclus dans la liste. La modification de l'heure de déclenchement, de l'événement de déclenchement ou des conditions de mise à jour du déclenchement n'entraînent pas la création d'un rapport des modifications.

Le fichier QSECTRGOLD de la bibliothèque QUSRSYS contient des informations concernant la dernière exécution de la commande PRTTRGPGM pour une bibliothèque. Ce fichier contient un membre portant le même nom que la bibliothèque pour chaque bibliothèque spécifiée dans la commande. Le fichier système QAFDTRG de la bibliothèque QSYS, dont le nom de format est QWHFDTRG, est le fichier modèle correspondant au fichier QSECTRGOLD.

Restriction : Vous devez disposer du droit spécial *ALLOBJ (tous les objets) ou *AUDIT (audit) pour exécuter cette commande.

Paramètres

Biblio (LIB)

Ce paramètre est obligatoire.

Nom de la bibliothèque dans laquelle rechercher les fichiers comportant des programmes de déclenchement.

*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 de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

*ALL

La recherche porte sur toutes les bibliothèques de pools de mémoire secondaire (ASP) indiquées à l'invite Unité ASP (paramètre ASPDEV).

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur des pools de mémoire secondaire (ASP) définies à l'invite Unité ASP (paramètre ASPDEV).

Les bibliothèques utilisateur sont des bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception de celles qui suivent :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques ci-après dont le nom commence par la lettre Q soient fournies par IBM, elles contiennent des données utilisateur fréquemment modifiées. En conséquence, elles sont également considérées comme des bibliothèques utilisateur :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom

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

Rapport des modifs uniquement (CHGRPTONLY)

Indique si seul le rapport des modifications doit être imprimé.

*NO

Le rapport intégral et le rapport des modifications seront imprimés.

*YES

Seul le rapport des modifications sera imprimé.

Exemples

PRTTRGPGM   LIB(*ALL)

Cette commande permet d'effectuer des recherches sur l'ensemble des fichiers de la totalité des bibliothèques, et d'imprimer un rapport intégral et un rapport des modifications sur les programmes de déclenchement.

Messages d'erreur

Messages *ESCAPE

CPFB304

L'utilisateur ne possède pas les droits spéciaux requis.