CHGSYSDIRA

Modifier attributs répertoire

En bref

La commande CHGSYSDIRA (Modifier les attributs d'un répertoire) modifie les attributs du répertoire système utilisés lorsque vous travaillez en mode interactif avec le répertoire et les systèmes de réplication de répertoires.

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

Syntaxe minimale

CHGSYSDIRA

Paramètres

SCHTYPE Type de recherche
SCHPGM Programme de recherche
VRFPGM Programme de vérification
SUPPGM Programme émetteur
RTYITV Intervalle entre essais
RTYLMT Nombre maximal d'essais
ALWDSPNUI Afficher ID utilisateur réseau
MSGQ File attente messages
RMTSHD Réplication util éloignés
RMVJOBLOG Suppression histos réplication
ALWSCH Recherche admise
USRDFNFLD Zones définies par utilisateur

Astuce : dans une session 5250, tapez CHGSYSDIRA 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

Un programme de substitution fournit des valeurs à ces attributs de répertoire.

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit spécial de l'administrateur de la sécurité (*SECADM) ou du droit spécial sur tous les objets (*ALLOBJ).
Pour modifier le programme d'exit utilisateur de recherche (SCHPGM), de vérification (VRFPGM) ou émetteur (SUPPGM), vous devez disposer du droit spécial sur tous les objets (*ALLOBJ).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SCHTYPE	Type de recherche	EXACT, GENERIC, *SAME	Facultatif, positionnel 1
SCHPGM	Programme de recherche	Valeurs uniques: SAME, NONE Autres valeurs: Nom d'objet qualifié	Facultatif, positionnel 2
	Qualificatif 1: Programme de recherche	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
VRFPGM	Programme de vérification	Valeurs uniques: SAME, NONE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: Programme de vérification	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SUPPGM	Programme émetteur	Valeurs uniques: SAME, NONE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: Programme émetteur	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
RTYITV	Intervalle entre essais	1-999, *SAME	Facultatif
RTYLMT	Nombre maximal d'essais	0-9, *SAME	Facultatif
ALWDSPNUI	Afficher ID utilisateur réseau	NO, YES, *SAME	Facultatif
MSGQ	File attente messages	Valeurs uniques: SAME Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
RMTSHD	Réplication util éloignés	NO, YES, *SAME	Facultatif
RMVJOBLOG	Suppression histos réplication	NO, YES, *SAME	Facultatif
ALWSCH	Recherche admise	NO, YES, *SAME	Facultatif
USRDFNFLD	Zones définies par utilisateur	Valeurs uniques: SAME Autres valeurs (jusqu'à 100 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Nom de zone	Valeur caractère
	Élément 2: ID produit	Valeur caractère, *NONE
	Élément 3: Fonction	ADD, RMV, CHG, KEEP
	Élément 4: Type de zone	DATA, MSFSRVLVL, *ADDRESS
	Élément 5: Longueur maximale de zone	1-512

Type de recherche (SCHTYPE)

Indique le type de recherche à appliquer à l'écran Recherche dans le répertoire du système. L'attribut de recherche précisé à ce paramètre s'applique au système.

*SAME: La valeur reste inchangée.
*EXACT: Le système recherche précisément la chaîne de texte indiquée sur l'écran Recherche dans le répertoire du système. Cette valeur permet d'utiliser un astérisque (*) dans la chaîne de recherche de valeurs génériques.
*GENERIC: Le système recherche la chaîne de texte indiquée à l'écran Recherche dans le répertoire du système, mais effectue une recherche générique automatique sur la fin de cette chaîne. Il n'est pas nécessaire d'indiquer un astérisque (*) à la fin d'une chaîne pour trouver des valeurs génériques.

Programme de recherche (SCHPGM)

Programme d'exit utilisateur qui exécute une recherche personnalisée à partir de l'écran Recherche dans le répertoire du système. Pour plus d'informations sur le programme d'exit utilisateur, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Lorsqu'un programme d'exit utilisateur est indiqué, il doit préalablement exister.

*SAME: La valeur reste inchangée.
*NONE: Aucun programme d'exit utilisateur de recherche n'est indiqué.

Le nom du programme peut être qualifié par l'une des valeurs de bibliothèque suivantes :

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

*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
nom-programme: Indiquez le nom du programme d'exit utilisateur qui exécute la recherche.

Programme de vérification (VRFPGM)

Programme d'exit utilisateur qui vérifie les opérations de modification, d'ajout ou de suppression des postes de répertoire, services et lieux locaux ou répliqués. Ce programme est appelé à la fois depuis une opération de répertoire local et une réplication de répertoires. Pour plus d'informations sur le programme d'exit utilisateur, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Les modifications sont toujours vérifiées par le système. Si un programme d'exit utilisateur n'est pas fourni, aucune vérification supplémentaire n'est requise. Lorsqu'un programme d'exit utilisateur est fourni, il est d'abord appelé, puis la validation système est effectuée.

Lorsqu'un programme d'exit utilisateur est indiqué, il doit préalablement exister.

*SAME: La valeur reste inchangée.
*NONE: Aucun programme d'exit utilisateur n'est indiqué.

Le nom du programme peut être qualifié par l'une des valeurs de bibliothèque suivantes :

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

*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
nom-programme: Indiquez le nom du programme d'exit utilisateur qui vérifie la modification.

Programme émetteur (SUPPGM)

Programme d'exit utilisateur déterminant la réplication ou non, dans un système récepteur, des opérations de modification, d'ajout ou de suppression portant sur des postes de répertoire, des services et des lieux. Ce programme est appelé depuis une réplication de répertoires. Pour plus d'informations sur le programme d'exit utilisateur, reportez-vous au manuel Ensemble de rubriques API de la catégorie Programmation de l'IBM i Information Center (http://www.ibm.com/systems/i/infocenter/).

Si un programme d'exit utilisateur n'est pas fourni, toutes les modifications sont envoyées au système collecteur. Dans le cas contraire, le programme d'exit utilisateur est appelé et une réplication du répertoire est effectuée.

Lorsqu'un programme d'exit utilisateur est indiqué, il doit préalablement exister.

*SAME: La valeur reste inchangée.
*NONE: Aucun programme d'exit utilisateur n'est indiqué.

Le nom du programme peut être qualifié par l'une des valeurs de bibliothèque suivantes :

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

*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
nom-programme: Indiquez le nom du programme d'exit utilisateur qui détermine les enregistrements à fournir lors de la réplication du répertoire.

Intervalle entre essais (RTYITV)

Délai d'attente (en minutes) entre un essai de réplication qui a échoué et le suivant.

*SAME: La valeur reste inchangée.
intervalle-essai: Indiquez le délai d'attente à observer avant d'effectuer un nouvel essai de réplication. Les valeurs admises sont comprises entre 1 et 999.

Nombre maximal d'essais (RTYLMT)

Indique le nombre de tentatives de réplication de répertoire à effectuer avant l'échec de l'opération.

*SAME: La valeur reste inchangée.
nombre-essais: Indiquez le nombre de tentatives à effectuer avant de mettre fin à la réplication de répertoire. Les valeurs admises sont comprises entre 0 et 9.

Afficher ID utilisateur réseau (ALWDSPNUI)

Indique si tous les ID utilisateur du réseau peuvent être affichés ou imprimés par la totalité des utilisateurs. Ces ID sont toujours affichés ou imprimés pour les administrateurs du système ou les utilisateurs affichant ou imprimant leurs propres postes de répertoire.

*SAME: La valeur reste inchangée.
*YES: Tout utilisateur peut afficher la totalité des ID utilisateur réseau.
*NO: Les utilisateurs ne peuvent pas tous afficher les ID utilisateur réseau.

File attente messages (MSGQ)

Indique le nom qualifié de la file d'attente de messages à laquelle les messages sont envoyés.

*SAME: La valeur reste inchangée.

Le nom de la file d'attente de messages peut être qualifié par l'une des valeurs de bibliothèque suivantes :

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

*CURLIB: La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
nom-bibliothèque: Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.
nom-file-attente-messages: Indiquez le nom de la file d'attente de messages vers laquelle sont envoyés les messages.

Réplication util éloignés (RMTSHD)

Permet d'indiquer si les ajouts, modifications ou suppressions dont font l'objet les postes de répertoires éloignés définis localement s'appliquent lors de la réplication de répertoire. Les postes de répertoires éloignés définis localement sont ajoutés en local mais leur nom de système est différent de celui du système local. Les modifications s'appliquent toujours aux postes de répertoires locaux et aux postes répliqués.

*SAME: La valeur reste inchangée.
*YES: Les ajouts, modifications et suppressions dont font l'objet tous les postes de répertoires s'appliquent aux systèmes récepteurs lors de la réplication de répertoire.
*NO: Les ajouts, modifications et suppressions dont font l'objet les postes de répertoire éloignés définis en local ne s'appliquent pas lors de la réplication de répertoires. Les mises à jour dont font l'objet les postes de répertoires locaux ou les postes répliqués s'appliquent aux systèmes collecteurs lors de la réplication de répertoires.

Suppression histos réplication (RMVJOBLOG)

Indique si les historiques de travail créés lors de collectes de réplications de répertoires sur un système émetteur doivent être supprimés. Pour plus d'informations sur ce paramètre, reportez-vous au manuel SNA Distribution Services, SC41-5410.

*SAME: La valeur reste inchangée.
*YES: L'historique du travail créé lorsque le système local a collecté des données sur un système éloigné est supprimé automatiquement lorsqu'une nouvelle collecte est effectuée sur le système émetteur.
*NO: L'historique de travail créé lorsque le système local a collecté des données sur le système éloigné n'est pas supprimé automatiquement.

Recherche admise (ALWSCH)

Indique si une recherche est permise sur le répertoire de distribution du système.

*SAME: La valeur reste inchangée.
*NO: Des données de recherche ne sont pas créées pour le répertoire de distribution du système.
*YES: Des données de recherche sont créées pour le répertoire de distribution du système. Lorsque vous indiquez cette option, le fichier de recherche ne peut pas être partagé lors de la création des données de recherche. Toutes les mises à jour du répertoire de distribution du système sont ensuite appliquées aux données de recherche une fois celles-ci créées. Lorsque vous avez exécuté cette option, la recherche peut être lancée sur le répertoire de distribution du système.

Zones définies par l'utilisateur (USRDFNFLD)

Indique le nom des zones définies par l'utilisateur, leur fonction, leur type de zone et leur longueur maximale. Ce paramètre vous permet d'ajouter, d'enlever ou de modifier des noms de zones définies par l'utilisateur dans le répertoire de distribution du système.

Si le nom d'une zone définie par l'utilisateur existe sur un système émetteur en réplication, les données sont automatiquement initialisées sur votre système lorsque vous effectuez une collecte à partir de ce système. Après l'initialisation, toutes les modifications apportées à cette zone sur d'autres systèmes en réplication sont mises à jour sur votre système lorsqu'il est répliqué. Si des zones définies par l'utilisateur se trouvant sur d'autres systèmes en réplication ne sont pas définies sur votre système, ces zones et leurs valeurs sont transmises aux autres systèmes en réplication afin que les données ne soient pas perdues.

Si le nom d'une zone définie par l'utilisateur n'existe pas sur un système émetteur mais sur le réseau, la zone n'est pas initialisée. Pour ce faire, ajoutez la zone sur le système émetteur ; ce dernier effectue une réplication des données à partir d'un système contenant la zone définie par l'utilisateur.

Vous pouvez préciser jusqu'à 100 zones utilisateur.

*SAME: Les zones définies par l'utilisateur telles qu'elles sont indiquées sur le système ne sont pas modifiées.

La valeur possible pour le nom de la zone définie par l'utilisateur est la suivante :

nom-zone: Le nom de la zone peut comporter jusqu'à 10 caractères.

Les valeurs possibles pour l'ID produit d'une zone définie par l'utilisateur sont les suivantes :

*NONE: Aucun ID produit n'est indiqué pour cette zone définie par l'utilisateur.
ID-produit: Indiquez un ID produit de 7 caractères au maximum.

Les valeurs possibles pour la fonction de la zone définie par l'utilisateur sont les suivantes :

*KEEP: Indique que le système doit conserver la zone indiquée ci-dessus.
*ADD: Indique que le système doit ajouter la zone indiquée ci-dessus.
*RMV: Indique que le système doit supprimer la zone indiquée ci-dessus. Elle est supprimée de ce système, mais pas des systèmes en réplication.
*CHG: Indique que le système doit modifier la zone indiquée ci-dessus. Vous pouvez modifier la longueur maximale et le type de la zone, mais pas son nom et son ID produit.

Les valeurs possibles pour le type de la zone sont les suivantes :

Le type de zone est obligatoire pour la fonction *ADD et facultatif pour *CHG. Il n'est pas pris en compte pour les fonctions *KEEP et *RMV.

*DATA: Indique que la zone contient des données pour l'utilisateur.
*MSFSRVLVL: Indique que la zone définie par l'utilisateur contient une valeur de niveau de service pour le serveur de courrier. Si vous précisez cette valeur, la zone permet de stocker des informations de niveau de service pour le serveur de courrier. Ce type de zone s'affiche dans la liste lorsque vous appuyez sur F4 dans la zone "Niveau service courrier" des panneaux Ajout d'un poste au répertoire et Modification d'un poste du répertoire.
*ADDRESS: Indique que la zone définie par l'utilisateur contient une adresse. Dans ce cas, cette zone peut être utilisée comme adresse de prédilection. Ce type de zone s'affiche dans la liste lorsque vous appuyez sur F4 dans la zone "Adresse de prédilection" des panneaux Ajout d'un poste au répertoire et Modification d'un poste du répertoire.

La longueur maximale de la zone définie par l'utilisateur est la suivante :

longueur-maximale: Indiquez une valeur comprise entre 1 et 512 octets. La longueur maximale est obligatoire pour la fonction *ADD et facultative pour *CHG. Il n'est pas pris en compte pour les fonctions *KEEP et *RMV.

Exemples

Exemple 1 : modification du type de recherche en Générique

CHGSYSDIRA   SCHTYPE(*GENERIC)

Cette commande lance la recherche sur le répertoire système afin de retrouver toutes les correspondances commençant par une chaîne de texte donnée. Par exemple, une recherche sur Martin permet de récupérer les Martin, Martineau, Martinot, Martine, etc.

Exemple 2 : modification des attributs de tentative de relance de réplication

CHGSYSDIRA   RTYITV(10)  RTYLMT(3)

Cette commande modifie les attributs qui contrôlent les options disponibles en cas d'échec de la réplication. Dans le cadre de cet exemple, l'intervalle entre les échecs est de 10 minutes, avec un maximum de trois tentatives de relance.

Messages d'erreur

Messages *ESCAPE

CPF898C: Droit spécial *ALLOBJ requis pour l'opération demandée.
CPF90F7: Les attributs du répertoire du système n'ont pas été modifiés.