WRKPGM

Gérer les programmes

En bref

La commande WRKPGM (Gérer les programmes) permet d'afficher une liste de programmes provenant d'une ou plusieurs bibliothèques.

WRKPGM se lit WRK (Gérer) + PGM. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKPGM PGM(…)

Paramètres

PGM Programme obligatoire
PGMATR Attribut du programme

Astuce : dans une session 5250, tapez WRKPGM 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande WRKPGM (Gérer les programmes) permet d'afficher une liste de programmes provenant d'une ou plusieurs bibliothèques.

Restrictions :

La recherche est limitée aux bibliothèques pour lesquelles vous disposez du droit d'utilisation (*USE).
Seuls les programmes sur lesquels vous disposez des droits (*OBJOPR) sur l'objet sont affichés.
Pour effectuer des opérations sur les programmes, vous devez disposer du droit *USE sur la commande utilisée par l'opération et du droit approprié sur les programmes sur lesquels l'opération est à effectuer.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	Programme	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Programme	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALLUSR, *ALL
PGMATR	Attribut du programme	*ALL, ASM38, BAS, BAS38, CBL, CBLLE, CBL36, CBL38, CLE, CLLE, CLP, CLP38, CPPLE, CSP, DFU, DFUEXC, DFUNOTEXC, FTN, PAS, PAS38, PLI, PLI38, RMC, RPG, RPGLE, RPG36, RPG38	Facultatif, positionnel 2

Programme (PGM)

Indique les programmes à afficher.

Ce paramètre est obligatoire.

Qualificatif 1 : Programme

*ALL: Tous les programmes sont affichés.
nom-générique: Indique le nom générique des programmes à afficher. Un nom générique est une chaîne de caractères contenant un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, tous les programmes ayant le même préfixe que le nom générique sont affichés.
nom: Indique le nom du programme à afficher.

Qualificateur 2: Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution. Tous les objets contenus dans ces bibliothèques sont affichés avec leur nom.

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

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

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

*ALL: La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Attribut du programme (PGMATR)

Indique si seuls les programmes associés à un attribut spécifique sont affichés.

*ALL: Seuls les programmes indiqués au paramètre Programme (PGM) sont affichés.
ASM38: Les programmes contenant l'attribut ASM38 (programmes assembleur de l'IBM 38) s'affichent. Ces programmes ne peuvent pas être exécutés sur un IBM i.
BAS: Les programmes contenant l'attribut BAS (programmes BASIC) s'affichent.
BAS38: Les programmes contenant l'attribut BAS38 (programmes BASIC utilisés en environnement 38) s'affichent.
CBL: Les programmes contenant l'attribut CBL (programmes OPM [modèle de programmation de base] COBOL) s'affichent.
CBLLE: Les programmes contenant l'attribut CBLLE (ILE [environnement langage intégré] COBOL) s'affichent.
CBL36: Les programmes contenant l'attribut CBL36 (programmes COBOL utilisés en environnement 36) s'affichent.
CBL38: Les programmes contenant l'attribut CBL38 (programmes COBOL utilisés en environnement 38) s'affichent.
CLE: Les programmes contenant l'attribut CLE (programmes ILE C) s'affichent.
CLLE: Les programmes contenant l'attribut CLLE (programmes CL [langage de contrôle] ILE) s'affichent.
CLP: Les programmes contenant l'attribut CLP (programmes CL OPM) s'affichent.
CLP38: Les programmes contenant l'attribut CLP38 (programmes CL utilisés en environnement 38) s'affichent.
CPPLE: Les programmes contenant l'attribut CPPLE (programmes ILE C++) s'affichent.
CSP: Les programmes contenant l'attribut CSP (programmes d'application CSP/AE) s'affichent.
DFU: Les programmes contenant l'attribut DFU (programmes UCMF) s'affichent.
DFUEXC: Les programmes contenant l'attribut DFUEXC (programmes UCMF exécutables en environnement 38) s'affichent.
DFUNOTEXC: Les programmes contenant l'attribut DFUNOTEXC (programmes UCMF non exécutables en environnement 38).
FTN: Les programmes contenant l'attribut FTN (programmes FORTRAN) s'affichent.
PAS: Les programmes contenant l'attribut PAS (programmes PASCAL) s'affichent.
PAS38: Les programmes contenant l'attribut PAS38 (programmes PASCAL utilisés en environnement 38) s'affichent.
PLI: Les programmes contenant l'attribut PLI (programmes PL/I) s'affichent.
PLI38: Les programmes contenant l'attribut PLI38 (programmes PL/I exécutables en environnement 38) s'affichent.
RMC: Les programmes contenant l'attribut RMC (programmes RM/COBOL-85) s'affichent.
RPG: Les programmes contenant l'attribut RPG (programmes OPM RPG) s'affichent.
RPGLE: Les programmes contenant l'attribut RPGLE (programmes ILE RPG) s'affichent.
RPG36: Les programmes contenant l'attribut RPG36 (programmes RPG exécutables en environnement 36) s'affichent.
RPG38: Les programmes contenant l'attribut RPG38 (programmes RPG exécutables en environnement 38) s'affichent.

Exemples

Exemple 1 : Gestion des programmes en langage de contrôle

WRKPGM   PGM(MYLIB/*ALL)  PGMATR(CLP)

Cette commande affiche l'écran Gestion des programmes qui contient la liste des programmes associés à l'attribut CLP (programme en langage de contrôle) sur lesquels l'utilisateur dispose de droits et qui sont stockés dans la bibliothèque MYLIB.

Exemple 2 : Gestion des programmes par nom génériques

WRKPGM   PGM(AB*)

Cette commande affiche l'écran Gestion des programmes qui contient la liste des programmes de la liste de bibliothèques dont le nom commence par les lettres 'AB'.

Messages d'erreur

Messages *ESCAPE

CPF9809: Accès à la bibliothèque &1 impossible.
CPF9820: Non autorisé à utiliser la bibliothèque &1.