CHGSRVAGTA

Modifier attrib Service Agent

En bref

La commande CHGSRVAGTA (Modifier attrib Service Agent) permet à un utilisateur de modifier les attributs de Service Agent.

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

Syntaxe minimale

CHGSRVAGTA

Paramètres

ENABLE Activer
AUTORPT Signaler auto
AUTORPTRTY Renouvellement auto
PALANZ Analyse histo activité produit
RUNPTY Priorité d'exécution
NOTIFYUSR ID utilisateur à prévenir
SRVINF Informations de maintenance
SRVPVDID Signaler l'incident à
LINECTL Contrôle ligne
REFRESHUAK Refresh UAK
JOBSCDE Job Scheduler
RPTRMTPRB Signaler incident syst éloigné
ACTPWD Mot de passe d'activation

Astuce : dans une session 5250, tapez CHGSRVAGTA 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 CHGSRVAGTA (Modifier attrib Service Agent) permet à un utilisateur de modifier les attributs de Service Agent.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
ENABLE	Activer	SAME, YES, NO, SRVINF, *PRBRPT	Facultatif, positionnel 1
AUTORPT	Signaler auto	SAME, YES, *NO	Facultatif
AUTORPTRTY	Renouvellement auto	Liste d'éléments	Facultatif
	Élément 1: Nouvelle tentative	SAME, YES, *NO
	Élément 2: Fréquence	5-720, *SAME
	Élément 3: Nombre de tentatives	1-999, SAME, NOMAX
	Élément 4: Notification utilisateurs	SAME, YES, *NO
PALANZ	Analyse histo activité produit	Liste d'éléments	Facultatif
	Élément 1: Activer	SAME, YES, *NO
	Élément 2: Heure de démarrage	0-23, *SAME
	Élément 3: Intervalle	*SAME, 1, 2, 3, 4, 6, 8, 12, 24
	Élément 4: Envoyer un message	SAME, YES, *NO
RUNPTY	Priorité d'exécution	1-99, *SAME	Facultatif
NOTIFYUSR	ID utilisateur à prévenir	Valeurs uniques: SAME Autres valeurs (jusqu'à 5 répétitions): Nom simple*	Facultatif
SRVINF	Informations de maintenance	Liste d'éléments	Facultatif
	Élément 1: Informations sélectionnées	ALL, PRBID, *SAME
	Élément 2: Début de la collecte	Heure, SAME, CURRENT
	Élément 3: Heure de l'envoi	Heure, SAME, COLLECT
	Élément 4: Délai vérification connexion	1-21, *SAME
	Élément 5: Délai de conservation de tâche	1-30, *SAME
SRVPVDID	Signaler l'incident à	Liste d'éléments	Facultatif
	Élément 1: Nom de point de contrôle	Nom de communication, SAME, IBMSRV
	Élément 2: ID réseau	Nom de communication, SAME, NETATR
LINECTL	Contrôle ligne	Liste d'éléments	Facultatif
	Élément 1: Activer	SAME, YES, *NO
	Élément 2: Objet de configuration	Values (jusqu'à 12 répétitions): Liste d'éléments
	Élément 1: Description de ligne	Nom, *SAME
	Élément 2: Description de contrôleur	Nom, SAME, ANY
	Élément 3: Description d'unité	Nom, SAME, ANY
REFRESHUAK	Refresh UAK	Liste d'éléments	Facultatif
	Élément 1: Activer	SAME, YES, *NO
	Élément 2: Jour planifié	SAME, SUN, MON, TUE, WED, THU, FRI, SAT
	Élément 3: Run time	Heure, SAME, CURRENT
JOBSCDE	Job Scheduler	YES, NO, *AJS	Facultatif
RPTRMTPRB	Signaler incident syst éloigné	SAME, YES, *NO	Facultatif
ACTPWD	Mot de passe d'activation	Valeur caractère, *SAME	Facultatif

Activer (ENABLE)

Indique si Service Agent est activé.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Service Agent est activé.
*NO: Service Agent n'est pas activé.

Ce paramètre est obligatoire.

Signaler auto (AUTORPT)

Indique si Service Agent doit présenter automatiquement les demandes de maintenance.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Service Agent présente automatiquement les demandes de maintenance.
Cette fonction nécessite la mise en oeuvre d'un filtre d'historique des incidents. En outre, la valeur système QPRBFTR est remplacée par QS9FILTER.
*NO: Service Agent ne présente pas automatiquement les demandes de maintenance. Les utilisateurs indiqués au paramètre ID utilisateur à prévenir (NOTIFYUSR) reçoivent des messages relatifs à un incident détecté.

Renouvellement auto (AUTORPTRTY)

Indique si les demandes de maintenance présentées automatiquement par Service Agent doivent être représentées en cas d'échec d'une tentative, et le cas échéant, comment doit être effectuée la nouvelle tentative.

Elément 1 : Nouvelle tentative

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Les demandes de maintenance présentées automatiquement par Service Agent font l'objet d'une nouvelle tentative.
*NO: Les demandes de maintenance présentées automatiquement par Service Agent ne font pas l'objet d'une nouvelle tentative.

Elément 2 : Fréquence

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 15.
5-720: Indique la fréquence (en minutes) selon laquelle les nouvelles tentatives de demande de maintenance sont présentées automatiquement par Service Agent.

Elément 3 : Nombre de tentatives

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 3.
*NOMAX: Les demandes de maintenance présentées automatiquement par Service Agent font l'objet de nouvelles tentatives jusqu'à ce qu'elles aboutissent.
1-999: Indiquez le nombre de tentatives qui doivent être effectuées pour les demandes de maintenance présentées automatiquement par Service Agent.

Elément 4 : Notification utilisateurs

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Les utilisateurs indiqués au paramètre NOTIFYUSR (ID utilisateur à prévenir) reçoivent un message lorsqu'une demande de maintenance présentée automatiquement par Service Agent fait l'objet d'une nouvelle tentative.
*NO: Aucun message n'est envoyé lorsqu'une demande de maintenance présentée automatiquement par Service Agent fait l'objet d'une nouvelle tentative.

Analyse histo activité produit (PALANZ)

Indique si les sous-programmes d'analyse de l'historique d'activité produit (PAL) doivent être exécutés et si les erreurs doivent être signalées.

Les sous-programmes d'analyse de l'historique d'activité produit sont exécutés avant que les incidents détectées dans ce dernier ne soient signalés. Ces sous-programmes d'analyse peuvent utiliser une part importante de ressources UC.

Elément 1 : Activer

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Les sous-programmes d'analyse de l'historique d'activité produit sont exécutés. Les incidents de l'historique d'activité produit sont signalés.
*NO: Les sous-programmes d'analyse de l'historique d'activité produit ne sont pas exécutés. Aucun incident de l'historique d'activité produit n'est signalé. Aucune donnée d'analyse des supports ou de l'historique d'activité produit n'est disponible pour créer des états.

Elément 2 : Heure de démarrage

Indique l'heure de base utilisée pour définir l'heure d'exécution de l'analyse de l'historique d'activité produit (PAL). L'historique d'activité produit est analysé à la fréquence spécifiée et la valeur associée au paramètre Heure de démarrage est prise comme heure de base. L'historique d'activité produit est analysé 10 minutes après l'heure exacte.

Par exemple, 00 signifie que l'heure de démarrage de base est minuit. Si la fréquence d'analyse a pour valeur 4, l'analyse est exécutée à 00:10, 04:10, 08:10 et 12:10.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 00.
0-23: Indiquez l'heure de base à déterminer lors de l'analyse de l'historique d'activité produit (PAL).

Elément 3 : Intervalle

Indique la fréquence, en heures, à laquelle les incidents à signaler doivent être recherchés dans l'historique d'activité produit.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 4.
1: Service Agent recherche les incidents dans l'historique d'activité produit toutes les heures.
2: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 2 heures.
3: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 3 heures.
4: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 4 heures.
6: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 6 heures.
8: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 8 heures.
12: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 12 heures.
24: Service Agent recherche les incidents dans l'historique d'activité produit toutes les 24 heures.

Elément 4 : Envoyer un message

Indique si un message doit être envoyé à la liste d'utilisateurs destinataires des messages Service Agent à chaque démarrage de l'analyse de l'historique d'activité produit par Service Agent.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: Les utilisateurs identifiés au paramètre ID utilisateur à prévenir reçoivent des messages chaque fois que Service Agent démarre un cycle d'analyse de l'historique d'activité produit. Un enregistrement est également créé dans l'historique de l'audit Service Agent.
*NO: Service Agent n'envoie pas de message aux utilisateurs à chaque démarrage d'un cycle d'analyse de l'historique d'activité produit. Un enregistrement est tout de même créé dans l'historique de l'audit Service Agent.

Priorité d'exécution (RUNPTY)

Indique la priorité d'exécution de Service Agent. Cette priorité d'exécution correspond à une valeur comprise entre 1 (priorité la plus élevée) et 99 (priorité la plus faible) et qui représente l'importance du travail par rapport à d'autres travaux pour l'utilisation des ressources machine.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 51.
1-99: Indiquez la priorité d'exécution de Service Agent.

ID utilisateur à prévenir (NOTIFYUSR)

Indique les profils utilisateur destinataires des messages concernant l'activité de Service Agent.

Remarque :Outre les profils utilisateur que vous indiquez, les profils utilisateur QSYSOPR (opérateur système) et QSRV reçoivent également les messages. Il est impossible d'empêcher l'envoi des messages aux profils utilisateur QSYSOPR et QSRV.

Valeurs particulières

*SAME: La valeur reste inchangée.

Autres valeurs (jusqu'à 5 répétitions)

nom-simple: Indiquez les noms des profils utilisateur destinataires des messages de Service Agent.

Informations de maintenance (SRVINF)

Indique que des informations de maintenance doivent être collectées et transmise à IBM, l'heure à la collecte de ces informations doit commencer, l'heure à laquelle elles doivent être transmises, ainsi que la fréquence à laquelle la connexion à IBM doit être automatiquement testée.

Elément 1 : Informations sélectionnées

Indiquez les informations de maintenance qui doivent être envoyées à IBM.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *ALL.
*ALL: Toutes les informations de maintenance sont envoyées à IBM.

Elément 2 : Début de la collecte

Indiquez l'heure à laquelle la collecte des informations de maintenance doit commencer.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *CURRENT.
*CURRENT: La collecte des informations de maintenance doit commencer à l'heure présente.
heure: Heure à laquelle la collecte des informations de maintenance doit commencer. Indiquez l'heure au format d'heure du travail.

Elément 3 : Heure de l'envoi

Indiquez l'heure à laquelle les informations de maintenance doivent être envoyées à IBM.

*SAME: La valeur ne change pas.

*COLLECT: Les informations de maintenance vont être envoyées immédiatement à l'issue de la collecte.
heure: Heure à laquelle les informations de maintenance doivent être envoyées. Indiquez l'heure au format d'heure du travail.

Elément 4 : Délai vérification connexion

Indiquez la fréquence (en jours) à laquelle la connexion à IBM doit être automatiquement testée.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 7.
1-21: Fréquence (en jours) à laquelle la connexion à IBM doit être automatiquement testée.

Elément 5 : Délai de conservation de tâche

Indiquez le nombre minimal de jours pendant lesquels une tâche de collecte ou une tâche d'envoi Service Agent est conservée à l'issue de son exécution. Une fois le délai écoulé, la tâche est supprimée. Le calcul de ce délai commence au démarrage de la tâche.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur 7.
1-30: Nombre de jours pendant lesquels les tâches sont conservées.

Signaler l'incident à (SRVPVDID)

Indique le nom du prestataire de maintenance destinataire de la notification d'un incident.

Une notification est envoyée automatiquement au système ou à la partition logique spécifiés par ce paramètre si AUTORPT(*YES) est défini. Ce système ou cette partition logique doivent figurer dans la liste de prestataires de maintenance. Utilisez la commande WRKSRVPVD (Gérer les prestataires de maintenance) pour afficher les prestataires de maintenance définis pour votre système ou partition logique.

Elément 1 : Nom de point de contrôle

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *IBMSRV.
*IBMSRV: L'Inspection IBM est le prestataire de maintenance.
nom-communications: Indiquez le nom de point de contrôle du prestataire de maintenance destinataire de la notification d'un incident système local.

Elément 2 : ID réseau

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *NETATR.
*NETATR: Le prestataire de maintenance est présent sur le réseau local.
nom-communications: Indiquez l'ID réseau du prestataire de maintenance destinataire de la notification d'un incident système local.

Contrôle ligne (LINECTL)

Pour les configurations de Téléservices qui utilisent une description de ligne, Service Agent peut mettre hors fonction une description de ligne qui est à l'état Connexion en instance et qui partage la même ressource que la description de ligne des Téléservices. Une fois la demande de maintenance effectuée, les objets de configuration indiqués seront remis en fonction. Ce programme n'intervient pas si la ligne est dans un autre état.

Elément 1 : Activer

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *NO.
*YES: La fonction de contrôle de ligne est activée.
*NO: La fonction de contrôle de ligne est désactivée.

Elément 2 : Objet de configuration

Chacun des objets de configuration indiqués comporte trois éléments : une ligne, un contrôleur et un nom de description d'unité. Il est possible d'indiquer douze ensembles d'objets de configuration.

Remarque :Pour tous les postes d'objets de configuration, vous devez vous assurer que l'unité est reliée au contrôleur et que ce dernier est relié à la ligne.

Elément 1 : Description de ligne

*SAME: La valeur ne change pas.

nom: Nom de la description de ligne qui doit être mise hors fonction.

Elément 2 : Description de contrôleur

*SAME: La valeur reste inchangée.
*ANY: Toute description de contrôleur reliée à la description de ligne doit être mise hors fonction.
nom: Nom de la description de contrôleur qui doit être mise hors fonction.

Elément 3 : Description d'unité

*SAME: La valeur reste inchangée.
*ANY: Toute description d'unité reliée à la description de contrôleur doit être mise hors fonction.
nom: Nom de la description d'unité qui doit être mise hors fonction.

Régénérer UAK

Permet d'indiquer si Service Agent vérifie de manière électronique et toutes les semaines si la clé UAK (Update Access Key) du système est sur le point d'expirer (< 30 jours). Si tel est le cas, la clé est téléchargée automatiquement, puis appliquée au système.

Elément 1 : Activer

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *YES.
*YES: La fonction est activée.
*NO: La fonction est désactivée.

Elément 2 : Jour planifié

Indique le jour de la semaine où le processus de régénération de clé UAK doit avoir lieu.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur du premier jour indiqué plus bas.
*SUN: La fonction est exécutée le dimanche.
*MON: La fonction est exécutée le lundi.
*TUE: La fonction est exécutée le mardi.
*WED: La fonction est exécutée le mercredi.
*THU: La fonction est exécutée le jeudi.
*FRI: La fonction est exécutée le vendredi.
*SAT: La fonction est exécutée le samedi.

Elément 3 : Moment d'exécution

Indiquez le moment où la régénération de clé UAK doit être exécutée.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *CURRENT.
*CURRENT: La date du jour est utilisée comme moment d'exécution.
heure: Indiquez l'heure à laquelle la régénération de clé UAK doit être exécutée, au format hhmmss.

Job Scheduler

Indique le type de programmateur de travaux (Job Scheduler) qui est utilisé pour créer automatiquement des postes Job Scheduler Service Agent lorsque Service Agent est activé.

Elément 1 : Job Scheduler

*Yes: Le programmateur Job Scheduler par défaut est utilisé.
*AJS: Advanced Job Scheduler est utilisé s'il est installé.
*NO: Aucun programmateur Job Scheduler n'est indiqué. Les postes Job Scheduler Service Agent ne seront pas créés automatiquement.

Signaler incident syst éloigné (RPTRMTPRB)

Indique si ce système ou cette partition logique signale les incidents à la demande d'un réseau de systèmes ou de partitions logiques.

*SAME: La valeur reste inchangée si elle a été définie. Sinon, elle prend la valeur *NO.
*NO: Ce système ou cette partition logique ne signale pas les incidents envoyés à partir d'un système ou d'une partition logique éloignés de l'environnement réseau dans l'historique des incidents.
*YES: Ce système ou cette partition logique signale les incidents envoyés à partir d'un système ou d'une partition logique éloignés de l'environnement réseau dans l'historique des incidents.
Remarque :Ce système ou cette partition logique doit être le système ou la partition logique hôte. Cette fonction ne peut être activée que si System Manager for IBM i est installé et configuré.

Mot de passe d'activation (ACTPWD)

Indique la valeur en cours du mot de passe d'activation.

Remarque :Ce paramètre est obligatoire lorsque RPTRMTPRB a pour valeur *YES.

*SAME: La valeur reste inchangée.
valeur-alphanumérique: Indiquez la valeur en cours du mot de passe d'activation. Le mot de passe d'activation peut être obtenu auprès du Responsable de la maintenance IBM.

Exemples

CHGSRVAGTA   ENABLE(*YES)  AUTORPT(*YES)  NOTIFYUSR(SMITH)

Cette commande permet d'activer la fonction de génération d'état d'incident ainsi que la collecte et la transmission d'informations de maintenance. Elle indique le profil utilisateur SMITH comme récepteur des messages Service Agent.

Messages d'erreur

*ESCAPE Messages

CPF9899: Erreur lors du traitement de la commande.