WRKMOD

Gérer les modules

En bref

La commande WRKMOD (Gérer les modules) vous permet d'afficher et de gérer une liste de modules contenus dans une ou plusieurs bibliothèques.

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

Syntaxe minimale

WRKMOD MODULE(…)

Paramètres

MODULE Module obligatoire
MODATR Attribut de module

Astuce : dans une session 5250, tapez WRKMOD 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 WRKMOD (Gérer les modules) vous permet d'afficher et de gérer une liste de modules contenus dans une ou plusieurs bibliothèques.

Restrictions :

La recherche porte uniquement sur les bibliothèques pour lesquelles vous disposez du droit d'utilisation (*USE).
Seuls les modules sur lesquels vous détenez le droit de lecture (*READ) sont affichés.
Pour effectuer une opération sur un module, vous devez disposer du droit d'utilisation (*USE) sur la commande utilisée et du droit approprié pour ce module.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MODULE	Module	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Module	Nom générique, nom, *ALL
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, USRLIBL, ALLUSR, *ALL
MODATR	Attribut de module	*ALL, CBLLE, CLE, CLLE, CPPLE, RPGLE	Facultatif, positionnel 2

Module (MODULE)

Indique comment rechercher les modules qui doivent être placés dans la liste. Tous les modules dont le nom correspond à la valeur de paramètre indiquée et pour lesquels l'utilisateur détient des droits sont affichés.

Ce paramètre est obligatoire.

Qualificatif 1 : Module

*ALL: Tous les modules contenus dans les bibliothèques identifiées dans le qualificatif sont affichés (excepté ceux appartenant à des bibliothèques pour lesquelles l'utilisateur ne détient aucun droit).
nom-générique: Indiquez le nom générique du module. Un nom générique est composé d'un ou plusieurs caractères suivis d'un astérisque (*) : ABC*, par exemple. Si un nom générique est indiqué, tous les modules dont le nom commence par ce nom générique et sur lesquels l'utilisateur détient des droits sont affichés. Si le nom (ou le préfixe) générique n'inclut pas d'astérisque, le système suppose qu'il s'agit du nom complet du module.
nom: Indiquez le nom du module affiché.

Qualificatif 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 du travail. Si aucune bibliothèque n'est indiquée, QGPL est utilisée.
*USRLIBL: La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.
*ALL: La recherche porte sur toutes les bibliothèques de la partie système de la liste des bibliothèques de travail, y compris sur QSYS.

*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 sur laquelle doit porter la recherche.

Attribut de module (MODATR)

Indique qu'une liste de modules présentant l'attribut sélectionné est affichée.

*ALL: Les modules sont affichés quel que soit l'attribut qui leur est associé.
CBLLE: Les modules dont l'attribut est CBL (modules ILE COBOL) sont affichés.
CLE: Les modules dont l'attribut est C (modules ILE C) sont affichés.
CLLE: Les modules dont l'attribut est CL (modules ILE CL) sont affichés.
CPPLE: Les modules dont l'attribut est CPPLE (modules ILE C++) sont affichés.
RPGLE: Les modules dont l'attribut est RPG (modules ILE RPG) sont affichés.

Exemples

WRKMOD   MODULE(MYLIB/*ALL)

Cette commande répertorie les modules stockés dans la bibliothèque MYLIB pour lesquels l'utilisateur dispose de droits.

Messages d'erreur

Messages *ESCAPE

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