Aller au contenu

WRKOBJ

Gérer les objets

En bref

La commande WRKOBJ (Gérer les objets) permet d'afficher une liste d'objets d'une ou plusieurs bibliothèques.

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

Syntaxe minimale

WRKOBJ OBJ(…)

Paramètres

Astuce : dans une session 5250, tapez WRKOBJ 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 WRKOBJ (Gérer les objets) permet d'afficher une liste d'objets d'une ou plusieurs bibliothèques.

Le nom, le type, l'attribut, le nom de bibliothèque et une brève description sont affichés pour chaque objet de la liste. Les attributs de données et les données contenues dans l'objet n'apparaissent pas. Cette liste permet de choisir plusieurs options relatives à l'objet.

Restrictions :

  • La recherche est limitée aux bibliothèques pour lesquelles vous disposez du droit d'utilisation (*USE).
  • Seuls les objets sur lesquels vous disposez d'un droit s'affichent sur l'écran.
  • Si vous disposez de droits sur la fonction d'administrateur de la sécurité de la base de données d'IBM i (QIBM_DB_SECADM), toutes les bibliothèques seront recherchées et tous les objets spécifiés s'afficheront à l'écran.
  • Pour effectuer des opérations sur les objets, vous devez disposer du droit *USE sur la commande utilisée par l'opération et du droit approprié sur les objets sur lesquels l'opération est à effectuer.

Paramètres

Mot-clé Description Valeurs possibles Remarques
OBJ Objet Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Objet Nom générique, nom, *ALL
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB, *USRLIBL, *ALLUSR, *ALL
OBJTYPE Type d'objet *ALL, *ALRTBL, *AUTL, *BNDDIR, *CFGL, *CHTFMT, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DEVD, *DOC, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FILE, *FLR, *FNTTBL, *FNTRSC, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MEDDFN, *MENU, *MODD, *MODULE, *MSGF, *MSGQ, *MGTCOL, *M36, *M36CFG, *NODL, *NODGRP, *NTBD, *NWID, *NWSCFG, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *S36, *SBSD, *SCHIDX, *SPADCT, *SQLPKG, *SQLUDT, *SQLXSR, *SRVPGM, *SVRSTG, *SSND, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST Facultatif, positionnel 2

Objet (OBJ)

Indique les objets à afficher à l'écran Gestion des objets.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

*ALL
Tous les objets des types spécifiés au paramètre Type d'objet (OBJTYPE).
nom-générique
Indique le nom générique de l'objet à 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 objets ayant le même préfixe que le nom générique sont affichés.
nom
Indique le nom de l'objet à 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

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

Type d'objet (OBJTYPE)

Indique le type des objets à afficher.

*ALL
Tous les objets dont le nom correspond à la valeur indiquée au paramètre Objet (OBJ) sont affichés.
type-objet
Entrez le type des objets à afficher, tel que commande (*CMD), fichier (*FILE), ou programme (*PGM). Pour afficher la liste exhaustive des types d'objet en utilisant la fonction d'invite sur cette commande, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite).

Exemples 

WRKOBJ   OBJ(X/PAY*)  OBJTYPE(*ALL)

Cette commande affiche l'écran Gestion des objets qui contient tous les objets sur lesquels vous disposez de droits dont les noms commencent par les lettres 'PAY' situés dans la bibliothèque X.

Messages d'erreur

Messages *ESCAPE

CPF9809
Accès à la bibliothèque &1 impossible.
CPF9810
Bibliothèque &1 non trouvée.
CPF9820
Non autorisé à utiliser la bibliothèque &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.