CHGOBJD

Modifier description d'objet

En bref

La commande CHGOBJD (Modifier une description d'objet) permet de modifier le texte descriptif d'un objet et de remettre à zéro le compteur du nombre de jours d'utilisation des objets indiqués.

CHGOBJD se lit CHG (Modifier) + OBJD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGOBJD OBJ(…) OBJTYPE(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire
TEXT Texte 'descriptif'
USECOUNT Nombre de jours d'utilisation

Astuce : dans une session 5250, tapez CHGOBJD 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 CHGOBJD (Modifier une description d'objet) permet de modifier le texte descriptif d'un objet et de remettre à zéro le compteur du nombre de jours d'utilisation des objets indiqués.

Si l'objet en cours de modification est journalisé, un poste est consigné dans le journal qui enregistre les modifications. Utilisez la commande DSPOBJD (Afficher la description de l'objet) pour afficher les informations de journalisation concernant l'objet.

Remarque :Pour en savoir plus sur la journalisation, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Restrictions :

Pour les objets fichier, vous devez disposer de droits d'opération (*OBJOPR) et de gestion (*OBJMGT) sur l'objet à modifier.
Pour les objets non fichier, vous devez disposer de droits de gestion (*OBJMGT) sur l'objet à modifier.
Vous devez disposer du droit d'exécution (*EXECUTE) sur la bibliothèque contenant l'objet.

Remarque :Si vous n'indiquez pas au moins l'un des paramètres Texte 'descriptif' (TEXT) ou Nombre de jours d'utilisation (USECOUNT), le message d'achèvement CPC2105 est envoyé pour indiquer que l'objet n'a pas été modifié.

Paramètres

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

Objet (OBJ)

Indique l'objet dont la description doit être modifiée. Si le qualificatif 2 n'est pas précisé, l'objet indiqué est recherché dans *LIBL. Vous pouvez définir un nom de bibliothèque pour le qualificatif 2 afin de vous assurer que l'objet correct est modifié.

Remarque :Pour modifier la description des objets de type *DEVD, vous devez d'abord utiliser la commande ALCOBJ (Allouer un objet) pour mettre à l'état de verrouillage *EXCLRD la description d'unité. Si cette commande n'est pas exécutée, le message CPF2114 est envoyé pour indiquer que la description d'objet est verrouillée. Il n'est pas nécessaire d'exécuter la commande ALCOBJ si vous avez déjà ouvert une session sur l'unité écran pour laquelle la description doit être modifiée.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

*ALL: Tous les objets contenus dans les bibliothèques indiquées et dont le type correspond à l'une des valeurs précisées pour le paramètre Type d'objet (OBJTYPE) doivent être modifiés.
nom-générique: Indiquez le nom générique des objets à modifier. Un nom générique est indiqué sous la forme d'une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*). Un nom générique définit tous les objets dont le nom comporte le même préfixe que le nom de l'objet générique sur lequel vous disposez des droits d'accès appropriés.
nom: Indiquez le nom des objets à modifier.

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.

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

*ALL: La recherche porte sur toutes les bibliothèques de l'espace de nom de bibliothèque de l'unité d'exécution, QSYS compris.

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

Type d'objet (OBJTYPE)

Indique le type des objets à modifier.

Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

type-objet: Indiquez le type des objets à modifier.
*ALL: Tous les types d'objets dont le nom et la bibliothèque sont indiqués pour le paramètre Objet (OBJ) et sur lesquels vous disposez de droits doivent être modifiés.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte ne change pas.
*BLANK: Le texte est mis à blanc.
'descriptif': Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Nombre de jours d'utilisation (USECOUNT)

Indique si le compteur du nombre de jours d'utilisation des objets doit être remis à zéro. Pour plus de détails sur les informations d'utilisation, reportez-vous à "Objets et bibliothèques" dans le manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*NORESET

Le compteur n'est pas remis à zéro.

*RESET

Le compteur est remis à zéro (0). La date doit être réinitialisée à la date système en cours.

Les informations d'utilisation des objets ne sont pas mises à jour pour tous les types d'objet. Si les informations d'utilisation ne sont pas mises à jour pour le type d'objet indiqué et si *RESET est indiqué, le compteur (jours) n'est pas actualisé et un message d'erreur n'est pas envoyé. Utilisez la commande DSPOBJD (Afficher la description de l'objet) pour l'objet en cours de modification afin de déterminer si les données d'utilisation sont collectées pour l'objet.

Remarque :Pour les fichiers base de données, le compteur (jours et date) est mis à jour pour tous les membres.

Exemples

CHGOBJD   OBJ(LIB1/DA1)  OBJTYPE(*DTAARA)
          TEXT('NEW TEXT FOR DA1')

Cette commande permet de modifier le texte descriptif de la zone de données DA1 de la bibliothèque LIB1 en la valeur indiquée par le paramètre TEXT.

Messages d'erreur

Messages *ESCAPE

CPF2105: Objet &1 de &2 type *&3 non trouvé.
CPF2110: Bibliothèque &1 non trouvée.
CPF2113: Impossible d'allouer la bibliothèque &1.
CPF2114: Impossible d'allouer objet &1 de &2 type *&3.
CPF2123: Aucun objet du nom ou du type indiqué dans la bibliothèque &2.
CPF2150: Erreur dans la fonction d'informations sur objet.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF2176: Bibliothèque &1 endommagée.
CPF2182: Non autorisé à utiliser la bibliothèque &1.
CPF2189: Utilisation de l'objet &1 de &2, type *&3 non autorisée.
CPF2195: La valeur texte doit être *SAME.
CPF2196: La bibliothèque ne peut être une valeur spéciale.
CPF2198: Zone nombre de jours d'utilisation non remise à zéro pour certains objets.
CPF2451: File d'attente de messages &1 allouée à un autre travail.
CPF36F7: La file d'attente de messages QSYSOPR est allouée à un autre travail. Message queue QSYSOPR is allocated to another job.
CPF7003: Poste non journalisé dans &1. Code raison &3.
CPF7304: Fichier &1 de &2 non modifié.