La commande esAdmin permet de répertorier, déverrouiller ou supprimer des verrous actifs et en file d'attente.
Fonction
La commande esAdmin peut répertorier et supprimer tous les verrous actuellement gérés par le gestionnaire de verrous.
Vous pouvez dresser la liste de tous les verrous ou seulement d'un petit sous-ensemble filtré sur la base du module, du composant ou de la méthode. Cette commande peut également être utilisée pour libérer un verrou actif dans une situation de blocage ; une fois le verrou débloqué, il est octroyé à la demande en attente suivante.
Syntaxe

(1)
>>-esAdmin-- -+--------------------------------------------------------------------------------------------------------+-----><
| .-localhost---. .-8880--------------. |
+-+--h hostName-+-+--p soapPortNumber-+----username userid------passwordmot_passe---method -| Méthodes |-+
+- ------------------------------------------------------------------------------------------------------+
'- -help-------------------------------------------------------------------------------------------------'
Méthodes
|--+-listAll-------------------------------------------------------------------+--|
+-listLocks -+-nomModule---------------------------+-deleteLocks moduleName-+
| +-moduleName componentName------------+ |
| '-moduleName componentName methodName-' |
'-unlock lockId-------------------------------------------------------------'
Remarques:
- Si la sécurité est activée, vous devez indiquer un ID utilisateur (et le mot de passe qui lui est associé) correspondant à des droits suffisants pour effectuer les modifications. Vous pouvez indiquer l'ID utilisateur et le mot de passe à l'aide des variables -username et -password. Ces deux variables sont facultatives, mais si vous ne les indiquez pas, vous y serez invité avant de pouvoir effectuer la commande.
Paramètres
- hostName
- Indique le nom du serveur sur lequel le gestionnaire de verrous est exécuté.
Cette valeur doit être une chaîne. Si aucune valeur n'est indiquée, la valeur par défaut localhost est utilisée.
- soapPortNumber
- Indique le port utilisé pour la connexion au serveur. La valeur doit être un entier. Si aucune valeur n'est indiquée, la valeur par défaut 8880 est utilisée.
- username
- Indique l'ID d'un utilisateur possédant les droits suffisants pour procéder aux modifications. Si aucune valeur n'est donnée et que la sécurité est activée, vous serez invité à entrer un ID utilisateur et un mot de passe.
- mot_de_passe
- Indique le mot de passe associé à l'ID utilisateur spécifié dans la variable -username. Si aucune valeur n'est donnée et que la sécurité est activée, vous serez invité à entrer un ID utilisateur et un mot de passe.
- nomModule
- Indique le nom du module qui contient le composant utilisant le séquencement d'événements.
- componentName
- Indique le nom du composant qui utilise le séquencement d'événements.
- methodName
- Indique le nom de la méthode sur laquelle les qualificatifs de séquencement d'événements ont été définis.
- lockId
- Indique l'ID numérique du verrou que vous souhaitez libérer. La valeur de ce paramètre doit être un entier.
L'utilisation de la commande esAdmin dans un environnement de déploiement réseau
Si vous utilisez la commande
esAdmin dans un environnement de déploiement réseau, vous ne devez pas exécuter la commande sur le gestionnaire de déploiement. Vous devez plutôt exécuter la commande
esAdmin sur un des serveurs gérés. Pour utiliser la commande
esAdmin dans un environnement de déploiement de réseau, procédez selon les étapes suivantes :
- Vérifiez le nom du serveur sur lequel l'application (module) est déployée.
- Connectez-vous à la console d'administration et accédez à Serveurs
> Serveurs d'application.
- Cliquez sur le nom du serveur de l'étape 1 et développez Ports sur le côté droit de la page. Notez la valeur de SOAP_CONNECTOR_ADDRESS et utilisez-la pour spécifier le soapPortNumber.
- Exécutez la commande esAdmin avec la méthode listLocks
ou listAll selon les recommandations.
Exemples
La commande suivante renvoie une liste des verrous actifs et en attente pour le module Order :
esAdmin listLocks Order
La sortie générée est semblable à la suivante :
Tableau 1. Exemple de sortie de la commande esAdmin listLocksID de verrou |
ID de séquence |
ID de propriétaire |
Module |
Composant |
Méthode |
ID de message système |
7564504 |
2 |
695376 |
Order |
OrderComp |
createOrder |
A09- 427BE_5002 |
7564504 |
3 |
232757 |
Order |
OrderComp |
createOrder |
ADF- 053RT_5004 |
La commande suivante libère le verrou 754830988. Cette commande suppose que la sécurité est activée et que le numéro de port est 9060 (au lieu de la valeur par défaut 8880).
esAdmin -username administrator1 -password adminpassword -p 9060 unlock 754830988