![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
Intelligent Management : tâches d'administration pour les préférences utilisateur concernant les opérations d'exécution
Vous pouvez utiliser les langages de script Jacl et Jython pour cloner, définir et extraire les préférences à l'aide de l'outil wsadmin. Utilisez les commandes et les paramètres du groupe UserPreferences.
- cells/maCellule/preferences/Utilisateur_1/preferenceset.xml
- cells/maCellule/applications/TestAppA.ear/preferences/Utilisateur_1/preferenceset.xml
- cells/maCellule/nodes/monNoeud/servers/monServeur/preferences/Utilisateur_1/preferenceset.xml
- cells/maCellule/clusters/monCluster/preferences/Utilisateur_1/preferenceset.xml
- cells/maCellule/serviceclasses/Platinum/preferences/Utilisateur_1/preferenceset.xml
Pour des exemples d'utilisation de Jython pour interagir avec des objets de préférences, voir Commandes Jython utilisables avec l'objet de préférences.
clonePreference
La commande clonePreference copie une préférence d'un utilisateur ou d'un rôle vers un autre utilisateur ou rôle.
Objet cible
ID configID du parent.
Paramètres requis
-name Indique le nom de la préférence à cloner. (Chaîne, obligatoire)
Paramètres optionnels
- -scope : Indique la portée de la préférence à sauvegarder lors du
clonage. Si vous ne spécifiez pas de portée, celle du configID est utilisée. (Chaîne, optionnelle) La valeur de portée peut être l'une des suivantes :
- Applications
- Servers
- Clusters
- ServiceClasses
- -touser : Spécifie l'utilisateur pour lequel les préférences doivent être extraites. Si vous n'indiquez pas de valeur pour cette propriété, la valeur par défaut est l'ID utilisateur de la session dans laquelle la commande est exécutée. (Chaîne, facultative)
- -torole : Spécifie le rôle pour lequel les préférences doivent être extraites. Cette valeur est ignorée si vous avez spécifié le paramètre -touser. (Chaîne, facultative)
- -fromuser : Spécifie l'utilisateur qui reçoit une copie des préférences. Vous pouvez spécifier plusieurs utilisateurs dans une liste. Par exemple : util1,util2,util3. La liste de doit pas comporter d'espaces. (Chaîne, facultative)
- -fromrole : Spécifie le rôle qui reçoit une copie des préférences. (Chaîne, facultative)
Syntaxe d'un exemple de mode différé
- Avec Jython :
cellid= AdminConfig.getid("/Cell:maCellule") AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser util1 -touser util2,util3,util4,util5]') AdminConfig.save()
- En langage Jacl :
$AdminTask clonePreference cells/dabtcCellule02|cell.xml#Cellule_1 {-name ChartGroups -fromuser utilisateur1 -touser utilisateur2,utilisateur3,utilisateur4,utilisateur5}
Exemple d'utilisation en mode interactif
- Langage
Jython :
AdminTask.clonePreference('[-interactive]')
- En langage Jacl :
$AdminTask clonePreference {-interactive}
getPreferences
La commande getPreferences renvoie une collection de préférences basée sur le document de préférences que vous spécifiez en passant un rôle ou un nom d'utilisateur à la commande. Pour obtenir les préférences d'un utilisateur ou d'un rôle d'utilisateur particulier, vous devez disposer de privilèges d'administrateur.
Objet cible
ID configID du parent.
Paramètres requis
- -name : Indique le nom de la préférence. (Chaîne, requise)
Paramètres optionnels
- -scope : Spécifie une portée pour les préférences.
Vous pouvez choisir l'une des
valeurs suivantes :
- Applications
- Servers
- Clusters
- ServiceClasses
- -user : Spécifie le nom d'utilisateur pour lequel les préférences doivent être extraites. Si vous n'indiquez rien, la commande utilise le nom d'utilisateur qui exécute le script. (Chaîne, optionnelle)
- -role : Spécifie le rôle d'utilisateur pour lequel les préférences doivent être extraites. (Chaîne, optionnelle)
Valeur de retour
La commande renvoie un objet DescriptivePropertyGroup qui contient les préférences, ou Null si aucune préférence n'est trouvée.
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
cellid= AdminConfig.getid("/Cell:maCellule") AdminTask.getPreferences(cellid, '[-name ChartGroups -user util1]')
- En langage Jacl :
$AdminTask getPreferences cells/dabtcCell02|cell.xml#Cellule_1 {-name Reports -user util1}
Exemple d'utilisation en mode interactif
- Avec une chaîne Jython :
AdminTask.getPreferences('[-interactive]')
- En langage Jacl :
$AdminTask getPreferences {-interactive}
setPreference
La commande setPreference définit une préférence spécifique dans un document de préférences. Pour définir les préférences d'un utilisateur ou d'un rôle d'utilisateur particulier, vous devez disposer de privilèges d'administrateur.
Objet cible
ID configID du parent.
Paramètres requis
- -name : Indique le nom de la préférence. (Chaîne, requise)
- -propertyLongName : Spécifie le chemin qualifié complet de la propriété dans la groupe de propriétés, délimité par une barre oblique (/). Si la propriété est directement contenue dans le groupe de propriétés racine, son nom court peut être utilisé, car il est alors strictement identique à son nom long. (Chaîne, obligatoire)
- -propertyValue : Spécifie la nouvelle valeur à affecter à la préférence. (Chaîne, obligatoire)
Paramètres optionnels
- -scope : Indique la portée de la préférence à sauvegarder lors du
clonage. Si vous ne spécifiez pas de portée, celle du configID est
utilisée. (Chaîne, optionnelle) La valeur de portée peut être l'une des suivantes :
- Applications
- Servers
- Clusters
- ServiceClasses
- -user : Spécifie le nom d'utilisateur pour lequel les préférences doivent être sauvegardées. Si vous n'indiquez rien, la commande utilise le nom d'utilisateur qui exécute le script. (Chaîne, optionnelle)
- -role : Spécifie le rôle d'utilisateur pour lequel les préférences doivent être sauvegardées. (Chaîne, optionnelle)
Syntaxe d'un exemple de mode différé
- A l'aide de la chaîne Jython :
AdminTask.setPreference(cellid, '[-name monChartGroup -propertyLongName defaultChartSize -propertyValue large]')
- En langage Jacl :
$AdminTask setPreference cells/dabtcCell02|cell.xml#Cellule_1 {-name Reports -user util1 -propertyLongName defaultChartSize -propertyValue large}
Exemple d'utilisation en mode interactif
- Avec une chaîne Jython :
AdminTask.setPreference('[-interactive]')
- En langage Jacl :
$AdminTask setPreference {-interactive}
Commandes Jython utilisables avec l'objet de préférences
Les exemples suivants montre comment interagir avec l'objet de préférences à l'aide des commandes Jython :
Pour lister les préférences par utilisateur
prefSets = AdminConfig.list("PreferenceSet") print prefSets
Pour supprimer les préférences d'un utilisateur
prefid = AdminConfig.getid("/PreferenceSet:Utilisateur_1") AdminConfig.remove(prefid) AdminConfig.save()
Pour lister les préférences de tous les utilisateurs, groupées par utilisateur
prefs = AdminConfig.list("Preferences") print prefs