PRTCMDUSG

Imprimer utilisation commandes

En bref

PRTCMDUSG se lit PRT (Imprimer) + CMDUSG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

PRTCMDUSG CMD(…)

Paramètres

CMD Commande obligatoire
PGM Programme

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

La commande PRTCMDUSG (Imprimer l'utilisation des commandes) permet de créer la liste des références croisées d'un groupe indiqué de commandes CL utilisées dans un groupe indiqué de programmes CL. Cette liste indique les commandes utilisées dans chacun des programmes. Elle vous permet d'identifier les programmes devant être recompilés en raison de modifications apportées aux objets de définition des commandes indiquées avec la commande PRTCMDUSG. Notez que l'exécution de celle-ci peut durer un certain temps et générer une sortie imprimée volumineuse.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CMD	Commande	Values (jusqu'à 50 répétitions): Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Commande	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
PGM	Programme	Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: Programme	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, USRLIBL, CURLIB, *ALLUSR

Commande (CMD)

Indique jusqu'à 50 commandes CL à rechercher dans les programmes indiqués en vue de produire la liste des références croisées. Le système recherche, dans les programmes précisés, chaque occurrence de commande indiquée dans ce paramètre.

Remarque :Vous ne pouvez pas utiliser PRTCMDUSG pour imprimer la syntaxe de la commande pour les programmes et modules écrits en langage CL ILE.

Ce paramètre est obligatoire.

Qualificatif 1 : Commande

nom: Indiquez le nom d'une 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.

nom: Indiquez le nom de bibliothèque contenant les commandes CL en question.

Programme (PGM)

Indique un ou plusieurs programmes CL dans lesquels s'effectue la recherche des commandes précisées. Seuls les programmes et bibliothèques sur lesquels vous disposez d'un droit (quel qu'il soit) sont inclus dans la liste. Ce paramètre peut également signifier que la recherche s'effectue dans tous (*ALL) les programmes contenus dans la ou les bibliothèques indiquées (par exemple, *USRLIBL/*ALL).

Qualificatif 1 : Programme

*ALL: La recherche s'effectue dans tous les programmes CL contenus dans la bibliothèque indiquée et sur lesquels l'utilisateur dispose de certains droits.
nom-générique: Indiquez le nom générique de plusieurs programmes dans lesquels seront recherchées les commandes précisées. Un nom générique est une chaîne de un ou plusieurs caractères suivis d'un astérisque (*).
nom: Indiquez le nom du programme dans lequel la recherche des commandes précisées doit s'effectuer.

Qualificatif 2 : Biblio

*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.

*CURLIB: Le programme CL est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

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

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

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

'xxxxx' représente le numéro de l'ASP principal.
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 dans laquelle doit s'effectuer la recherche.

Exemples

PRTCMDUSG   CMD(CPYF)  PGM(PAYROLL/*ALL)

Cette commande recherche dans tous les programmes CL de la bibliothèque PAYROLL les commandes CPYF (Copier un fichier) et imprime les noms des commandes et du programme.

Messages d'erreur

Messages *ESCAPE

CPF0593: Commande PRTCMDUSG interrompue par arrêt contrôlé.
CPF0595: Commande PRTCMDUSG arrêtée.
CPF0596: Commande PRTCMDUSG arrêtée. Impossible d'ouvrir le fichier d'impression.