Aller au contenu

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

  • ALWCLNUP Permettre le ménage
  • STRTIME Heure début ménage quotidien
  • USRMSG Durée de conservation en jours
  • SYSMSG Msgs syst et postes travail
  • CRITSYSMSG Messages systèmes critiques
  • SYSPRT Hist travaux et sorties syst
  • SYSLOG Journaux et hist du système
  • JOBQ File d'attente de travaux
  • JRNRCVSIZ Taille de récepteur de journal
  • CALITM Activités d'agenda OV/400
  • RUNPTY Priorité 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.