CHGCLNUP
Modifier les options de ménage
En bref
La commande CHGCLNUP (Modifier les options de ménage) permet de définir les options gérant les objets à supprimer automatiquement du système, à savoir :
CHGCLNUP se lit CHG
(Modifier) + CLNUP.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CHGCLNUP
Paramètres
-
ALWCLNUPPermettre le ménage -
STRTIMEHeure début ménage quotidien -
USRMSGDurée de conservation en jours -
SYSMSGMsgs syst et postes travail -
CRITSYSMSGMessages systèmes critiques -
SYSPRTHist travaux et sorties syst -
SYSLOGJournaux et hist du système -
JOBQFile d'attente de travaux -
JRNRCVSIZTaille de récepteur de journal -
CALITMActivités d'agenda OV/400 -
RUNPTYPriorité d'exécution
Astuce : dans une session 5250, tapez CHGCLNUP 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 CHGCLNUP (Modifier les options de ménage) permet de définir les options gérant les objets à supprimer automatiquement du système, à savoir :
- si l'opération de ménage est autorisée
- à quel moment l'opération de ménage est exécutée chaque jour
- quels objets sont concernés par cette opération
Reportez-vous aux descriptions de paramètres ci-dessous qui donnent la liste des objets visés par les opérations de ménage.
- Messages utilisateur (USRMSG)
- Msgs syst et postes travail (SYSMSG)
- Messages systèmes critiques (CRITSYSMSG)
- Hist travaux et sorties syst (SYSPRT)
- Journaux et hist du système (SYSLOG)
Si le ménage est actif lors de l'utilisation de cette commande, la prise en compte ou non des nouvelles valeurs sera fonction de l'état d'avancement du ménage. S'il n'est pas actif, ces valeurs seront prises en compte lors du prochain démarrage du ménage (commande STRCLNUP ou tel que décrit dans le manuel Ensemble de rubriques Opérations système de base de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
Restriction : Vous devez disposer des droits spéciaux sur tous les objets (*ALLOBJ), d'administrateur de la sécurité (*SECADM) et d'exploitation des travaux (*JOBCTL) pour utiliser cette commande.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| ALWCLNUP | Permettre le ménage | *SAME, *YES, *NO | Facultatif |
| STRTIME | Heure début ménage quotidien | Heure, *SAME, *SCDPWROFF, *NONE | Facultatif |
| USRMSG | Durée de conservation en jours | Liste d'éléments | Facultatif |
| Élément 1: Messages utilisateur | 1-366, *SAME, *KEEP | ||
| SYSMSG | Msgs syst et postes travail | 1-366, *SAME, *KEEP | Facultatif |
| CRITSYSMSG | Messages systèmes critiques | 1-366, *SAME, *KEEP | Facultatif |
| SYSPRT | Hist travaux et sorties syst | 1-366, *SAME, *KEEP | Facultatif |
| SYSLOG | Journaux et hist du système | 1-366, *SAME, *KEEP | Facultatif |
| JOBQ | File d'attente de travaux | Valeurs uniques: *SAME Autres valeurs: Nom d'objet qualifié |
Facultatif |
| Qualificatif 1: File d'attente de travaux | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| JRNRCVSIZ | Taille de récepteur de journal | 1-1000000000, *SAME, *KEEP | Facultatif |
| CALITM | Activités d'agenda OV/400 | 1-366, *SAME, *KEEP | Facultatif |
| RUNPTY | Priorité d'exécution | 1-99, *SAME | Facultatif |
Permettre le ménage (ALWCLNUP)
Indique si l'opération de ménage peut être exécutée sur le système. Si ALWCLNUP(*YES) est indiqué, le ménage pourra être démarré à l'aide de la commande STRCLNUP (Démarrer le ménage) ou tel que décrit dans le manuel Ensemble de rubriques Opérations système de base de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/. En outre, si ALWCLNUP(*YES) est spécifié, vous pourrez modifier cette opération en récupérant le programme QEZUSRCLNP à l'aide de la commande RTVCLSRC (Extraire une source CL), en modifiant la source, puis en compilant le programme CL à l'aide de la commande CRTCLPGM (Créer un programme CL).
- *SAME
- La valeur en cours reste inchangée. La valeur initiale est *NO, mais elle est définie sur *YES pendant une installation microcode.
- *YES
- Le ménage peut être exécuté sur le système.
- *NO
- Le ménage ne peut pas être exécuté sur le système.
Heure début ménage quotidien (STRTIME)
Indique l'heure de démarrage du ménage quotidien.
- *SAME
- L'heure reste inchangée. La valeur initiale est 220000.
- *SCDPWROFF
- Le ménage démarre à l'heure de la mise hors tension programmée. Le système est mis hors tension dès que le ménage est terminé, que cette opération ait abouti ou non.
- *NONE
- L'heure de début de ménage n'est pas programmée. Les travaux par lots du ménage ne sont pas soumis.
- heure
- Indiquez l'heure à laquelle le ménage quotidien démarre au format hhmmss, où hh = heures, mm = minutes et ss = secondes.
Vous pouvez indiquer l'heure avec ou sans séparateur :
- Si vous n'utilisez pas de séparateur d'heure, indiquez une chaîne au format hhmm ou hhmmss (4 ou 6 chiffres), où hh = heures, mm = minutes, ss = secondes.
- Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres en insérant le séparateur défini pour votre travail entre les heures, les minutes et les secondes. Lorsque vous entrez cette commande à partir de la ligne de commande, la chaîne doit être indiquée entre apostrophes. Si vous utilisez un autre séparateur que celui défini pour votre travail, la commande n'aboutira pas.
Messages utilisateur (USRMSG)
Indique si les messages des files d'attente de messages du profil utilisateur sont visés par l'opération de ménage. Cette fonction supprime des files d'attente de messages utilisateur les messages dont la durée de conservation est écoulée.
- *SAME
- Le nombre de jours reste inchangé. La valeur initiale est 7 jours.
- *KEEP
- Les messages ne sont pas supprimés.
- 1-366
- Indiquez la durée de conservation (en jours) des messages avant leur suppression.
Msgs syst et postes travail (SYSMSG)
Indique si les messages de la file d'attente QSYSOPR et des files d'attente des postes de travail sont visés par l'opération de ménage. Cette dernière supprime de ces files d'attente les messages dont la durée de conservation est écoulée.
- *SAME
- Le nombre de jours reste inchangé. La valeur initiale est 4 jours.
- *KEEP
- Les messages ne sont pas supprimés.
- 1-366
- Indiquez la durée de conservation (en jours) des messages avant leur suppression.
Messages systèmes critiques (CRITSYSMSG)
Indique si la fonction de ménage supprime de la file d'attente de messages QSYSMSG (si celle-ci existe) les messages dont la durée de conservation précisée est dépassée.
- *SAME
- Le nombre de jours reste inchangé. La valeur initiale est de ne supprimer aucun message (*KEEP).
- *KEEP
- Les messages ne sont pas supprimés.
- 1-366
- Indiquez la durée de conservation (en jours) des messages avant leur suppression.
Hist travaux et sorties syst (SYSPRT)
Indique si les historiques des travaux et autres sorties système sont visés par l'opération de ménage.
Pour éviter que ces sorties ne soient mélangées avec celles de l'utilisateur, la file d'attente en sortie du fichier imprimante contenant les historiques des travaux (QPJOBLOG) devient QUSRSYS/QEZJOBLOG. La file d'attente en sortie des fichiers imprimante QPSRVDMP, QPPGMDMP et QPBASDMP devient QUSRSYS/QEZDEBUG. Tous les postes de QEZJOBLOG et QEZDEBUG dont la durée de conservation (en jours) est écoulée sont supprimés. Les historiques des travaux en attente correspondant à des travaux qui se sont terminés il y a plus longtemps que le nombre de jours indiqué sont également supprimés.
Si le ménage est arrêté, les files d'attente en sortie QEZJOBLOG et QEZDEBUG continueront d'être utilisées pour recevoir les historiques des travaux, les clichés de maintenance et les clichés de programmes.
- *SAME
- Le nombre de jours reste inchangé. La valeur initiale est 7 jours.
- *KEEP
- Les historiques des travaux et les autres sorties système ne sont pas supprimés.
- 1-366
- Indiquez la durée de conservation (en jours) des historiques des travaux et des autres sorties système avant leur suppression. Cela affecte également les historiques des travaux en attente et les historiques des travaux spoule.
Journaux et hist du système (SYSLOG)
Indique que les journaux, les fichiers historique, les fichiers d'historique des incidents et la base de données d'alertes du système sont visés par l'opération de ménage (supprimés).
Récepteurs de journal concernés :
Les récepteurs de journal utilisés pour l'un des journaux système suivants et dont la durée de conservation est écoulée sont supprimés.
- ADJRNL0
- Journal des fichiers contenant les pilotes des programmes d'application
- QACGJRN
- Journal des données de comptabilité des travaux
- QAOSDIAJRN
- Journal des fichiers DIA
- QASOSCFG
- Journal du fichier de configuration SOCKS
- QCQJMJRN
- Journal de Managed System Services
- QDSNX
- Journal des historiques DSNX
- QIPFILTER
- Journal des règles de filtrage des adresses IP
- QIPNAT
- Journal de conversion d'adresses réseau (NAT)
- QLYJRN
- Journal des transactions du gestionnaire de développement d'applications
- QLYPRJLOG
- Journal des historiques du projet
- QLZALOG
- Journal de la gestion des licences.
- QMAJRN
- Journal des demandes de travaux
- QO1JRN
- Journal des fichiers OFC de l'activeur d'applications
- QPFRADJ
- Journal des données d'ajustement des performances
- QSNADS
- Journal des fichiers SNADS
- QSNMP
- Journal de SNMP
- QSXJRN
- Journal des bases de données d'incidents
- QSZRAIR
- Journal du référentiel d'informations des applications enregistrées.
- QVPN0001
- Journal des connexions VPN
- QX400
- Services de messagerie OSI
- QZCAJRN
- Journal de l'agent SNMP
- QZMF
- Journal du travail QMSF
Remarque :Le récepteur du journal QACGJRN est supprimé uniquement si l'Assistant crée ce dernier.
Fichiers historique concernés :
Les fichiers historique remplissant les deux conditions suivantes sont supprimés :
- La durée de conservation définie est écoulée.
- Le nom du fichier est du type QSYS/QHST*.
Fichiers et postes d'historique des incidents concernés :
Les postes de l'historique des incidents dont la durée de conservation est écoulée sont supprimés. La commande DLTPRB (Supprimer les enregistrements d'incident) est exécutée pour la suppression. Lors de l'exécution de cette commande, la durée de conservation (nombre de jours) indiquée dans ce paramètre est utilisée pour le paramètre Jours (DAYS) de la commande DLTPRB.
Remarque :Si le nombre de jours indiqué dans ce paramètre est inférieur à celui indiqué pour la valeur système QPRBHLDITV (Durée de rétention de l'historique des incidents), la valeur de QPRBHLDITV est utilisée pour le ménage de l'historique des incidents.
Lors des opérations de ménage, les fichiers d'historique des incidents suivants qui figurent dans la bibliothèque QUSRSYS sont réorganisés :
Remarque :Les fichiers suivants se trouvent dans la bibliothèque QUSRSYS.
QASXCALL QASXFRU QASXNOTE QASXPROB QASXPTF QASXYMP QASXEVT
Postes de base de données d'alertes concernés :
Les postes de base de données d'alertes dont la durée de conservation est écoulée sont supprimés. La commande DLTALR (Supprimer une alerte) est exécutée pour la suppression. Lors de l'exécution de cette commande, la durée de conservation (nombre de jours) indiquée dans ce paramètre est utilisée pour le paramètre Jours (DAYS) de la commande DLTALR.
Lors des opérations de ménage, le fichier QUSRSYS/QAALERT est réorganisé.
Modifications provisoires du logiciel (PTF) concernées :
- Les fichiers sauvegarde et les lettres d'accompagnement des PTF concernant les versions précédentes sont supprimés si la bibliothèque QSMU n'existe pas sur le système. Si la bibliothèque QSMU existe sur le système, aucun fichier sauvegarde et aucune lettre d'accompagnement des PTF ne sont supprimés.
- Les objets temporaires avec les noms suivants sont supprimés :
- QPZA000000 à QPZA999999
- QPZR000000 à QPZR999999
- Programmes d'exit QPZ1* et QPZ2*
- Les fichiers physiques QAPZ* dans la bibliothèque QUSRSYS sont réorganisés pour retirer les enregistrements supprimés.
- Pour chaque groupe de PTF, les niveaux qui dépassent l'attribut de service PTFGRPLVL sont supprimés (les niveaux les plus bas sont supprimés).
- Supprimez les groupes de PTF pour les versions antérieures au SE actuel (il n'y a suppression que si l'état indique "Non applicable").
- *SAME
- Le nombre de jours reste inchangé. La valeur initiale est 30 jours.
- *KEEP
- Les journaux et historiques système ne sont pas supprimés.
- 1-366
- Indiquez la durée de conservation (en jours) des journaux et historiques système avant leur suppression.
File d'attente de travaux (JOBQ)
Indique le nom et la bibliothèque de la file d'attente de travaux à laquelle les travaux par lots des opérations de ménage sont soumis.
Valeurs particulières
- *SAME
- La file d'attente de travaux reste inchangée. La valeur initiale est *LIBL/QCTL.
Qualificatif 1 : File d'attente de travaux
- nom
- Indiquez le nom de la file d'attente de travaux à laquelle les travaux par lots des opérations de ménage sont soumis.
Qualificatif 2 : Biblio
- *LIBL
- La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.
- *CURLIB
- La file d'attente de travaux est recherchée dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque contenant la file d'attente de travaux.
Taille de récepteur de journal (JRNRCVSIZ)
Indique un nombre de kilo-octets (Ko) de stockage. Chaque 1000 Ko représente 1 024 000 octets d'espace de stockage. Lorsque la taille de l'espace réservé au récepteur de journal est supérieure à la taille spécifiée par cette valeur, la fonction d'apurement automatique de l'Assistant le détache.
L'Assistant détache aussi automatiquement les récepteurs qui sont antérieurs au nombre de jours que vous avez spécifié à l'invite Journaux et hist du système (paramètre SYSLOG).
Les récepteurs de journal sont supprimés uniquement s'ils ont été détachés depuis une durée supérieure au nombre de jours spécifié au paramètre SYSLOG.
- *SAME
- La taille du récepteur de journal n'est pas modifiée. La valeur initiale est 100000 ko.
- 1-1000000000
- Indiquez une taille du récepteur de journal en kilo-octets (Ko) de stockage. Si cette valeur est dépassée lors de l'apurement automatique par l'Assistant, le récepteur de journal sera détaché.
Activités d'agenda OV/400 (CALITM)
En V5R1 et éditions plus récentes, ce paramètre n'est pas pris en charge.
Priorité d'exécution (RUNPTY)
Indique la priorité d'exécution d'un travail. La priorité d'exécution est une valeur comprise entre 1 (priorité la plus élevée) et 99 (priorité la plus faible), qui représente l'importance du travail par rapport aux autres en matière de ressources machine. Cette valeur représente l'importance relative (et non absolue) du travail concerné. Par exemple, une phase d'activation définie par la priorité d'exécution 25 n'est pas deux fois plus urgente qu'une phase d'activation définie par la priorité 50.
- *SAME
- La priorité d'exécution n'est pas modifiée. La valeur initiale est 55.
- 1-99
- Indiquez la priorité d'exécution de la phase d'activation.
Exemples
Exemple 1 : conservation des messages utilisateur pendant le ménage
CHGCLNUP ALWCLNUP(*YES) USRMSG(*KEEP) STRTIME(0700)
Cette commande modifie les options de ménage afin que les messages utilisateur soient conservés pendant l'opération de ménage. Cette commande définit l'heure de début du ménage à 7:00.
Exemple 2 : ménage des journaux et historiques système
CHGCLNUP ALWCLNUP(*YES) SYSMSG(10) SYSLOG(3)
Cette commande modifie les options de ménage afin que les messages système soient conservés pendant dix jours et que les journaux et historiques système soient conservés pendant trois jours avant leur suppression.
Exemple 3 : modification de la priorité d'exécution d'un travail de ménage.
CHGCLNUP RUNPTY(50)
Cette commande définit la priorité d'exécution à 50.
Exemple 4 : modification de la taille du récepteur de journal
CHGCLNUP JRNRCVSIZ(6000)
Cette commande limite la taille du récepteur de journal à 6000 Ko de stockage (6 144 000 octets).
Messages d'erreur
Messages *ESCAPE
- CPF1E2A
- Erreur inattendue dans le travail QSYSSCD.
- CPF1E2B
- Options de mise sous/hors tension et de ménage non trouvées.
- CPF1E3C
- File d'attente de travaux &2/&1 introuvable.
- CPF1E3D
- Bibliothèque &1 introuvable pour le paramètre JOBQ.
- CPF1E32
- Vous n'avez pas le droit de modifier les options de ménage.
- CPF1E33
- Options de ménage ou planning mise HT/ST utilisé par autre utilisateur.
- CPF1E99
- Erreur non prévue.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.